route53recoverycluster

package
v1.42.29 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 6, 2022 License: Apache-2.0 Imports: 9 Imported by: 12

Documentation

Overview

Package route53recoverycluster provides the client and types for making API requests to Route53 Recovery Cluster.

Welcome to the Amazon Route 53 Application Recovery Controller API Reference Guide for Recovery Control Data Plane .

Recovery control in Route 53 Application Recovery Controller includes extremely reliable routing controls that enable you to recover applications by rerouting traffic, for example, across Availability Zones or AWS Regions. Routing controls are simple on/off switches hosted on a cluster. A cluster is a set of five redundant regional endpoints against which you can execute API calls to update or get the state of routing controls. You use routing controls to failover traffic to recover your application across Availability Zones or Regions.

This API guide includes information about how to get and update routing control states in Route 53 Application Recovery Controller.

For more information about Route 53 Application Recovery Controller, see the following:

  • You can create clusters, routing controls, and control panels by using the control plane API for Recovery Control. For more information, see Amazon Route 53 Application Recovery Controller Recovery Control API Reference (https://docs.aws.amazon.com/recovery-cluster/latest/api/).

  • Route 53 Application Recovery Controller also provides continuous readiness checks to ensure that your applications are scaled to handle failover traffic. For more information about the related API actions, see Amazon Route 53 Application Recovery Controller Recovery Readiness API Reference (https://docs.aws.amazon.com/recovery-readiness/latest/api/).

  • For more information about creating resilient applications and preparing for recovery readiness with Route 53 Application Recovery Controller, see the Amazon Route 53 Application Recovery Controller Developer Guide (r53recovery/latest/dg/).

See https://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02 for more information on this service.

See route53recoverycluster package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/route53recoverycluster/

Using the Client

To contact Route53 Recovery Cluster with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Route53 Recovery Cluster client Route53RecoveryCluster for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/route53recoverycluster/#New

Index

Constants

View Source 
const (
	// RoutingControlStateOn is a RoutingControlState enum value
	RoutingControlStateOn = "On"

	// RoutingControlStateOff is a RoutingControlState enum value
	RoutingControlStateOff = "Off"
)
View Source 
const (
	// ValidationExceptionReasonUnknownOperation is a ValidationExceptionReason enum value
	ValidationExceptionReasonUnknownOperation = "unknownOperation"

	// ValidationExceptionReasonCannotParse is a ValidationExceptionReason enum value
	ValidationExceptionReasonCannotParse = "cannotParse"

	// ValidationExceptionReasonFieldValidationFailed is a ValidationExceptionReason enum value
	ValidationExceptionReasonFieldValidationFailed = "fieldValidationFailed"

	// ValidationExceptionReasonOther is a ValidationExceptionReason enum value
	ValidationExceptionReasonOther = "other"
)

Reason the request failed validation

View Source 
const (

	// ErrCodeAccessDeniedException for service response error code
	// "AccessDeniedException".
	//
	// You don't have sufficient permissions to query the routing control state.
	ErrCodeAccessDeniedException = "AccessDeniedException"

	// ErrCodeConflictException for service response error code
	// "ConflictException".
	//
	// There was a conflict with this request. Try again.
	ErrCodeConflictException = "ConflictException"

	// ErrCodeEndpointTemporarilyUnavailableException for service response error code
	// "EndpointTemporarilyUnavailableException".
	//
	// The cluster endpoint isn't available. Try another cluster endpoint.
	ErrCodeEndpointTemporarilyUnavailableException = "EndpointTemporarilyUnavailableException"

	// ErrCodeInternalServerException for service response error code
	// "InternalServerException".
	//
	// There was an unexpected error during processing of the request.
	ErrCodeInternalServerException = "InternalServerException"

	// ErrCodeResourceNotFoundException for service response error code
	// "ResourceNotFoundException".
	//
	// The request references a routing control that was not found.
	ErrCodeResourceNotFoundException = "ResourceNotFoundException"

	// ErrCodeThrottlingException for service response error code
	// "ThrottlingException".
	//
	// The request was denied because of request throttling.
	ErrCodeThrottlingException = "ThrottlingException"

	// ErrCodeValidationException for service response error code
	// "ValidationException".
	//
	// There was a validation error on the request.
	ErrCodeValidationException = "ValidationException"
)
View Source 
const (
	ServiceName = "Route53 Recovery Cluster" // Name of service.
	EndpointsID = "route53-recovery-cluster" // ID to lookup a service endpoint with.
	ServiceID   = "Route53 Recovery Cluster" // ServiceID is a unique identifier of a specific service.
)

Service information constants

Variables

This section is empty.

Functions

func RoutingControlState_Values 

func RoutingControlState_Values() []string

RoutingControlState_Values returns all elements of the RoutingControlState enum

func ValidationExceptionReason_Values 

func ValidationExceptionReason_Values() []string

ValidationExceptionReason_Values returns all elements of the ValidationExceptionReason enum

Types

type AccessDeniedException 

type AccessDeniedException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`
	// contains filtered or unexported fields
}

You don't have sufficient permissions to query the routing control state.

func (*AccessDeniedException) Code 

func (s *AccessDeniedException) Code() string

Code returns the exception type name.

func (*AccessDeniedException) Error 

func (s *AccessDeniedException) Error() string

func (AccessDeniedException) GoString 

func (s AccessDeniedException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*AccessDeniedException) Message 

func (s *AccessDeniedException) Message() string

Message returns the exception's message.

func (*AccessDeniedException) OrigErr 

func (s *AccessDeniedException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*AccessDeniedException) RequestID 

func (s *AccessDeniedException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*AccessDeniedException) StatusCode 

func (s *AccessDeniedException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (AccessDeniedException) String 

func (s AccessDeniedException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type ConflictException 

type ConflictException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// Description of the ConflictException error
	Message_ *string `locationName:"message" type:"string"`

	// Identifier of the resource in use
	//
	// ResourceId is a required field
	ResourceId *string `locationName:"resourceId" type:"string" required:"true"`

	// Type of the resource in use
	//
	// ResourceType is a required field
	ResourceType *string `locationName:"resourceType" type:"string" required:"true"`
	// contains filtered or unexported fields
}

There was a conflict with this request. Try again.

func (*ConflictException) Code 

func (s *ConflictException) Code() string

Code returns the exception type name.

func (*ConflictException) Error 

func (s *ConflictException) Error() string

func (ConflictException) GoString 

func (s ConflictException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*ConflictException) Message 

func (s *ConflictException) Message() string

Message returns the exception's message.

func (*ConflictException) OrigErr 

func (s *ConflictException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*ConflictException) RequestID 

func (s *ConflictException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*ConflictException) StatusCode 

func (s *ConflictException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (ConflictException) String 

func (s ConflictException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type EndpointTemporarilyUnavailableException 

type EndpointTemporarilyUnavailableException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`
	// contains filtered or unexported fields
}

The cluster endpoint isn't available. Try another cluster endpoint.

func (*EndpointTemporarilyUnavailableException) Code 

func (s *EndpointTemporarilyUnavailableException) Code() string

Code returns the exception type name.

func (*EndpointTemporarilyUnavailableException) Error 

func (s *EndpointTemporarilyUnavailableException) Error() string

func (EndpointTemporarilyUnavailableException) GoString 

func (s EndpointTemporarilyUnavailableException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*EndpointTemporarilyUnavailableException) Message 

func (s *EndpointTemporarilyUnavailableException) Message() string

Message returns the exception's message.

func (*EndpointTemporarilyUnavailableException) OrigErr 

func (s *EndpointTemporarilyUnavailableException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*EndpointTemporarilyUnavailableException) RequestID 

func (s *EndpointTemporarilyUnavailableException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*EndpointTemporarilyUnavailableException) StatusCode 

func (s *EndpointTemporarilyUnavailableException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (EndpointTemporarilyUnavailableException) String 

func (s EndpointTemporarilyUnavailableException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type GetRoutingControlStateInput 

type GetRoutingControlStateInput struct {

	// The Amazon Resource Number (ARN) for the routing control that you want to
	// get the state for.
	//
	// RoutingControlArn is a required field
	RoutingControlArn *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetRoutingControlStateInput) GoString 

func (s GetRoutingControlStateInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*GetRoutingControlStateInput) SetRoutingControlArn 

func (s *GetRoutingControlStateInput) SetRoutingControlArn(v string) *GetRoutingControlStateInput

SetRoutingControlArn sets the RoutingControlArn field's value.

func (GetRoutingControlStateInput) String 

func (s GetRoutingControlStateInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*GetRoutingControlStateInput) Validate 

func (s *GetRoutingControlStateInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetRoutingControlStateOutput 

type GetRoutingControlStateOutput struct {

	// The Amazon Resource Number (ARN) of the response.
	//
	// RoutingControlArn is a required field
	RoutingControlArn *string `min:"1" type:"string" required:"true"`

	// The state of the routing control.
	//
	// RoutingControlState is a required field
	RoutingControlState *string `type:"string" required:"true" enum:"RoutingControlState"`
	// contains filtered or unexported fields
}

func (GetRoutingControlStateOutput) GoString 

func (s GetRoutingControlStateOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*GetRoutingControlStateOutput) SetRoutingControlArn 

func (s *GetRoutingControlStateOutput) SetRoutingControlArn(v string) *GetRoutingControlStateOutput

SetRoutingControlArn sets the RoutingControlArn field's value.

func (*GetRoutingControlStateOutput) SetRoutingControlState 

func (s *GetRoutingControlStateOutput) SetRoutingControlState(v string) *GetRoutingControlStateOutput

SetRoutingControlState sets the RoutingControlState field's value.

func (GetRoutingControlStateOutput) String 

func (s GetRoutingControlStateOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type InternalServerException 

type InternalServerException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`

	// Advice to clients on when the call can be safely retried
	RetryAfterSeconds *int64 `locationName:"retryAfterSeconds" type:"integer"`
	// contains filtered or unexported fields
}

There was an unexpected error during processing of the request.

func (*InternalServerException) Code 

func (s *InternalServerException) Code() string

Code returns the exception type name.

func (*InternalServerException) Error 

func (s *InternalServerException) Error() string

func (InternalServerException) GoString 

func (s InternalServerException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*InternalServerException) Message 

func (s *InternalServerException) Message() string

Message returns the exception's message.

func (*InternalServerException) OrigErr 

func (s *InternalServerException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*InternalServerException) RequestID 

func (s *InternalServerException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*InternalServerException) StatusCode 

func (s *InternalServerException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (InternalServerException) String 

func (s InternalServerException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type ResourceNotFoundException 

type ResourceNotFoundException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`

	// Hypothetical resource identifier that was not found
	//
	// ResourceId is a required field
	ResourceId *string `locationName:"resourceId" type:"string" required:"true"`

	// Hypothetical resource type that was not found
	//
	// ResourceType is a required field
	ResourceType *string `locationName:"resourceType" type:"string" required:"true"`
	// contains filtered or unexported fields
}

The request references a routing control that was not found.

func (*ResourceNotFoundException) Code 

func (s *ResourceNotFoundException) Code() string

Code returns the exception type name.

func (*ResourceNotFoundException) Error 

func (s *ResourceNotFoundException) Error() string

func (ResourceNotFoundException) GoString 

func (s ResourceNotFoundException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*ResourceNotFoundException) Message 

func (s *ResourceNotFoundException) Message() string

Message returns the exception's message.

func (*ResourceNotFoundException) OrigErr 

func (s *ResourceNotFoundException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*ResourceNotFoundException) RequestID 

func (s *ResourceNotFoundException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*ResourceNotFoundException) StatusCode 

func (s *ResourceNotFoundException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (ResourceNotFoundException) String 

func (s ResourceNotFoundException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type Route53RecoveryCluster 

type Route53RecoveryCluster struct {
	*client.Client
}

Route53RecoveryCluster provides the API operation methods for making requests to Route53 Recovery Cluster. See this package's package overview docs for details on the service.

Route53RecoveryCluster methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

func New 

func New(p client.ConfigProvider, cfgs ...*aws.Config) *Route53RecoveryCluster

New creates a new instance of the Route53RecoveryCluster client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example: 

mySession := session.Must(session.NewSession())

// Create a Route53RecoveryCluster client from just a session.
svc := route53recoverycluster.New(mySession)

// Create a Route53RecoveryCluster client with additional configuration
svc := route53recoverycluster.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*Route53RecoveryCluster) GetRoutingControlState 

func (c *Route53RecoveryCluster) GetRoutingControlState(input *GetRoutingControlStateInput) (*GetRoutingControlStateOutput, error)

GetRoutingControlState API operation for Route53 Recovery Cluster.

Get the state for a routing control. A routing control is a simple on/off switch that you can use to route traffic to cells. When the state is On, traffic flows to a cell. When it's off, traffic does not flow.

Before you can create a routing control, you first must create a cluster to host the control. For more information, see CreateCluster (https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster.html). Access one of the endpoints for the cluster to get or update the routing control state to redirect traffic.

For more information about working with routing controls, see Routing control (https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html) in the Route 53 Application Recovery Controller Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Route53 Recovery Cluster's API operation GetRoutingControlState for usage and error information.

Returned Error Types:

  • AccessDeniedException You don't have sufficient permissions to query the routing control state.

  • InternalServerException There was an unexpected error during processing of the request.

  • ResourceNotFoundException The request references a routing control that was not found.

  • ValidationException There was a validation error on the request.

  • ThrottlingException The request was denied because of request throttling.

  • EndpointTemporarilyUnavailableException The cluster endpoint isn't available. Try another cluster endpoint.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/GetRoutingControlState

func (*Route53RecoveryCluster) GetRoutingControlStateRequest 

func (c *Route53RecoveryCluster) GetRoutingControlStateRequest(input *GetRoutingControlStateInput) (req *request.Request, output *GetRoutingControlStateOutput)

GetRoutingControlStateRequest generates a "aws/request.Request" representing the client's request for the GetRoutingControlState operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetRoutingControlState for more information on using the GetRoutingControlState API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the GetRoutingControlStateRequest method.
req, resp := client.GetRoutingControlStateRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/GetRoutingControlState

func (*Route53RecoveryCluster) GetRoutingControlStateWithContext 

func (c *Route53RecoveryCluster) GetRoutingControlStateWithContext(ctx aws.Context, input *GetRoutingControlStateInput, opts ...request.Option) (*GetRoutingControlStateOutput, error)

GetRoutingControlStateWithContext is the same as GetRoutingControlState with the addition of the ability to pass a context and additional request options.

See GetRoutingControlState for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*Route53RecoveryCluster) UpdateRoutingControlState 

func (c *Route53RecoveryCluster) UpdateRoutingControlState(input *UpdateRoutingControlStateInput) (*UpdateRoutingControlStateOutput, error)

UpdateRoutingControlState API operation for Route53 Recovery Cluster.

Set the state of the routing control to reroute traffic. You can set the value to be On or Off. When the state is On, traffic flows to a cell. When it's off, traffic does not flow.

For more information about working with routing controls, see Routing control (https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html) in the Route 53 Application Recovery Controller Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Route53 Recovery Cluster's API operation UpdateRoutingControlState for usage and error information.

Returned Error Types:

  • AccessDeniedException You don't have sufficient permissions to query the routing control state.

  • InternalServerException There was an unexpected error during processing of the request.

  • ResourceNotFoundException The request references a routing control that was not found.

  • ValidationException There was a validation error on the request.

  • ThrottlingException The request was denied because of request throttling.

  • EndpointTemporarilyUnavailableException The cluster endpoint isn't available. Try another cluster endpoint.

  • ConflictException There was a conflict with this request. Try again.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlState

func (*Route53RecoveryCluster) UpdateRoutingControlStateRequest 

func (c *Route53RecoveryCluster) UpdateRoutingControlStateRequest(input *UpdateRoutingControlStateInput) (req *request.Request, output *UpdateRoutingControlStateOutput)

UpdateRoutingControlStateRequest generates a "aws/request.Request" representing the client's request for the UpdateRoutingControlState operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateRoutingControlState for more information on using the UpdateRoutingControlState API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the UpdateRoutingControlStateRequest method.
req, resp := client.UpdateRoutingControlStateRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlState

func (*Route53RecoveryCluster) UpdateRoutingControlStateWithContext 

func (c *Route53RecoveryCluster) UpdateRoutingControlStateWithContext(ctx aws.Context, input *UpdateRoutingControlStateInput, opts ...request.Option) (*UpdateRoutingControlStateOutput, error)

UpdateRoutingControlStateWithContext is the same as UpdateRoutingControlState with the addition of the ability to pass a context and additional request options.

See UpdateRoutingControlState for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*Route53RecoveryCluster) UpdateRoutingControlStates 

func (c *Route53RecoveryCluster) UpdateRoutingControlStates(input *UpdateRoutingControlStatesInput) (*UpdateRoutingControlStatesOutput, error)

UpdateRoutingControlStates API operation for Route53 Recovery Cluster.

Set multiple routing control states. You can set the value for each state to be On or Off. When the state is On, traffic flows to a cell. When it's off, traffic does not flow.

For more information about working with routing controls, see Routing control (https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html) in the Route 53 Application Recovery Controller Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Route53 Recovery Cluster's API operation UpdateRoutingControlStates for usage and error information.

Returned Error Types:

  • AccessDeniedException You don't have sufficient permissions to query the routing control state.

  • InternalServerException There was an unexpected error during processing of the request.

  • ResourceNotFoundException The request references a routing control that was not found.

  • ValidationException There was a validation error on the request.

  • ThrottlingException The request was denied because of request throttling.

  • EndpointTemporarilyUnavailableException The cluster endpoint isn't available. Try another cluster endpoint.

  • ConflictException There was a conflict with this request. Try again.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlStates

func (*Route53RecoveryCluster) UpdateRoutingControlStatesRequest 

func (c *Route53RecoveryCluster) UpdateRoutingControlStatesRequest(input *UpdateRoutingControlStatesInput) (req *request.Request, output *UpdateRoutingControlStatesOutput)

UpdateRoutingControlStatesRequest generates a "aws/request.Request" representing the client's request for the UpdateRoutingControlStates operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateRoutingControlStates for more information on using the UpdateRoutingControlStates API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic. 

// Example sending a request using the UpdateRoutingControlStatesRequest method.
req, resp := client.UpdateRoutingControlStatesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlStates

func (*Route53RecoveryCluster) UpdateRoutingControlStatesWithContext 

func (c *Route53RecoveryCluster) UpdateRoutingControlStatesWithContext(ctx aws.Context, input *UpdateRoutingControlStatesInput, opts ...request.Option) (*UpdateRoutingControlStatesOutput, error)

UpdateRoutingControlStatesWithContext is the same as UpdateRoutingControlStates with the addition of the ability to pass a context and additional request options.

See UpdateRoutingControlStates for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

type ThrottlingException 

type ThrottlingException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`

	// Advice to clients on when the call can be safely retried
	RetryAfterSeconds *int64 `locationName:"retryAfterSeconds" type:"integer"`
	// contains filtered or unexported fields
}

The request was denied because of request throttling.

func (*ThrottlingException) Code 

func (s *ThrottlingException) Code() string

Code returns the exception type name.

func (*ThrottlingException) Error 

func (s *ThrottlingException) Error() string

func (ThrottlingException) GoString 

func (s ThrottlingException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*ThrottlingException) Message 

func (s *ThrottlingException) Message() string

Message returns the exception's message.

func (*ThrottlingException) OrigErr 

func (s *ThrottlingException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*ThrottlingException) RequestID 

func (s *ThrottlingException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*ThrottlingException) StatusCode 

func (s *ThrottlingException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (ThrottlingException) String 

func (s ThrottlingException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type UpdateRoutingControlStateEntry 

type UpdateRoutingControlStateEntry struct {

	// The Amazon Resource Number (ARN) for the routing control state entry.
	//
	// RoutingControlArn is a required field
	RoutingControlArn *string `min:"1" type:"string" required:"true"`

	// The routing control state in a set of routing control state entries.
	//
	// RoutingControlState is a required field
	RoutingControlState *string `type:"string" required:"true" enum:"RoutingControlState"`
	// contains filtered or unexported fields
}

A routing control state.

func (UpdateRoutingControlStateEntry) GoString 

func (s UpdateRoutingControlStateEntry) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*UpdateRoutingControlStateEntry) SetRoutingControlArn 

func (s *UpdateRoutingControlStateEntry) SetRoutingControlArn(v string) *UpdateRoutingControlStateEntry

SetRoutingControlArn sets the RoutingControlArn field's value.

func (*UpdateRoutingControlStateEntry) SetRoutingControlState 

func (s *UpdateRoutingControlStateEntry) SetRoutingControlState(v string) *UpdateRoutingControlStateEntry

SetRoutingControlState sets the RoutingControlState field's value.

func (UpdateRoutingControlStateEntry) String 

func (s UpdateRoutingControlStateEntry) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*UpdateRoutingControlStateEntry) Validate 

func (s *UpdateRoutingControlStateEntry) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateRoutingControlStateInput 

type UpdateRoutingControlStateInput struct {

	// The Amazon Resource Number (ARN) for the routing control that you want to
	// update the state for.
	//
	// RoutingControlArn is a required field
	RoutingControlArn *string `min:"1" type:"string" required:"true"`

	// The state of the routing control. You can set the value to be On or Off.
	//
	// RoutingControlState is a required field
	RoutingControlState *string `type:"string" required:"true" enum:"RoutingControlState"`
	// contains filtered or unexported fields
}

func (UpdateRoutingControlStateInput) GoString 

func (s UpdateRoutingControlStateInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*UpdateRoutingControlStateInput) SetRoutingControlArn 

func (s *UpdateRoutingControlStateInput) SetRoutingControlArn(v string) *UpdateRoutingControlStateInput

SetRoutingControlArn sets the RoutingControlArn field's value.

func (*UpdateRoutingControlStateInput) SetRoutingControlState 

func (s *UpdateRoutingControlStateInput) SetRoutingControlState(v string) *UpdateRoutingControlStateInput

SetRoutingControlState sets the RoutingControlState field's value.

func (UpdateRoutingControlStateInput) String 

func (s UpdateRoutingControlStateInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*UpdateRoutingControlStateInput) Validate 

func (s *UpdateRoutingControlStateInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateRoutingControlStateOutput 

type UpdateRoutingControlStateOutput struct {
	// contains filtered or unexported fields
}

func (UpdateRoutingControlStateOutput) GoString 

func (s UpdateRoutingControlStateOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (UpdateRoutingControlStateOutput) String 

func (s UpdateRoutingControlStateOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type UpdateRoutingControlStatesInput 

type UpdateRoutingControlStatesInput struct {

	// A set of routing control entries that you want to update.
	//
	// UpdateRoutingControlStateEntries is a required field
	UpdateRoutingControlStateEntries []*UpdateRoutingControlStateEntry `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (UpdateRoutingControlStatesInput) GoString 

func (s UpdateRoutingControlStatesInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*UpdateRoutingControlStatesInput) SetUpdateRoutingControlStateEntries 

func (s *UpdateRoutingControlStatesInput) SetUpdateRoutingControlStateEntries(v []*UpdateRoutingControlStateEntry) *UpdateRoutingControlStatesInput

SetUpdateRoutingControlStateEntries sets the UpdateRoutingControlStateEntries field's value.

func (UpdateRoutingControlStatesInput) String 

func (s UpdateRoutingControlStatesInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*UpdateRoutingControlStatesInput) Validate 

func (s *UpdateRoutingControlStatesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateRoutingControlStatesOutput 

type UpdateRoutingControlStatesOutput struct {
	// contains filtered or unexported fields
}

func (UpdateRoutingControlStatesOutput) GoString 

func (s UpdateRoutingControlStatesOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (UpdateRoutingControlStatesOutput) String 

func (s UpdateRoutingControlStatesOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type ValidationException 

type ValidationException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	// The fields that caused the error, if applicable
	Fields []*ValidationExceptionField `locationName:"fields" type:"list"`

	Message_ *string `locationName:"message" type:"string"`

	// Reason the request failed validation
	Reason *string `locationName:"reason" type:"string" enum:"ValidationExceptionReason"`
	// contains filtered or unexported fields
}

There was a validation error on the request.

func (*ValidationException) Code 

func (s *ValidationException) Code() string

Code returns the exception type name.

func (*ValidationException) Error 

func (s *ValidationException) Error() string

func (ValidationException) GoString 

func (s ValidationException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*ValidationException) Message 

func (s *ValidationException) Message() string

Message returns the exception's message.

func (*ValidationException) OrigErr 

func (s *ValidationException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*ValidationException) RequestID 

func (s *ValidationException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*ValidationException) StatusCode 

func (s *ValidationException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (ValidationException) String 

func (s ValidationException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type ValidationExceptionField 

type ValidationExceptionField struct {

	// Information about the validation exception.
	//
	// Message is a required field
	Message *string `locationName:"message" type:"string" required:"true"`

	// The field that had the validation exception.
	//
	// Name is a required field
	Name *string `locationName:"name" type:"string" required:"true"`
	// contains filtered or unexported fields
}

There was a validation error on the request.

func (ValidationExceptionField) GoString 

func (s ValidationExceptionField) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*ValidationExceptionField) SetMessage 

func (s *ValidationExceptionField) SetMessage(v string) *ValidationExceptionField

SetMessage sets the Message field's value.

func (*ValidationExceptionField) SetName 

func (s *ValidationExceptionField) SetName(v string) *ValidationExceptionField

SetName sets the Name field's value.

func (ValidationExceptionField) String 

func (s ValidationExceptionField) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

Source Files

View all Source files

Directories

Path Synopsis
Package route53recoveryclusteriface provides an interface to enable mocking the Route53 Recovery Cluster service client for testing your code.
 Package route53recoveryclusteriface provides an interface to enable mocking the Route53 Recovery Cluster service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.