arczonalshift

package
v1.54.2 Latest Latest
Warning

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

Go to latest
Published: Jun 14, 2024 License: Apache-2.0 Imports: 10 Imported by: 6

Documentation

Overview

Package arczonalshift provides the client and types for making API requests to AWS ARC - Zonal Shift.

Welcome to the Zonal Shift API Reference Guide for Amazon Route 53 Application Recovery Controller (Route 53 ARC).

You can start a zonal shift to move traffic for a load balancer resource away from an Availability Zone to help your application recover quickly from an impairment in an Availability Zone. For example, you can recover your application from a developer's bad code deployment or from an Amazon Web Services infrastructure failure in a single Availability Zone.

You can also configure zonal autoshift for a load balancer resource. Zonal autoshift is a capability in Route 53 ARC where Amazon Web Services shifts away application resource traffic from an Availability Zone, on your behalf, to help reduce your time to recovery during events. Amazon Web Services shifts away traffic for resources that are enabled for zonal autoshift whenever Amazon Web Services determines that there's an issue in the Availability Zone that could potentially affect customers.

To ensure that zonal autoshift is safe for your application, you must also configure practice runs when you enable zonal autoshift for a resource. Practice runs start weekly zonal shifts for a resource, to shift traffic for the resource out of an Availability Zone. Practice runs make sure, on a regular basis, that you have enough capacity in all the Availability Zones in an Amazon Web Services Region for your application to continue to operate normally when traffic for a resource is shifted away from one Availability Zone.

You must prescale resource capacity in all Availability Zones in the Region where your application is deployed, before you configure practice runs or enable zonal autoshift for a resource. You should not rely on scaling on demand when an autoshift or practice run starts.

For more information about using zonal shift and zonal autoshift, see the Amazon Route 53 Application Recovery Controller Developer Guide (https://docs.aws.amazon.com/r53recovery/latest/dg/what-is-route53-recovery.html).

See https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30 for more information on this service.

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

Using the Client

To contact AWS ARC - Zonal Shift 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 AWS ARC - Zonal Shift client ARCZonalShift for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/arczonalshift/#New

Index

Constants

View Source
const (
	// AppliedStatusApplied is a AppliedStatus enum value
	AppliedStatusApplied = "APPLIED"

	// AppliedStatusNotApplied is a AppliedStatus enum value
	AppliedStatusNotApplied = "NOT_APPLIED"
)
View Source
const (
	// AutoshiftAppliedStatusApplied is a AutoshiftAppliedStatus enum value
	AutoshiftAppliedStatusApplied = "APPLIED"

	// AutoshiftAppliedStatusNotApplied is a AutoshiftAppliedStatus enum value
	AutoshiftAppliedStatusNotApplied = "NOT_APPLIED"
)
View Source
const (
	// AutoshiftExecutionStatusActive is a AutoshiftExecutionStatus enum value
	AutoshiftExecutionStatusActive = "ACTIVE"

	// AutoshiftExecutionStatusCompleted is a AutoshiftExecutionStatus enum value
	AutoshiftExecutionStatusCompleted = "COMPLETED"
)
View Source
const (
	// ConflictExceptionReasonZonalShiftAlreadyExists is a ConflictExceptionReason enum value
	ConflictExceptionReasonZonalShiftAlreadyExists = "ZonalShiftAlreadyExists"

	// ConflictExceptionReasonZonalShiftStatusNotActive is a ConflictExceptionReason enum value
	ConflictExceptionReasonZonalShiftStatusNotActive = "ZonalShiftStatusNotActive"

	// ConflictExceptionReasonSimultaneousZonalShiftsConflict is a ConflictExceptionReason enum value
	ConflictExceptionReasonSimultaneousZonalShiftsConflict = "SimultaneousZonalShiftsConflict"

	// ConflictExceptionReasonPracticeConfigurationAlreadyExists is a ConflictExceptionReason enum value
	ConflictExceptionReasonPracticeConfigurationAlreadyExists = "PracticeConfigurationAlreadyExists"

	// ConflictExceptionReasonAutoShiftEnabled is a ConflictExceptionReason enum value
	ConflictExceptionReasonAutoShiftEnabled = "AutoShiftEnabled"

	// ConflictExceptionReasonPracticeConfigurationDoesNotExist is a ConflictExceptionReason enum value
	ConflictExceptionReasonPracticeConfigurationDoesNotExist = "PracticeConfigurationDoesNotExist"
)
View Source
const (
	// PracticeRunOutcomeFailed is a PracticeRunOutcome enum value
	PracticeRunOutcomeFailed = "FAILED"

	// PracticeRunOutcomeInterrupted is a PracticeRunOutcome enum value
	PracticeRunOutcomeInterrupted = "INTERRUPTED"

	// PracticeRunOutcomePending is a PracticeRunOutcome enum value
	PracticeRunOutcomePending = "PENDING"

	// PracticeRunOutcomeSucceeded is a PracticeRunOutcome enum value
	PracticeRunOutcomeSucceeded = "SUCCEEDED"
)
View Source
const (
	// ValidationExceptionReasonInvalidExpiresIn is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidExpiresIn = "InvalidExpiresIn"

	// ValidationExceptionReasonInvalidStatus is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidStatus = "InvalidStatus"

	// ValidationExceptionReasonMissingValue is a ValidationExceptionReason enum value
	ValidationExceptionReasonMissingValue = "MissingValue"

	// ValidationExceptionReasonInvalidToken is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidToken = "InvalidToken"

	// ValidationExceptionReasonInvalidResourceIdentifier is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidResourceIdentifier = "InvalidResourceIdentifier"

	// ValidationExceptionReasonInvalidAz is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidAz = "InvalidAz"

	// ValidationExceptionReasonUnsupportedAz is a ValidationExceptionReason enum value
	ValidationExceptionReasonUnsupportedAz = "UnsupportedAz"

	// ValidationExceptionReasonInvalidAlarmCondition is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidAlarmCondition = "InvalidAlarmCondition"

	// ValidationExceptionReasonInvalidConditionType is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidConditionType = "InvalidConditionType"

	// ValidationExceptionReasonInvalidPracticeBlocker is a ValidationExceptionReason enum value
	ValidationExceptionReasonInvalidPracticeBlocker = "InvalidPracticeBlocker"
)
View Source
const (
	// ZonalAutoshiftStatusEnabled is a ZonalAutoshiftStatus enum value
	ZonalAutoshiftStatusEnabled = "ENABLED"

	// ZonalAutoshiftStatusDisabled is a ZonalAutoshiftStatus enum value
	ZonalAutoshiftStatusDisabled = "DISABLED"
)
View Source
const (
	// ZonalShiftStatusActive is a ZonalShiftStatus enum value
	ZonalShiftStatusActive = "ACTIVE"

	// ZonalShiftStatusExpired is a ZonalShiftStatus enum value
	ZonalShiftStatusExpired = "EXPIRED"

	// ZonalShiftStatusCanceled is a ZonalShiftStatus enum value
	ZonalShiftStatusCanceled = "CANCELED"
)
View Source
const (

	// ErrCodeAccessDeniedException for service response error code
	// "AccessDeniedException".
	//
	// You do not have sufficient access to perform this action.
	ErrCodeAccessDeniedException = "AccessDeniedException"

	// ErrCodeConflictException for service response error code
	// "ConflictException".
	//
	// The request could not be processed because of conflict in the current state
	// of the resource.
	ErrCodeConflictException = "ConflictException"

	// ErrCodeInternalServerException for service response error code
	// "InternalServerException".
	//
	// There was an internal server error.
	ErrCodeInternalServerException = "InternalServerException"

	// ErrCodeResourceNotFoundException for service response error code
	// "ResourceNotFoundException".
	//
	// The input requested a resource that was not found.
	ErrCodeResourceNotFoundException = "ResourceNotFoundException"

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

	// ErrCodeValidationException for service response error code
	// "ValidationException".
	//
	// The input fails to satisfy the constraints specified by an Amazon Web Services
	// service.
	ErrCodeValidationException = "ValidationException"
)
View Source
const (
	ServiceName = "ARC Zonal Shift" // Name of service.
	EndpointsID = "arc-zonal-shift" // ID to lookup a service endpoint with.
	ServiceID   = "ARC Zonal Shift" // ServiceID is a unique identifier of a specific service.
)

Service information constants

View Source
const (
	// ControlConditionTypeCloudwatch is a ControlConditionType enum value
	ControlConditionTypeCloudwatch = "CLOUDWATCH"
)

Variables

This section is empty.

Functions

func AppliedStatus_Values

func AppliedStatus_Values() []string

AppliedStatus_Values returns all elements of the AppliedStatus enum

func AutoshiftAppliedStatus_Values added in v1.48.10

func AutoshiftAppliedStatus_Values() []string

AutoshiftAppliedStatus_Values returns all elements of the AutoshiftAppliedStatus enum

func AutoshiftExecutionStatus_Values added in v1.48.10

func AutoshiftExecutionStatus_Values() []string

AutoshiftExecutionStatus_Values returns all elements of the AutoshiftExecutionStatus enum

func ConflictExceptionReason_Values

func ConflictExceptionReason_Values() []string

ConflictExceptionReason_Values returns all elements of the ConflictExceptionReason enum

func ControlConditionType_Values added in v1.48.10

func ControlConditionType_Values() []string

ControlConditionType_Values returns all elements of the ControlConditionType enum

func PracticeRunOutcome_Values added in v1.48.10

func PracticeRunOutcome_Values() []string

PracticeRunOutcome_Values returns all elements of the PracticeRunOutcome enum

func ValidationExceptionReason_Values

func ValidationExceptionReason_Values() []string

ValidationExceptionReason_Values returns all elements of the ValidationExceptionReason enum

func ZonalAutoshiftStatus_Values added in v1.48.10

func ZonalAutoshiftStatus_Values() []string

ZonalAutoshiftStatus_Values returns all elements of the ZonalAutoshiftStatus enum

func ZonalShiftStatus_Values

func ZonalShiftStatus_Values() []string

ZonalShiftStatus_Values returns all elements of the ZonalShiftStatus enum

Types

type ARCZonalShift

type ARCZonalShift struct {
	*client.Client
}

ARCZonalShift provides the API operation methods for making requests to AWS ARC - Zonal Shift. See this package's package overview docs for details on the service.

ARCZonalShift 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) *ARCZonalShift

New creates a new instance of the ARCZonalShift 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 ARCZonalShift client from just a session.
svc := arczonalshift.New(mySession)

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

func (*ARCZonalShift) CancelZonalShift

func (c *ARCZonalShift) CancelZonalShift(input *CancelZonalShiftInput) (*CancelZonalShiftOutput, error)

CancelZonalShift API operation for AWS ARC - Zonal Shift.

Cancel a zonal shift in Amazon Route 53 Application Recovery Controller. To cancel the zonal shift, specify the zonal shift ID.

A zonal shift can be one that you've started for a resource in your Amazon Web Services account in an Amazon Web Services Region, or it can be a zonal shift started by a practice run with zonal autoshift.

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 AWS ARC - Zonal Shift's API operation CancelZonalShift for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ConflictException The request could not be processed because of conflict in the current state of the resource.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/CancelZonalShift

func (*ARCZonalShift) CancelZonalShiftRequest

func (c *ARCZonalShift) CancelZonalShiftRequest(input *CancelZonalShiftInput) (req *request.Request, output *CancelZonalShiftOutput)

CancelZonalShiftRequest generates a "aws/request.Request" representing the client's request for the CancelZonalShift 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 CancelZonalShift for more information on using the CancelZonalShift 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 CancelZonalShiftRequest method.
req, resp := client.CancelZonalShiftRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/CancelZonalShift

func (*ARCZonalShift) CancelZonalShiftWithContext

func (c *ARCZonalShift) CancelZonalShiftWithContext(ctx aws.Context, input *CancelZonalShiftInput, opts ...request.Option) (*CancelZonalShiftOutput, error)

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

See CancelZonalShift 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 (*ARCZonalShift) CreatePracticeRunConfiguration added in v1.48.10

CreatePracticeRunConfiguration API operation for AWS ARC - Zonal Shift.

A practice run configuration for zonal autoshift is required when you enable zonal autoshift. A practice run configuration includes specifications for blocked dates and blocked time windows, and for Amazon CloudWatch alarms that you create to use with practice runs. The alarms that you specify are an outcome alarm, to monitor application health during practice runs and, optionally, a blocking alarm, to block practice runs from starting.

For more information, see Considerations when you configure zonal autoshift (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.considerations.html) in the Amazon 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 AWS ARC - Zonal Shift's API operation CreatePracticeRunConfiguration for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ConflictException The request could not be processed because of conflict in the current state of the resource.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/CreatePracticeRunConfiguration

func (*ARCZonalShift) CreatePracticeRunConfigurationRequest added in v1.48.10

func (c *ARCZonalShift) CreatePracticeRunConfigurationRequest(input *CreatePracticeRunConfigurationInput) (req *request.Request, output *CreatePracticeRunConfigurationOutput)

CreatePracticeRunConfigurationRequest generates a "aws/request.Request" representing the client's request for the CreatePracticeRunConfiguration 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 CreatePracticeRunConfiguration for more information on using the CreatePracticeRunConfiguration 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 CreatePracticeRunConfigurationRequest method.
req, resp := client.CreatePracticeRunConfigurationRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/CreatePracticeRunConfiguration

func (*ARCZonalShift) CreatePracticeRunConfigurationWithContext added in v1.48.10

func (c *ARCZonalShift) CreatePracticeRunConfigurationWithContext(ctx aws.Context, input *CreatePracticeRunConfigurationInput, opts ...request.Option) (*CreatePracticeRunConfigurationOutput, error)

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

See CreatePracticeRunConfiguration 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 (*ARCZonalShift) DeletePracticeRunConfiguration added in v1.48.10

DeletePracticeRunConfiguration API operation for AWS ARC - Zonal Shift.

Deletes the practice run configuration for a resource. Before you can delete a practice run configuration for a resource., you must disable zonal autoshift for the resource. Practice runs must be configured for zonal autoshift to be enabled.

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 AWS ARC - Zonal Shift's API operation DeletePracticeRunConfiguration for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ConflictException The request could not be processed because of conflict in the current state of the resource.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/DeletePracticeRunConfiguration

func (*ARCZonalShift) DeletePracticeRunConfigurationRequest added in v1.48.10

func (c *ARCZonalShift) DeletePracticeRunConfigurationRequest(input *DeletePracticeRunConfigurationInput) (req *request.Request, output *DeletePracticeRunConfigurationOutput)

DeletePracticeRunConfigurationRequest generates a "aws/request.Request" representing the client's request for the DeletePracticeRunConfiguration 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 DeletePracticeRunConfiguration for more information on using the DeletePracticeRunConfiguration 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 DeletePracticeRunConfigurationRequest method.
req, resp := client.DeletePracticeRunConfigurationRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/DeletePracticeRunConfiguration

func (*ARCZonalShift) DeletePracticeRunConfigurationWithContext added in v1.48.10

func (c *ARCZonalShift) DeletePracticeRunConfigurationWithContext(ctx aws.Context, input *DeletePracticeRunConfigurationInput, opts ...request.Option) (*DeletePracticeRunConfigurationOutput, error)

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

See DeletePracticeRunConfiguration 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 (*ARCZonalShift) GetManagedResource

func (c *ARCZonalShift) GetManagedResource(input *GetManagedResourceInput) (*GetManagedResourceOutput, error)

GetManagedResource API operation for AWS ARC - Zonal Shift.

Get information about a resource that's been registered for zonal shifts with Amazon Route 53 Application Recovery Controller in this Amazon Web Services Region. Resources that are registered for zonal shifts are managed resources in Route 53 ARC. You can start zonal shifts and configure zonal autoshift for managed resources.

At this time, you can only start a zonal shift or configure zonal autoshift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.

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 AWS ARC - Zonal Shift's API operation GetManagedResource for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/GetManagedResource

func (*ARCZonalShift) GetManagedResourceRequest

func (c *ARCZonalShift) GetManagedResourceRequest(input *GetManagedResourceInput) (req *request.Request, output *GetManagedResourceOutput)

GetManagedResourceRequest generates a "aws/request.Request" representing the client's request for the GetManagedResource 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 GetManagedResource for more information on using the GetManagedResource 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 GetManagedResourceRequest method.
req, resp := client.GetManagedResourceRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/GetManagedResource

func (*ARCZonalShift) GetManagedResourceWithContext

func (c *ARCZonalShift) GetManagedResourceWithContext(ctx aws.Context, input *GetManagedResourceInput, opts ...request.Option) (*GetManagedResourceOutput, error)

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

See GetManagedResource 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 (*ARCZonalShift) ListAutoshifts added in v1.48.10

func (c *ARCZonalShift) ListAutoshifts(input *ListAutoshiftsInput) (*ListAutoshiftsOutput, error)

ListAutoshifts API operation for AWS ARC - Zonal Shift.

Returns the active autoshifts for a specified resource.

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 AWS ARC - Zonal Shift's API operation ListAutoshifts for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListAutoshifts

func (*ARCZonalShift) ListAutoshiftsPages added in v1.48.10

func (c *ARCZonalShift) ListAutoshiftsPages(input *ListAutoshiftsInput, fn func(*ListAutoshiftsOutput, bool) bool) error

ListAutoshiftsPages iterates over the pages of a ListAutoshifts operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListAutoshifts method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListAutoshifts operation.
pageNum := 0
err := client.ListAutoshiftsPages(params,
    func(page *arczonalshift.ListAutoshiftsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ARCZonalShift) ListAutoshiftsPagesWithContext added in v1.48.10

func (c *ARCZonalShift) ListAutoshiftsPagesWithContext(ctx aws.Context, input *ListAutoshiftsInput, fn func(*ListAutoshiftsOutput, bool) bool, opts ...request.Option) error

ListAutoshiftsPagesWithContext same as ListAutoshiftsPages except it takes a Context and allows setting request options on the pages.

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 (*ARCZonalShift) ListAutoshiftsRequest added in v1.48.10

func (c *ARCZonalShift) ListAutoshiftsRequest(input *ListAutoshiftsInput) (req *request.Request, output *ListAutoshiftsOutput)

ListAutoshiftsRequest generates a "aws/request.Request" representing the client's request for the ListAutoshifts 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 ListAutoshifts for more information on using the ListAutoshifts 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 ListAutoshiftsRequest method.
req, resp := client.ListAutoshiftsRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListAutoshifts

func (*ARCZonalShift) ListAutoshiftsWithContext added in v1.48.10

func (c *ARCZonalShift) ListAutoshiftsWithContext(ctx aws.Context, input *ListAutoshiftsInput, opts ...request.Option) (*ListAutoshiftsOutput, error)

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

See ListAutoshifts 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 (*ARCZonalShift) ListManagedResources

func (c *ARCZonalShift) ListManagedResources(input *ListManagedResourcesInput) (*ListManagedResourcesOutput, error)

ListManagedResources API operation for AWS ARC - Zonal Shift.

Lists all the resources in your Amazon Web Services account in this Amazon Web Services Region that are managed for zonal shifts in Amazon Route 53 Application Recovery Controller, and information about them. The information includes the zonal autoshift status for the resource, as well as the Amazon Resource Name (ARN), the Availability Zones that each resource is deployed in, and the resource name.

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 AWS ARC - Zonal Shift's API operation ListManagedResources for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListManagedResources

func (*ARCZonalShift) ListManagedResourcesPages

func (c *ARCZonalShift) ListManagedResourcesPages(input *ListManagedResourcesInput, fn func(*ListManagedResourcesOutput, bool) bool) error

ListManagedResourcesPages iterates over the pages of a ListManagedResources operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListManagedResources method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListManagedResources operation.
pageNum := 0
err := client.ListManagedResourcesPages(params,
    func(page *arczonalshift.ListManagedResourcesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ARCZonalShift) ListManagedResourcesPagesWithContext

func (c *ARCZonalShift) ListManagedResourcesPagesWithContext(ctx aws.Context, input *ListManagedResourcesInput, fn func(*ListManagedResourcesOutput, bool) bool, opts ...request.Option) error

ListManagedResourcesPagesWithContext same as ListManagedResourcesPages except it takes a Context and allows setting request options on the pages.

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 (*ARCZonalShift) ListManagedResourcesRequest

func (c *ARCZonalShift) ListManagedResourcesRequest(input *ListManagedResourcesInput) (req *request.Request, output *ListManagedResourcesOutput)

ListManagedResourcesRequest generates a "aws/request.Request" representing the client's request for the ListManagedResources 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 ListManagedResources for more information on using the ListManagedResources 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 ListManagedResourcesRequest method.
req, resp := client.ListManagedResourcesRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListManagedResources

func (*ARCZonalShift) ListManagedResourcesWithContext

func (c *ARCZonalShift) ListManagedResourcesWithContext(ctx aws.Context, input *ListManagedResourcesInput, opts ...request.Option) (*ListManagedResourcesOutput, error)

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

See ListManagedResources 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 (*ARCZonalShift) ListZonalShifts

func (c *ARCZonalShift) ListZonalShifts(input *ListZonalShiftsInput) (*ListZonalShiftsOutput, error)

ListZonalShifts API operation for AWS ARC - Zonal Shift.

Lists all active and completed zonal shifts in Amazon Route 53 Application Recovery Controller in your Amazon Web Services account in this Amazon Web Services Region. ListZonalShifts returns customer-started zonal shifts, as well as practice run zonal shifts that Route 53 ARC started on your behalf for zonal autoshift.

The ListZonalShifts operation does not list autoshifts. For more information about listing autoshifts, see ">ListAutoshifts (https://docs.aws.amazon.com/arc-zonal-shift/latest/api/API_ListAutoshifts.html).

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 AWS ARC - Zonal Shift's API operation ListZonalShifts for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListZonalShifts

func (*ARCZonalShift) ListZonalShiftsPages

func (c *ARCZonalShift) ListZonalShiftsPages(input *ListZonalShiftsInput, fn func(*ListZonalShiftsOutput, bool) bool) error

ListZonalShiftsPages iterates over the pages of a ListZonalShifts operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListZonalShifts method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListZonalShifts operation.
pageNum := 0
err := client.ListZonalShiftsPages(params,
    func(page *arczonalshift.ListZonalShiftsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ARCZonalShift) ListZonalShiftsPagesWithContext

func (c *ARCZonalShift) ListZonalShiftsPagesWithContext(ctx aws.Context, input *ListZonalShiftsInput, fn func(*ListZonalShiftsOutput, bool) bool, opts ...request.Option) error

ListZonalShiftsPagesWithContext same as ListZonalShiftsPages except it takes a Context and allows setting request options on the pages.

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 (*ARCZonalShift) ListZonalShiftsRequest

func (c *ARCZonalShift) ListZonalShiftsRequest(input *ListZonalShiftsInput) (req *request.Request, output *ListZonalShiftsOutput)

ListZonalShiftsRequest generates a "aws/request.Request" representing the client's request for the ListZonalShifts 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 ListZonalShifts for more information on using the ListZonalShifts 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 ListZonalShiftsRequest method.
req, resp := client.ListZonalShiftsRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/ListZonalShifts

func (*ARCZonalShift) ListZonalShiftsWithContext

func (c *ARCZonalShift) ListZonalShiftsWithContext(ctx aws.Context, input *ListZonalShiftsInput, opts ...request.Option) (*ListZonalShiftsOutput, error)

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

See ListZonalShifts 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 (*ARCZonalShift) StartZonalShift

func (c *ARCZonalShift) StartZonalShift(input *StartZonalShiftInput) (*StartZonalShiftOutput, error)

StartZonalShift API operation for AWS ARC - Zonal Shift.

You start a zonal shift to temporarily move load balancer traffic away from an Availability Zone in an Amazon Web Services Region, to help your application recover immediately, for example, from a developer's bad code deployment or from an Amazon Web Services infrastructure failure in a single Availability Zone. You can start a zonal shift in Route 53 ARC only for managed resources in your Amazon Web Services account in an Amazon Web Services Region. Resources are automatically registered with Route 53 ARC by Amazon Web Services services.

At this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.

When you start a zonal shift, traffic for the resource is no longer routed to the Availability Zone. The zonal shift is created immediately in Route 53 ARC. However, it can take a short time, typically up to a few minutes, for existing, in-progress connections in the Availability Zone to complete.

For more information, see Zonal shift (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-shift.html) in the Amazon 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 AWS ARC - Zonal Shift's API operation StartZonalShift for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ConflictException The request could not be processed because of conflict in the current state of the resource.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/StartZonalShift

func (*ARCZonalShift) StartZonalShiftRequest

func (c *ARCZonalShift) StartZonalShiftRequest(input *StartZonalShiftInput) (req *request.Request, output *StartZonalShiftOutput)

StartZonalShiftRequest generates a "aws/request.Request" representing the client's request for the StartZonalShift 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 StartZonalShift for more information on using the StartZonalShift 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 StartZonalShiftRequest method.
req, resp := client.StartZonalShiftRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/StartZonalShift

func (*ARCZonalShift) StartZonalShiftWithContext

func (c *ARCZonalShift) StartZonalShiftWithContext(ctx aws.Context, input *StartZonalShiftInput, opts ...request.Option) (*StartZonalShiftOutput, error)

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

See StartZonalShift 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 (*ARCZonalShift) UpdatePracticeRunConfiguration added in v1.48.10

UpdatePracticeRunConfiguration API operation for AWS ARC - Zonal Shift.

Update a practice run configuration to change one or more of the following: add, change, or remove the blocking alarm; change the outcome alarm; or add, change, or remove blocking dates or time windows.

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 AWS ARC - Zonal Shift's API operation UpdatePracticeRunConfiguration for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ConflictException The request could not be processed because of conflict in the current state of the resource.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdatePracticeRunConfiguration

func (*ARCZonalShift) UpdatePracticeRunConfigurationRequest added in v1.48.10

func (c *ARCZonalShift) UpdatePracticeRunConfigurationRequest(input *UpdatePracticeRunConfigurationInput) (req *request.Request, output *UpdatePracticeRunConfigurationOutput)

UpdatePracticeRunConfigurationRequest generates a "aws/request.Request" representing the client's request for the UpdatePracticeRunConfiguration 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 UpdatePracticeRunConfiguration for more information on using the UpdatePracticeRunConfiguration 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 UpdatePracticeRunConfigurationRequest method.
req, resp := client.UpdatePracticeRunConfigurationRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdatePracticeRunConfiguration

func (*ARCZonalShift) UpdatePracticeRunConfigurationWithContext added in v1.48.10

func (c *ARCZonalShift) UpdatePracticeRunConfigurationWithContext(ctx aws.Context, input *UpdatePracticeRunConfigurationInput, opts ...request.Option) (*UpdatePracticeRunConfigurationOutput, error)

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

See UpdatePracticeRunConfiguration 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 (*ARCZonalShift) UpdateZonalAutoshiftConfiguration added in v1.48.10

UpdateZonalAutoshiftConfiguration API operation for AWS ARC - Zonal Shift.

You can update the zonal autoshift status for a resource, to enable or disable zonal autoshift. When zonal autoshift is ENABLED, Amazon Web Services shifts away resource traffic from an Availability Zone, on your behalf, when Amazon Web Services determines that there's an issue in the Availability Zone that could potentially affect customers.

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 AWS ARC - Zonal Shift's API operation UpdateZonalAutoshiftConfiguration for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ConflictException The request could not be processed because of conflict in the current state of the resource.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateZonalAutoshiftConfiguration

func (*ARCZonalShift) UpdateZonalAutoshiftConfigurationRequest added in v1.48.10

func (c *ARCZonalShift) UpdateZonalAutoshiftConfigurationRequest(input *UpdateZonalAutoshiftConfigurationInput) (req *request.Request, output *UpdateZonalAutoshiftConfigurationOutput)

UpdateZonalAutoshiftConfigurationRequest generates a "aws/request.Request" representing the client's request for the UpdateZonalAutoshiftConfiguration 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 UpdateZonalAutoshiftConfiguration for more information on using the UpdateZonalAutoshiftConfiguration 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 UpdateZonalAutoshiftConfigurationRequest method.
req, resp := client.UpdateZonalAutoshiftConfigurationRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateZonalAutoshiftConfiguration

func (*ARCZonalShift) UpdateZonalAutoshiftConfigurationWithContext added in v1.48.10

func (c *ARCZonalShift) UpdateZonalAutoshiftConfigurationWithContext(ctx aws.Context, input *UpdateZonalAutoshiftConfigurationInput, opts ...request.Option) (*UpdateZonalAutoshiftConfigurationOutput, error)

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

See UpdateZonalAutoshiftConfiguration 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 (*ARCZonalShift) UpdateZonalShift

func (c *ARCZonalShift) UpdateZonalShift(input *UpdateZonalShiftInput) (*UpdateZonalShiftOutput, error)

UpdateZonalShift API operation for AWS ARC - Zonal Shift.

Update an active zonal shift in Amazon Route 53 Application Recovery Controller in your Amazon Web Services account. You can update a zonal shift to set a new expiration, or edit or replace the comment for the zonal shift.

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 AWS ARC - Zonal Shift's API operation UpdateZonalShift for usage and error information.

Returned Error Types:

  • InternalServerException There was an internal server error.

  • ConflictException The request could not be processed because of conflict in the current state of the resource.

  • ResourceNotFoundException The input requested a resource that was not found.

  • ThrottlingException The request was denied due to request throttling.

  • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.

  • AccessDeniedException You do not have sufficient access to perform this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateZonalShift

func (*ARCZonalShift) UpdateZonalShiftRequest

func (c *ARCZonalShift) UpdateZonalShiftRequest(input *UpdateZonalShiftInput) (req *request.Request, output *UpdateZonalShiftOutput)

UpdateZonalShiftRequest generates a "aws/request.Request" representing the client's request for the UpdateZonalShift 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 UpdateZonalShift for more information on using the UpdateZonalShift 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 UpdateZonalShiftRequest method.
req, resp := client.UpdateZonalShiftRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateZonalShift

func (*ARCZonalShift) UpdateZonalShiftWithContext

func (c *ARCZonalShift) UpdateZonalShiftWithContext(ctx aws.Context, input *UpdateZonalShiftInput, opts ...request.Option) (*UpdateZonalShiftOutput, error)

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

See UpdateZonalShift 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 AccessDeniedException

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

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

You do not have sufficient access to perform this action.

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 AutoshiftInResource added in v1.48.10

type AutoshiftInResource struct {

	// The appliedStatus field specifies which application traffic shift is in effect
	// for a resource when there is more than one traffic shift active. There can
	// be more than one application traffic shift in progress at the same time -
	// that is, practice run zonal shifts, customer-started zonal shifts, or an
	// autoshift. The appliedStatus field for an autoshift for a resource can have
	// one of two values: APPLIED or NOT_APPLIED. The zonal shift or autoshift that
	// is currently in effect for the resource has an applied status set to APPLIED.
	//
	// The overall principle for precedence is that zonal shifts that you start
	// as a customer take precedence autoshifts, which take precedence over practice
	// runs. That is, customer-started zonal shifts > autoshifts > practice run
	// zonal shifts.
	//
	// For more information, see How zonal autoshift and practice runs work (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.how-it-works.html)
	// in the Amazon Route 53 Application Recovery Controller Developer Guide.
	//
	// AppliedStatus is a required field
	AppliedStatus *string `locationName:"appliedStatus" type:"string" required:"true" enum:"AutoshiftAppliedStatus"`

	// The Availability Zone that traffic is shifted away from for a resource, when
	// Amazon Web Services starts an autoshift. Until the autoshift ends, traffic
	// for the resource is instead directed to other Availability Zones in the Amazon
	// Web Services Region. An autoshift can end for a resource, for example, when
	// Amazon Web Services ends the autoshift for the Availability Zone or when
	// you disable zonal autoshift for the resource.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// The time (UTC) when the autoshift started.
	//
	// StartTime is a required field
	StartTime *time.Time `locationName:"startTime" type:"timestamp" required:"true"`
	// contains filtered or unexported fields
}

A complex structure that lists an autoshift that is currently active for a managed resource and information about the autoshift.

For more information, see How zonal autoshift and practice runs work (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.how-it-works.html) in the Amazon Route 53 Application Recovery Controller Developer Guide.

func (AutoshiftInResource) GoString added in v1.48.10

func (s AutoshiftInResource) 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 (*AutoshiftInResource) SetAppliedStatus added in v1.48.10

func (s *AutoshiftInResource) SetAppliedStatus(v string) *AutoshiftInResource

SetAppliedStatus sets the AppliedStatus field's value.

func (*AutoshiftInResource) SetAwayFrom added in v1.48.10

func (s *AutoshiftInResource) SetAwayFrom(v string) *AutoshiftInResource

SetAwayFrom sets the AwayFrom field's value.

func (*AutoshiftInResource) SetStartTime added in v1.48.10

func (s *AutoshiftInResource) SetStartTime(v time.Time) *AutoshiftInResource

SetStartTime sets the StartTime field's value.

func (AutoshiftInResource) String added in v1.48.10

func (s AutoshiftInResource) 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 AutoshiftSummary added in v1.48.10

type AutoshiftSummary struct {

	// The Availability Zone that traffic is shifted away from for a resource when
	// Amazon Web Services starts an autoshift. Until the autoshift ends, traffic
	// for the resource is instead directed to other Availability Zones in the Amazon
	// Web Services Region. An autoshift can end for a resource, for example, when
	// Amazon Web Services ends the autoshift for the Availability Zone or when
	// you disable zonal autoshift for the resource.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// The time (in UTC) when the autoshift ended.
	//
	// EndTime is a required field
	EndTime *time.Time `locationName:"endTime" type:"timestamp" required:"true"`

	// The time (in UTC) when the autoshift started.
	//
	// StartTime is a required field
	StartTime *time.Time `locationName:"startTime" type:"timestamp" required:"true"`

	// The status for an autoshift.
	//
	// Status is a required field
	Status *string `locationName:"status" type:"string" required:"true" enum:"AutoshiftExecutionStatus"`
	// contains filtered or unexported fields
}

Information about an autoshift. Amazon Web Services starts an autoshift to temporarily move traffic for a resource away from an Availability Zone in an Amazon Web Services Region when Amazon Web Services determines that there's an issue in the Availability Zone that could potentially affect customers. You can configure zonal autoshift in Route 53 ARC for managed resources in your Amazon Web Services account in a Region. Supported Amazon Web Services resources are automatically registered with Route 53 ARC.

Autoshifts are temporary. When the Availability Zone recovers, Amazon Web Services ends the autoshift, and traffic for the resource is no longer directed to the other Availability Zones in the Region.

You can stop an autoshift for a resource by disabling zonal autoshift.

func (AutoshiftSummary) GoString added in v1.48.10

func (s AutoshiftSummary) 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 (*AutoshiftSummary) SetAwayFrom added in v1.48.10

func (s *AutoshiftSummary) SetAwayFrom(v string) *AutoshiftSummary

SetAwayFrom sets the AwayFrom field's value.

func (*AutoshiftSummary) SetEndTime added in v1.48.10

func (s *AutoshiftSummary) SetEndTime(v time.Time) *AutoshiftSummary

SetEndTime sets the EndTime field's value.

func (*AutoshiftSummary) SetStartTime added in v1.48.10

func (s *AutoshiftSummary) SetStartTime(v time.Time) *AutoshiftSummary

SetStartTime sets the StartTime field's value.

func (*AutoshiftSummary) SetStatus added in v1.48.10

func (s *AutoshiftSummary) SetStatus(v string) *AutoshiftSummary

SetStatus sets the Status field's value.

func (AutoshiftSummary) String added in v1.48.10

func (s AutoshiftSummary) 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 CancelZonalShiftInput

type CancelZonalShiftInput struct {

	// The internally-generated identifier of a zonal shift.
	//
	// ZonalShiftId is a required field
	ZonalShiftId *string `location:"uri" locationName:"zonalShiftId" min:"6" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CancelZonalShiftInput) GoString

func (s CancelZonalShiftInput) 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 (*CancelZonalShiftInput) SetZonalShiftId

func (s *CancelZonalShiftInput) SetZonalShiftId(v string) *CancelZonalShiftInput

SetZonalShiftId sets the ZonalShiftId field's value.

func (CancelZonalShiftInput) String

func (s CancelZonalShiftInput) 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 (*CancelZonalShiftInput) Validate

func (s *CancelZonalShiftInput) Validate() error

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

type CancelZonalShiftOutput

type CancelZonalShiftOutput struct {

	// The Availability Zone that traffic is moved away from for a resource when
	// you start a zonal shift. Until the zonal shift expires or you cancel it,
	// traffic for the resource is instead moved to other Availability Zones in
	// the Amazon Web Services Region.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// A comment that you enter about the zonal shift. Only the latest comment is
	// retained; no comment history is maintained. A new comment overwrites any
	// existing comment string.
	//
	// Comment is a required field
	Comment *string `locationName:"comment" type:"string" required:"true"`

	// The expiry time (expiration time) for a customer-started zonal shift. A zonal
	// shift is temporary and must be set to expire when you start the zonal shift.
	// You can initially set a zonal shift to expire in a maximum of three days
	// (72 hours). However, you can update a zonal shift to set a new expiration
	// at any time.
	//
	// When you start a zonal shift, you specify how long you want it to be active,
	// which Route 53 ARC converts to an expiry time (expiration time). You can
	// cancel a zonal shift when you're ready to restore traffic to the Availability
	// Zone, or just wait for it to expire. Or you can update the zonal shift to
	// specify another length of time to expire in.
	//
	// ExpiryTime is a required field
	ExpiryTime *time.Time `locationName:"expiryTime" type:"timestamp" required:"true"`

	// The identifier for the resource to shift away traffic for. The identifier
	// is the Amazon Resource Name (ARN) for the resource.
	//
	// At this time, supported resources are Network Load Balancers and Application
	// Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`

	// The time (UTC) when the zonal shift starts.
	//
	// StartTime is a required field
	StartTime *time.Time `locationName:"startTime" type:"timestamp" required:"true"`

	// A status for a zonal shift.
	//
	// The Status for a zonal shift can have one of the following values:
	//
	//    * ACTIVE: The zonal shift has been started and active.
	//
	//    * EXPIRED: The zonal shift has expired (the expiry time was exceeded).
	//
	//    * CANCELED: The zonal shift was canceled.
	//
	// Status is a required field
	Status *string `locationName:"status" type:"string" required:"true" enum:"ZonalShiftStatus"`

	// The identifier of a zonal shift.
	//
	// ZonalShiftId is a required field
	ZonalShiftId *string `locationName:"zonalShiftId" min:"6" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CancelZonalShiftOutput) GoString

func (s CancelZonalShiftOutput) 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 (*CancelZonalShiftOutput) SetAwayFrom

SetAwayFrom sets the AwayFrom field's value.

func (*CancelZonalShiftOutput) SetComment

SetComment sets the Comment field's value.

func (*CancelZonalShiftOutput) SetExpiryTime

SetExpiryTime sets the ExpiryTime field's value.

func (*CancelZonalShiftOutput) SetResourceIdentifier

func (s *CancelZonalShiftOutput) SetResourceIdentifier(v string) *CancelZonalShiftOutput

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*CancelZonalShiftOutput) SetStartTime

SetStartTime sets the StartTime field's value.

func (*CancelZonalShiftOutput) SetStatus

SetStatus sets the Status field's value.

func (*CancelZonalShiftOutput) SetZonalShiftId

func (s *CancelZonalShiftOutput) SetZonalShiftId(v string) *CancelZonalShiftOutput

SetZonalShiftId sets the ZonalShiftId field's value.

func (CancelZonalShiftOutput) String

func (s CancelZonalShiftOutput) 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:"-"`

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

	// The reason for the conflict exception.
	//
	// Reason is a required field
	Reason *string `locationName:"reason" type:"string" required:"true" enum:"ConflictExceptionReason"`

	// The zonal shift ID associated with the conflict exception.
	ZonalShiftId *string `locationName:"zonalShiftId" type:"string"`
	// contains filtered or unexported fields
}

The request could not be processed because of conflict in the current state of the resource.

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 ControlCondition added in v1.48.10

type ControlCondition struct {

	// The Amazon Resource Name (ARN) for the Amazon CloudWatch alarm that you specify
	// as a control condition for a practice run.
	//
	// AlarmIdentifier is a required field
	AlarmIdentifier *string `locationName:"alarmIdentifier" min:"8" type:"string" required:"true"`

	// The type of alarm specified for a practice run. The only valid value is CLOUDWATCH.
	//
	// Type is a required field
	Type *string `locationName:"type" type:"string" required:"true" enum:"ControlConditionType"`
	// contains filtered or unexported fields
}

A control condition is an alarm that you specify for a practice run. When you configure practice runs with zonal autoshift for a resource, you specify Amazon CloudWatch alarms, which you create in CloudWatch to use with the practice run. The alarms that you specify are an outcome alarm, to monitor application health during practice runs and, optionally, a blocking alarm, to block practice runs from starting.

Control condition alarms do not apply for autoshifts.

For more information, see Considerations when you configure zonal autoshift (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.considerations.html) in the Amazon Route 53 Application Recovery Controller Developer Guide.

func (ControlCondition) GoString added in v1.48.10

func (s ControlCondition) 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 (*ControlCondition) SetAlarmIdentifier added in v1.48.10

func (s *ControlCondition) SetAlarmIdentifier(v string) *ControlCondition

SetAlarmIdentifier sets the AlarmIdentifier field's value.

func (*ControlCondition) SetType added in v1.48.10

func (s *ControlCondition) SetType(v string) *ControlCondition

SetType sets the Type field's value.

func (ControlCondition) String added in v1.48.10

func (s ControlCondition) 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 (*ControlCondition) Validate added in v1.48.10

func (s *ControlCondition) Validate() error

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

type CreatePracticeRunConfigurationInput added in v1.48.10

type CreatePracticeRunConfigurationInput struct {

	// Optionally, you can block Route 53 ARC from starting practice runs for a
	// resource on specific calendar dates.
	//
	// The format for blocked dates is: YYYY-MM-DD. Keep in mind, when you specify
	// dates, that dates and times for practice runs are in UTC. Separate multiple
	// blocked dates with spaces.
	//
	// For example, if you have an application update scheduled to launch on May
	// 1, 2024, and you don't want practice runs to shift traffic away at that time,
	// you could set a blocked date for 2024-05-01.
	BlockedDates []*string `locationName:"blockedDates" type:"list"`

	// Optionally, you can block Route 53 ARC from starting practice runs for specific
	// windows of days and times.
	//
	// The format for blocked windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind, when
	// you specify dates, that dates and times for practice runs are in UTC. Also,
	// be aware of potential time adjustments that might be required for daylight
	// saving time differences. Separate multiple blocked windows with spaces.
	//
	// For example, say you run business report summaries three days a week. For
	// this scenario, you might set the following recurring days and times as blocked
	// windows, for example: MON-20:30-21:30 WED-20:30-21:30 FRI-20:30-21:30.
	BlockedWindows []*string `locationName:"blockedWindows" type:"list"`

	// An Amazon CloudWatch alarm that you can specify for zonal autoshift practice
	// runs. This alarm blocks Route 53 ARC from starting practice run zonal shifts,
	// and ends a practice run that's in progress, when the alarm is in an ALARM
	// state.
	BlockingAlarms []*ControlCondition `locationName:"blockingAlarms" min:"1" type:"list"`

	// The outcome alarm for practice runs is a required Amazon CloudWatch alarm
	// that you specify that ends a practice run when the alarm is in an ALARM state.
	//
	// Configure the alarm to monitor the health of your application when traffic
	// is shifted away from an Availability Zone during each weekly practice run.
	// You should configure the alarm to go into an ALARM state if your application
	// is impacted by the zonal shift, and you want to stop the zonal shift, to
	// let traffic for the resource return to the Availability Zone.
	//
	// OutcomeAlarms is a required field
	OutcomeAlarms []*ControlCondition `locationName:"outcomeAlarms" min:"1" type:"list" required:"true"`

	// The identifier of the resource to shift away traffic for when a practice
	// run starts a zonal shift. The identifier is the Amazon Resource Name (ARN)
	// for the resource.
	//
	// At this time, supported resources are Network Load Balancers and Application
	// Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CreatePracticeRunConfigurationInput) GoString added in v1.48.10

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 (*CreatePracticeRunConfigurationInput) SetBlockedDates added in v1.48.10

SetBlockedDates sets the BlockedDates field's value.

func (*CreatePracticeRunConfigurationInput) SetBlockedWindows added in v1.48.10

SetBlockedWindows sets the BlockedWindows field's value.

func (*CreatePracticeRunConfigurationInput) SetBlockingAlarms added in v1.48.10

SetBlockingAlarms sets the BlockingAlarms field's value.

func (*CreatePracticeRunConfigurationInput) SetOutcomeAlarms added in v1.48.10

SetOutcomeAlarms sets the OutcomeAlarms field's value.

func (*CreatePracticeRunConfigurationInput) SetResourceIdentifier added in v1.48.10

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (CreatePracticeRunConfigurationInput) String added in v1.48.10

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 (*CreatePracticeRunConfigurationInput) Validate added in v1.48.10

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

type CreatePracticeRunConfigurationOutput added in v1.48.10

type CreatePracticeRunConfigurationOutput struct {

	// The Amazon Resource Name (ARN) of the resource that you configured the practice
	// run for.
	//
	// Arn is a required field
	Arn *string `locationName:"arn" min:"8" type:"string" required:"true"`

	// The name of the resource that you configured the practice run for.
	//
	// Name is a required field
	Name *string `locationName:"name" min:"1" type:"string" required:"true"`

	// A practice run configuration for a resource. Configurations include the outcome
	// alarm that you specify for practice runs, and, optionally, a blocking alarm
	// and blocking dates and windows.
	//
	// PracticeRunConfiguration is a required field
	PracticeRunConfiguration *PracticeRunConfiguration `locationName:"practiceRunConfiguration" type:"structure" required:"true"`

	// The status for zonal autoshift for a resource. When you specify the autoshift
	// status as ENABLED, Amazon Web Services shifts traffic away from shifts away
	// application resource traffic from an Availability Zone, on your behalf, when
	// Amazon Web Services determines that there's an issue in the Availability
	// Zone that could potentially affect customers.
	//
	// When you enable zonal autoshift, you must also configure practice runs for
	// the resource.
	//
	// ZonalAutoshiftStatus is a required field
	ZonalAutoshiftStatus *string `locationName:"zonalAutoshiftStatus" type:"string" required:"true" enum:"ZonalAutoshiftStatus"`
	// contains filtered or unexported fields
}

func (CreatePracticeRunConfigurationOutput) GoString added in v1.48.10

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 (*CreatePracticeRunConfigurationOutput) SetArn added in v1.48.10

SetArn sets the Arn field's value.

func (*CreatePracticeRunConfigurationOutput) SetName added in v1.48.10

SetName sets the Name field's value.

func (*CreatePracticeRunConfigurationOutput) SetPracticeRunConfiguration added in v1.48.10

SetPracticeRunConfiguration sets the PracticeRunConfiguration field's value.

func (*CreatePracticeRunConfigurationOutput) SetZonalAutoshiftStatus added in v1.48.10

SetZonalAutoshiftStatus sets the ZonalAutoshiftStatus field's value.

func (CreatePracticeRunConfigurationOutput) String added in v1.48.10

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 DeletePracticeRunConfigurationInput added in v1.48.10

type DeletePracticeRunConfigurationInput struct {

	// The identifier for the resource that you want to delete the practice run
	// configuration for. The identifier is the Amazon Resource Name (ARN) for the
	// resource.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `location:"uri" locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeletePracticeRunConfigurationInput) GoString added in v1.48.10

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 (*DeletePracticeRunConfigurationInput) SetResourceIdentifier added in v1.48.10

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (DeletePracticeRunConfigurationInput) String added in v1.48.10

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 (*DeletePracticeRunConfigurationInput) Validate added in v1.48.10

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

type DeletePracticeRunConfigurationOutput added in v1.48.10

type DeletePracticeRunConfigurationOutput struct {

	// The Amazon Resource Name (ARN) of the resource that you deleted the practice
	// run for.
	//
	// Arn is a required field
	Arn *string `locationName:"arn" min:"8" type:"string" required:"true"`

	// The name of the resource that you deleted the practice run for.
	//
	// Name is a required field
	Name *string `locationName:"name" min:"1" type:"string" required:"true"`

	// The status of zonal autoshift for the resource.
	//
	// ZonalAutoshiftStatus is a required field
	ZonalAutoshiftStatus *string `locationName:"zonalAutoshiftStatus" type:"string" required:"true" enum:"ZonalAutoshiftStatus"`
	// contains filtered or unexported fields
}

func (DeletePracticeRunConfigurationOutput) GoString added in v1.48.10

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 (*DeletePracticeRunConfigurationOutput) SetArn added in v1.48.10

SetArn sets the Arn field's value.

func (*DeletePracticeRunConfigurationOutput) SetName added in v1.48.10

SetName sets the Name field's value.

func (*DeletePracticeRunConfigurationOutput) SetZonalAutoshiftStatus added in v1.48.10

SetZonalAutoshiftStatus sets the ZonalAutoshiftStatus field's value.

func (DeletePracticeRunConfigurationOutput) String added in v1.48.10

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 GetManagedResourceInput

type GetManagedResourceInput struct {

	// The identifier for the resource to shift away traffic for. The identifier
	// is the Amazon Resource Name (ARN) for the resource.
	//
	// At this time, supported resources are Network Load Balancers and Application
	// Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `location:"uri" locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetManagedResourceInput) GoString

func (s GetManagedResourceInput) 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 (*GetManagedResourceInput) SetResourceIdentifier

func (s *GetManagedResourceInput) SetResourceIdentifier(v string) *GetManagedResourceInput

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (GetManagedResourceInput) String

func (s GetManagedResourceInput) 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 (*GetManagedResourceInput) Validate

func (s *GetManagedResourceInput) Validate() error

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

type GetManagedResourceOutput

type GetManagedResourceOutput struct {

	// A collection of key-value pairs that indicate whether resources are active
	// in Availability Zones or not. The key name is the Availability Zone where
	// the resource is deployed. The value is 1 or 0.
	//
	// AppliedWeights is a required field
	AppliedWeights map[string]*float64 `locationName:"appliedWeights" type:"map" required:"true"`

	// The Amazon Resource Name (ARN) for the resource.
	Arn *string `locationName:"arn" min:"8" type:"string"`

	// An array of the autoshifts that are active for the resource.
	Autoshifts []*AutoshiftInResource `locationName:"autoshifts" type:"list"`

	// The name of the resource.
	Name *string `locationName:"name" min:"1" type:"string"`

	// The practice run configuration for zonal autoshift that's associated with
	// the resource.
	PracticeRunConfiguration *PracticeRunConfiguration `locationName:"practiceRunConfiguration" type:"structure"`

	// The status for zonal autoshift for a resource. When the autoshift status
	// is ENABLED, Amazon Web Services shifts traffic for a resource away from an
	// Availability Zone, on your behalf, when Amazon Web Services determines that
	// there's an issue in the Availability Zone that could potentially affect customers.
	ZonalAutoshiftStatus *string `locationName:"zonalAutoshiftStatus" type:"string" enum:"ZonalAutoshiftStatus"`

	// The zonal shifts that are currently active for a resource.
	//
	// ZonalShifts is a required field
	ZonalShifts []*ZonalShiftInResource `locationName:"zonalShifts" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (GetManagedResourceOutput) GoString

func (s GetManagedResourceOutput) 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 (*GetManagedResourceOutput) SetAppliedWeights

func (s *GetManagedResourceOutput) SetAppliedWeights(v map[string]*float64) *GetManagedResourceOutput

SetAppliedWeights sets the AppliedWeights field's value.

func (*GetManagedResourceOutput) SetArn

SetArn sets the Arn field's value.

func (*GetManagedResourceOutput) SetAutoshifts added in v1.48.10

SetAutoshifts sets the Autoshifts field's value.

func (*GetManagedResourceOutput) SetName

SetName sets the Name field's value.

func (*GetManagedResourceOutput) SetPracticeRunConfiguration added in v1.48.10

SetPracticeRunConfiguration sets the PracticeRunConfiguration field's value.

func (*GetManagedResourceOutput) SetZonalAutoshiftStatus added in v1.48.10

func (s *GetManagedResourceOutput) SetZonalAutoshiftStatus(v string) *GetManagedResourceOutput

SetZonalAutoshiftStatus sets the ZonalAutoshiftStatus field's value.

func (*GetManagedResourceOutput) SetZonalShifts

SetZonalShifts sets the ZonalShifts field's value.

func (GetManagedResourceOutput) String

func (s GetManagedResourceOutput) 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"`
	// contains filtered or unexported fields
}

There was an internal server error.

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 ListAutoshiftsInput added in v1.48.10

type ListAutoshiftsInput struct {

	// The number of objects that you want to return with this call.
	MaxResults *int64 `location:"querystring" locationName:"maxResults" min:"1" type:"integer"`

	// Specifies that you want to receive the next page of results. Valid only if
	// you received a NextToken response in the previous request. If you did, it
	// indicates that more output is available. Set this parameter to the value
	// provided by the previous call's NextToken response to request the next page
	// of results.
	NextToken *string `location:"querystring" locationName:"nextToken" type:"string"`

	// The status of the autoshift.
	Status *string `location:"querystring" locationName:"status" type:"string" enum:"AutoshiftExecutionStatus"`
	// contains filtered or unexported fields
}

func (ListAutoshiftsInput) GoString added in v1.48.10

func (s ListAutoshiftsInput) 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 (*ListAutoshiftsInput) SetMaxResults added in v1.48.10

func (s *ListAutoshiftsInput) SetMaxResults(v int64) *ListAutoshiftsInput

SetMaxResults sets the MaxResults field's value.

func (*ListAutoshiftsInput) SetNextToken added in v1.48.10

func (s *ListAutoshiftsInput) SetNextToken(v string) *ListAutoshiftsInput

SetNextToken sets the NextToken field's value.

func (*ListAutoshiftsInput) SetStatus added in v1.48.10

SetStatus sets the Status field's value.

func (ListAutoshiftsInput) String added in v1.48.10

func (s ListAutoshiftsInput) 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 (*ListAutoshiftsInput) Validate added in v1.48.10

func (s *ListAutoshiftsInput) Validate() error

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

type ListAutoshiftsOutput added in v1.48.10

type ListAutoshiftsOutput struct {

	// The items in the response list.
	Items []*AutoshiftSummary `locationName:"items" type:"list"`

	// Specifies that you want to receive the next page of results. Valid only if
	// you received a NextToken response in the previous request. If you did, it
	// indicates that more output is available. Set this parameter to the value
	// provided by the previous call's NextToken response to request the next page
	// of results.
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (ListAutoshiftsOutput) GoString added in v1.48.10

func (s ListAutoshiftsOutput) 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 (*ListAutoshiftsOutput) SetItems added in v1.48.10

SetItems sets the Items field's value.

func (*ListAutoshiftsOutput) SetNextToken added in v1.48.10

func (s *ListAutoshiftsOutput) SetNextToken(v string) *ListAutoshiftsOutput

SetNextToken sets the NextToken field's value.

func (ListAutoshiftsOutput) String added in v1.48.10

func (s ListAutoshiftsOutput) 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 ListManagedResourcesInput

type ListManagedResourcesInput struct {

	// The number of objects that you want to return with this call.
	MaxResults *int64 `location:"querystring" locationName:"maxResults" min:"1" type:"integer"`

	// Specifies that you want to receive the next page of results. Valid only if
	// you received a NextToken response in the previous request. If you did, it
	// indicates that more output is available. Set this parameter to the value
	// provided by the previous call's NextToken response to request the next page
	// of results.
	NextToken *string `location:"querystring" locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (ListManagedResourcesInput) GoString

func (s ListManagedResourcesInput) 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 (*ListManagedResourcesInput) SetMaxResults

SetMaxResults sets the MaxResults field's value.

func (*ListManagedResourcesInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (ListManagedResourcesInput) String

func (s ListManagedResourcesInput) 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 (*ListManagedResourcesInput) Validate

func (s *ListManagedResourcesInput) Validate() error

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

type ListManagedResourcesOutput

type ListManagedResourcesOutput struct {

	// The items in the response list.
	//
	// Items is a required field
	Items []*ManagedResourceSummary `locationName:"items" type:"list" required:"true"`

	// Specifies that you want to receive the next page of results. Valid only if
	// you received a NextToken response in the previous request. If you did, it
	// indicates that more output is available. Set this parameter to the value
	// provided by the previous call's NextToken response to request the next page
	// of results.
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (ListManagedResourcesOutput) GoString

func (s ListManagedResourcesOutput) 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 (*ListManagedResourcesOutput) SetItems

SetItems sets the Items field's value.

func (*ListManagedResourcesOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (ListManagedResourcesOutput) 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 ListZonalShiftsInput

type ListZonalShiftsInput struct {

	// The number of objects that you want to return with this call.
	MaxResults *int64 `location:"querystring" locationName:"maxResults" min:"1" type:"integer"`

	// Specifies that you want to receive the next page of results. Valid only if
	// you received a NextToken response in the previous request. If you did, it
	// indicates that more output is available. Set this parameter to the value
	// provided by the previous call's NextToken response to request the next page
	// of results.
	NextToken *string `location:"querystring" locationName:"nextToken" type:"string"`

	// The identifier for the resource that you want to list zonal shifts for. The
	// identifier is the Amazon Resource Name (ARN) for the resource.
	ResourceIdentifier *string `location:"querystring" locationName:"resourceIdentifier" min:"8" type:"string"`

	// A status for a zonal shift.
	//
	// The Status for a zonal shift can have one of the following values:
	//
	//    * ACTIVE: The zonal shift has been started and active.
	//
	//    * EXPIRED: The zonal shift has expired (the expiry time was exceeded).
	//
	//    * CANCELED: The zonal shift was canceled.
	Status *string `location:"querystring" locationName:"status" type:"string" enum:"ZonalShiftStatus"`
	// contains filtered or unexported fields
}

func (ListZonalShiftsInput) GoString

func (s ListZonalShiftsInput) 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 (*ListZonalShiftsInput) SetMaxResults

func (s *ListZonalShiftsInput) SetMaxResults(v int64) *ListZonalShiftsInput

SetMaxResults sets the MaxResults field's value.

func (*ListZonalShiftsInput) SetNextToken

func (s *ListZonalShiftsInput) SetNextToken(v string) *ListZonalShiftsInput

SetNextToken sets the NextToken field's value.

func (*ListZonalShiftsInput) SetResourceIdentifier added in v1.48.10

func (s *ListZonalShiftsInput) SetResourceIdentifier(v string) *ListZonalShiftsInput

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*ListZonalShiftsInput) SetStatus

SetStatus sets the Status field's value.

func (ListZonalShiftsInput) String

func (s ListZonalShiftsInput) 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 (*ListZonalShiftsInput) Validate

func (s *ListZonalShiftsInput) Validate() error

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

type ListZonalShiftsOutput

type ListZonalShiftsOutput struct {

	// The items in the response list.
	Items []*ZonalShiftSummary `locationName:"items" type:"list"`

	// Specifies that you want to receive the next page of results. Valid only if
	// you received a NextToken response in the previous request. If you did, it
	// indicates that more output is available. Set this parameter to the value
	// provided by the previous call's NextToken response to request the next page
	// of results.
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (ListZonalShiftsOutput) GoString

func (s ListZonalShiftsOutput) 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 (*ListZonalShiftsOutput) SetItems

SetItems sets the Items field's value.

func (*ListZonalShiftsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (ListZonalShiftsOutput) String

func (s ListZonalShiftsOutput) 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 ManagedResourceSummary

type ManagedResourceSummary struct {

	// A collection of key-value pairs that indicate whether resources are active
	// in Availability Zones or not. The key name is the Availability Zone where
	// the resource is deployed. The value is 1 or 0.
	AppliedWeights map[string]*float64 `locationName:"appliedWeights" type:"map"`

	// The Amazon Resource Name (ARN) for the managed resource.
	Arn *string `locationName:"arn" min:"8" type:"string"`

	// An array of the autoshifts that have been completed for a resource.
	Autoshifts []*AutoshiftInResource `locationName:"autoshifts" type:"list"`

	// The Availability Zones that a resource is deployed in.
	//
	// AvailabilityZones is a required field
	AvailabilityZones []*string `locationName:"availabilityZones" type:"list" required:"true"`

	// The name of the managed resource.
	Name *string `locationName:"name" min:"1" type:"string"`

	// This status tracks whether a practice run configuration exists for a resource.
	// When you configure a practice run for a resource so that a practice run configuration
	// exists, Route 53 ARC sets this value to ENABLED. If a you have not configured
	// a practice run for the resource, or delete a practice run configuration,
	// Route 53 ARC sets the value to DISABLED.
	//
	// Route 53 ARC updates this status; you can't set a practice run status to
	// ENABLED or DISABLED.
	PracticeRunStatus *string `locationName:"practiceRunStatus" type:"string" enum:"ZonalAutoshiftStatus"`

	// The status of autoshift for a resource. When you configure zonal autoshift
	// for a resource, you can set the value of the status to ENABLED or DISABLED.
	ZonalAutoshiftStatus *string `locationName:"zonalAutoshiftStatus" type:"string" enum:"ZonalAutoshiftStatus"`

	// An array of the zonal shifts for a resource.
	ZonalShifts []*ZonalShiftInResource `locationName:"zonalShifts" type:"list"`
	// contains filtered or unexported fields
}

A complex structure for a managed resource in an Amazon Web Services account with information about zonal shifts and autoshifts.

A managed resource is a load balancer that has been registered with Route 53 ARC by Elastic Load Balancing. You can start a zonal shift in Route 53 ARC for a managed resource to temporarily move traffic for the resource away from an Availability Zone in an Amazon Web Services Region. You can also configure zonal autoshift for a managed resource.

At this time, managed resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.

func (ManagedResourceSummary) GoString

func (s ManagedResourceSummary) 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 (*ManagedResourceSummary) SetAppliedWeights added in v1.48.10

func (s *ManagedResourceSummary) SetAppliedWeights(v map[string]*float64) *ManagedResourceSummary

SetAppliedWeights sets the AppliedWeights field's value.

func (*ManagedResourceSummary) SetArn

SetArn sets the Arn field's value.

func (*ManagedResourceSummary) SetAutoshifts added in v1.48.10

SetAutoshifts sets the Autoshifts field's value.

func (*ManagedResourceSummary) SetAvailabilityZones

func (s *ManagedResourceSummary) SetAvailabilityZones(v []*string) *ManagedResourceSummary

SetAvailabilityZones sets the AvailabilityZones field's value.

func (*ManagedResourceSummary) SetName

SetName sets the Name field's value.

func (*ManagedResourceSummary) SetPracticeRunStatus added in v1.48.10

func (s *ManagedResourceSummary) SetPracticeRunStatus(v string) *ManagedResourceSummary

SetPracticeRunStatus sets the PracticeRunStatus field's value.

func (*ManagedResourceSummary) SetZonalAutoshiftStatus added in v1.48.10

func (s *ManagedResourceSummary) SetZonalAutoshiftStatus(v string) *ManagedResourceSummary

SetZonalAutoshiftStatus sets the ZonalAutoshiftStatus field's value.

func (*ManagedResourceSummary) SetZonalShifts added in v1.48.10

SetZonalShifts sets the ZonalShifts field's value.

func (ManagedResourceSummary) String

func (s ManagedResourceSummary) 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 PracticeRunConfiguration added in v1.48.10

type PracticeRunConfiguration struct {

	// An array of one or more dates that you can specify when Amazon Web Services
	// does not start practice runs for a resource.
	//
	// Specify blocked dates, in UTC, in the format YYYY-MM-DD, separated by spaces.
	BlockedDates []*string `locationName:"blockedDates" type:"list"`

	// An array of one or more windows of days and times that you can block Route
	// 53 ARC from starting practice runs for a resource.
	//
	// Specify the blocked windows in UTC, using the format DAY:HH:MM-DAY:HH:MM,
	// separated by spaces. For example, MON:18:30-MON:19:30 TUE:18:30-TUE:19:30.
	BlockedWindows []*string `locationName:"blockedWindows" type:"list"`

	// The blocking alarm for practice runs is an optional alarm that you can specify
	// that blocks practice runs when the alarm is in an ALARM state.
	BlockingAlarms []*ControlCondition `locationName:"blockingAlarms" min:"1" type:"list"`

	// The outcome alarm for practice runs is an alarm that you specify that ends
	// a practice run when the alarm is in an ALARM state.
	//
	// OutcomeAlarms is a required field
	OutcomeAlarms []*ControlCondition `locationName:"outcomeAlarms" min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run.

You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.

func (PracticeRunConfiguration) GoString added in v1.48.10

func (s PracticeRunConfiguration) 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 (*PracticeRunConfiguration) SetBlockedDates added in v1.48.10

func (s *PracticeRunConfiguration) SetBlockedDates(v []*string) *PracticeRunConfiguration

SetBlockedDates sets the BlockedDates field's value.

func (*PracticeRunConfiguration) SetBlockedWindows added in v1.48.10

func (s *PracticeRunConfiguration) SetBlockedWindows(v []*string) *PracticeRunConfiguration

SetBlockedWindows sets the BlockedWindows field's value.

func (*PracticeRunConfiguration) SetBlockingAlarms added in v1.48.10

SetBlockingAlarms sets the BlockingAlarms field's value.

func (*PracticeRunConfiguration) SetOutcomeAlarms added in v1.48.10

SetOutcomeAlarms sets the OutcomeAlarms field's value.

func (PracticeRunConfiguration) String added in v1.48.10

func (s PracticeRunConfiguration) 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"`
	// contains filtered or unexported fields
}

The input requested a resource that was not found.

func (*ResourceNotFoundException) Code

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 StartZonalShiftInput

type StartZonalShiftInput struct {

	// The Availability Zone that traffic is moved away from for a resource when
	// you start a zonal shift. Until the zonal shift expires or you cancel it,
	// traffic for the resource is instead moved to other Availability Zones in
	// the Amazon Web Services Region.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// A comment that you enter about the zonal shift. Only the latest comment is
	// retained; no comment history is maintained. A new comment overwrites any
	// existing comment string.
	//
	// Comment is a required field
	Comment *string `locationName:"comment" type:"string" required:"true"`

	// The length of time that you want a zonal shift to be active, which Route
	// 53 ARC converts to an expiry time (expiration time). Zonal shifts are temporary.
	// You can set a zonal shift to be active initially for up to three days (72
	// hours).
	//
	// If you want to still keep traffic away from an Availability Zone, you can
	// update the zonal shift and set a new expiration. You can also cancel a zonal
	// shift, before it expires, for example, if you're ready to restore traffic
	// to the Availability Zone.
	//
	// To set a length of time for a zonal shift to be active, specify a whole number,
	// and then one of the following, with no space:
	//
	//    * A lowercase letter m: To specify that the value is in minutes.
	//
	//    * A lowercase letter h: To specify that the value is in hours.
	//
	// For example: 20h means the zonal shift expires in 20 hours. 120m means the
	// zonal shift expires in 120 minutes (2 hours).
	//
	// ExpiresIn is a required field
	ExpiresIn *string `locationName:"expiresIn" min:"2" type:"string" required:"true"`

	// The identifier for the resource to shift away traffic for. The identifier
	// is the Amazon Resource Name (ARN) for the resource.
	//
	// At this time, supported resources are Network Load Balancers and Application
	// Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (StartZonalShiftInput) GoString

func (s StartZonalShiftInput) 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 (*StartZonalShiftInput) SetAwayFrom

SetAwayFrom sets the AwayFrom field's value.

func (*StartZonalShiftInput) SetComment

SetComment sets the Comment field's value.

func (*StartZonalShiftInput) SetExpiresIn

func (s *StartZonalShiftInput) SetExpiresIn(v string) *StartZonalShiftInput

SetExpiresIn sets the ExpiresIn field's value.

func (*StartZonalShiftInput) SetResourceIdentifier

func (s *StartZonalShiftInput) SetResourceIdentifier(v string) *StartZonalShiftInput

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (StartZonalShiftInput) String

func (s StartZonalShiftInput) 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 (*StartZonalShiftInput) Validate

func (s *StartZonalShiftInput) Validate() error

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

type StartZonalShiftOutput

type StartZonalShiftOutput struct {

	// The Availability Zone that traffic is moved away from for a resource when
	// you start a zonal shift. Until the zonal shift expires or you cancel it,
	// traffic for the resource is instead moved to other Availability Zones in
	// the Amazon Web Services Region.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// A comment that you enter about the zonal shift. Only the latest comment is
	// retained; no comment history is maintained. A new comment overwrites any
	// existing comment string.
	//
	// Comment is a required field
	Comment *string `locationName:"comment" type:"string" required:"true"`

	// The expiry time (expiration time) for a customer-started zonal shift. A zonal
	// shift is temporary and must be set to expire when you start the zonal shift.
	// You can initially set a zonal shift to expire in a maximum of three days
	// (72 hours). However, you can update a zonal shift to set a new expiration
	// at any time.
	//
	// When you start a zonal shift, you specify how long you want it to be active,
	// which Route 53 ARC converts to an expiry time (expiration time). You can
	// cancel a zonal shift when you're ready to restore traffic to the Availability
	// Zone, or just wait for it to expire. Or you can update the zonal shift to
	// specify another length of time to expire in.
	//
	// ExpiryTime is a required field
	ExpiryTime *time.Time `locationName:"expiryTime" type:"timestamp" required:"true"`

	// The identifier for the resource to shift away traffic for. The identifier
	// is the Amazon Resource Name (ARN) for the resource.
	//
	// At this time, supported resources are Network Load Balancers and Application
	// Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`

	// The time (UTC) when the zonal shift starts.
	//
	// StartTime is a required field
	StartTime *time.Time `locationName:"startTime" type:"timestamp" required:"true"`

	// A status for a zonal shift.
	//
	// The Status for a zonal shift can have one of the following values:
	//
	//    * ACTIVE: The zonal shift has been started and active.
	//
	//    * EXPIRED: The zonal shift has expired (the expiry time was exceeded).
	//
	//    * CANCELED: The zonal shift was canceled.
	//
	// Status is a required field
	Status *string `locationName:"status" type:"string" required:"true" enum:"ZonalShiftStatus"`

	// The identifier of a zonal shift.
	//
	// ZonalShiftId is a required field
	ZonalShiftId *string `locationName:"zonalShiftId" min:"6" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (StartZonalShiftOutput) GoString

func (s StartZonalShiftOutput) 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 (*StartZonalShiftOutput) SetAwayFrom

SetAwayFrom sets the AwayFrom field's value.

func (*StartZonalShiftOutput) SetComment

SetComment sets the Comment field's value.

func (*StartZonalShiftOutput) SetExpiryTime

SetExpiryTime sets the ExpiryTime field's value.

func (*StartZonalShiftOutput) SetResourceIdentifier

func (s *StartZonalShiftOutput) SetResourceIdentifier(v string) *StartZonalShiftOutput

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*StartZonalShiftOutput) SetStartTime

SetStartTime sets the StartTime field's value.

func (*StartZonalShiftOutput) SetStatus

SetStatus sets the Status field's value.

func (*StartZonalShiftOutput) SetZonalShiftId

func (s *StartZonalShiftOutput) SetZonalShiftId(v string) *StartZonalShiftOutput

SetZonalShiftId sets the ZonalShiftId field's value.

func (StartZonalShiftOutput) String

func (s StartZonalShiftOutput) 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 ThrottlingException

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

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

The request was denied due to 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 UpdatePracticeRunConfigurationInput added in v1.48.10

type UpdatePracticeRunConfigurationInput struct {

	// Add, change, or remove blocked dates for a practice run in zonal autoshift.
	//
	// Optionally, you can block practice runs for specific calendar dates. The
	// format for blocked dates is: YYYY-MM-DD. Keep in mind, when you specify dates,
	// that dates and times for practice runs are in UTC. Separate multiple blocked
	// dates with spaces.
	//
	// For example, if you have an application update scheduled to launch on May
	// 1, 2024, and you don't want practice runs to shift traffic away at that time,
	// you could set a blocked date for 2024-05-01.
	BlockedDates []*string `locationName:"blockedDates" type:"list"`

	// Add, change, or remove windows of days and times for when you can, optionally,
	// block Route 53 ARC from starting a practice run for a resource.
	//
	// The format for blocked windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind, when
	// you specify dates, that dates and times for practice runs are in UTC. Also,
	// be aware of potential time adjustments that might be required for daylight
	// saving time differences. Separate multiple blocked windows with spaces.
	//
	// For example, say you run business report summaries three days a week. For
	// this scenario, you might set the following recurring days and times as blocked
	// windows, for example: MON-20:30-21:30 WED-20:30-21:30 FRI-20:30-21:30.
	BlockedWindows []*string `locationName:"blockedWindows" type:"list"`

	// Add, change, or remove the Amazon CloudWatch alarm that you optionally specify
	// as the blocking alarm for practice runs.
	BlockingAlarms []*ControlCondition `locationName:"blockingAlarms" min:"1" type:"list"`

	// Specify a new the Amazon CloudWatch alarm as the outcome alarm for practice
	// runs.
	OutcomeAlarms []*ControlCondition `locationName:"outcomeAlarms" min:"1" type:"list"`

	// The identifier for the resource that you want to update the practice run
	// configuration for. The identifier is the Amazon Resource Name (ARN) for the
	// resource.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `location:"uri" locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (UpdatePracticeRunConfigurationInput) GoString added in v1.48.10

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 (*UpdatePracticeRunConfigurationInput) SetBlockedDates added in v1.48.10

SetBlockedDates sets the BlockedDates field's value.

func (*UpdatePracticeRunConfigurationInput) SetBlockedWindows added in v1.48.10

SetBlockedWindows sets the BlockedWindows field's value.

func (*UpdatePracticeRunConfigurationInput) SetBlockingAlarms added in v1.48.10

SetBlockingAlarms sets the BlockingAlarms field's value.

func (*UpdatePracticeRunConfigurationInput) SetOutcomeAlarms added in v1.48.10

SetOutcomeAlarms sets the OutcomeAlarms field's value.

func (*UpdatePracticeRunConfigurationInput) SetResourceIdentifier added in v1.48.10

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (UpdatePracticeRunConfigurationInput) String added in v1.48.10

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 (*UpdatePracticeRunConfigurationInput) Validate added in v1.48.10

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

type UpdatePracticeRunConfigurationOutput added in v1.48.10

type UpdatePracticeRunConfigurationOutput struct {

	// The Amazon Resource Name (ARN) of the resource that you updated the practice
	// run for.
	//
	// Arn is a required field
	Arn *string `locationName:"arn" min:"8" type:"string" required:"true"`

	// The name of the resource that you updated the practice run for.
	//
	// Name is a required field
	Name *string `locationName:"name" min:"1" type:"string" required:"true"`

	// The practice run configuration that was updated.
	//
	// PracticeRunConfiguration is a required field
	PracticeRunConfiguration *PracticeRunConfiguration `locationName:"practiceRunConfiguration" type:"structure" required:"true"`

	// The zonal autoshift status for the resource that you updated the practice
	// run for.
	//
	// ZonalAutoshiftStatus is a required field
	ZonalAutoshiftStatus *string `locationName:"zonalAutoshiftStatus" type:"string" required:"true" enum:"ZonalAutoshiftStatus"`
	// contains filtered or unexported fields
}

func (UpdatePracticeRunConfigurationOutput) GoString added in v1.48.10

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 (*UpdatePracticeRunConfigurationOutput) SetArn added in v1.48.10

SetArn sets the Arn field's value.

func (*UpdatePracticeRunConfigurationOutput) SetName added in v1.48.10

SetName sets the Name field's value.

func (*UpdatePracticeRunConfigurationOutput) SetPracticeRunConfiguration added in v1.48.10

SetPracticeRunConfiguration sets the PracticeRunConfiguration field's value.

func (*UpdatePracticeRunConfigurationOutput) SetZonalAutoshiftStatus added in v1.48.10

SetZonalAutoshiftStatus sets the ZonalAutoshiftStatus field's value.

func (UpdatePracticeRunConfigurationOutput) String added in v1.48.10

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 UpdateZonalAutoshiftConfigurationInput added in v1.48.10

type UpdateZonalAutoshiftConfigurationInput struct {

	// The identifier for the resource that you want to update the zonal autoshift
	// configuration for. The identifier is the Amazon Resource Name (ARN) for the
	// resource.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `location:"uri" locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`

	// The zonal autoshift status for the resource that you want to update the zonal
	// autoshift configuration for.
	//
	// ZonalAutoshiftStatus is a required field
	ZonalAutoshiftStatus *string `locationName:"zonalAutoshiftStatus" type:"string" required:"true" enum:"ZonalAutoshiftStatus"`
	// contains filtered or unexported fields
}

func (UpdateZonalAutoshiftConfigurationInput) GoString added in v1.48.10

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 (*UpdateZonalAutoshiftConfigurationInput) SetResourceIdentifier added in v1.48.10

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*UpdateZonalAutoshiftConfigurationInput) SetZonalAutoshiftStatus added in v1.48.10

SetZonalAutoshiftStatus sets the ZonalAutoshiftStatus field's value.

func (UpdateZonalAutoshiftConfigurationInput) String added in v1.48.10

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 (*UpdateZonalAutoshiftConfigurationInput) Validate added in v1.48.10

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

type UpdateZonalAutoshiftConfigurationOutput added in v1.48.10

type UpdateZonalAutoshiftConfigurationOutput struct {

	// The identifier for the resource that you updated the zonal autoshift configuration
	// for. The identifier is the Amazon Resource Name (ARN) for the resource.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`

	// The zonal autoshift status for the resource that you updated the zonal autoshift
	// configuration for.
	//
	// ZonalAutoshiftStatus is a required field
	ZonalAutoshiftStatus *string `locationName:"zonalAutoshiftStatus" type:"string" required:"true" enum:"ZonalAutoshiftStatus"`
	// contains filtered or unexported fields
}

func (UpdateZonalAutoshiftConfigurationOutput) GoString added in v1.48.10

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 (*UpdateZonalAutoshiftConfigurationOutput) SetResourceIdentifier added in v1.48.10

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*UpdateZonalAutoshiftConfigurationOutput) SetZonalAutoshiftStatus added in v1.48.10

SetZonalAutoshiftStatus sets the ZonalAutoshiftStatus field's value.

func (UpdateZonalAutoshiftConfigurationOutput) String added in v1.48.10

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 UpdateZonalShiftInput

type UpdateZonalShiftInput struct {

	// A comment that you enter about the zonal shift. Only the latest comment is
	// retained; no comment history is maintained. A new comment overwrites any
	// existing comment string.
	Comment *string `locationName:"comment" type:"string"`

	// The length of time that you want a zonal shift to be active, which Route
	// 53 ARC converts to an expiry time (expiration time). Zonal shifts are temporary.
	// You can set a zonal shift to be active initially for up to three days (72
	// hours).
	//
	// If you want to still keep traffic away from an Availability Zone, you can
	// update the zonal shift and set a new expiration. You can also cancel a zonal
	// shift, before it expires, for example, if you're ready to restore traffic
	// to the Availability Zone.
	//
	// To set a length of time for a zonal shift to be active, specify a whole number,
	// and then one of the following, with no space:
	//
	//    * A lowercase letter m: To specify that the value is in minutes.
	//
	//    * A lowercase letter h: To specify that the value is in hours.
	//
	// For example: 20h means the zonal shift expires in 20 hours. 120m means the
	// zonal shift expires in 120 minutes (2 hours).
	ExpiresIn *string `locationName:"expiresIn" min:"2" type:"string"`

	// The identifier of a zonal shift.
	//
	// ZonalShiftId is a required field
	ZonalShiftId *string `location:"uri" locationName:"zonalShiftId" min:"6" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (UpdateZonalShiftInput) GoString

func (s UpdateZonalShiftInput) 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 (*UpdateZonalShiftInput) SetComment

SetComment sets the Comment field's value.

func (*UpdateZonalShiftInput) SetExpiresIn

SetExpiresIn sets the ExpiresIn field's value.

func (*UpdateZonalShiftInput) SetZonalShiftId

func (s *UpdateZonalShiftInput) SetZonalShiftId(v string) *UpdateZonalShiftInput

SetZonalShiftId sets the ZonalShiftId field's value.

func (UpdateZonalShiftInput) String

func (s UpdateZonalShiftInput) 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 (*UpdateZonalShiftInput) Validate

func (s *UpdateZonalShiftInput) Validate() error

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

type UpdateZonalShiftOutput

type UpdateZonalShiftOutput struct {

	// The Availability Zone that traffic is moved away from for a resource when
	// you start a zonal shift. Until the zonal shift expires or you cancel it,
	// traffic for the resource is instead moved to other Availability Zones in
	// the Amazon Web Services Region.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// A comment that you enter about the zonal shift. Only the latest comment is
	// retained; no comment history is maintained. A new comment overwrites any
	// existing comment string.
	//
	// Comment is a required field
	Comment *string `locationName:"comment" type:"string" required:"true"`

	// The expiry time (expiration time) for a customer-started zonal shift. A zonal
	// shift is temporary and must be set to expire when you start the zonal shift.
	// You can initially set a zonal shift to expire in a maximum of three days
	// (72 hours). However, you can update a zonal shift to set a new expiration
	// at any time.
	//
	// When you start a zonal shift, you specify how long you want it to be active,
	// which Route 53 ARC converts to an expiry time (expiration time). You can
	// cancel a zonal shift when you're ready to restore traffic to the Availability
	// Zone, or just wait for it to expire. Or you can update the zonal shift to
	// specify another length of time to expire in.
	//
	// ExpiryTime is a required field
	ExpiryTime *time.Time `locationName:"expiryTime" type:"timestamp" required:"true"`

	// The identifier for the resource to shift away traffic for. The identifier
	// is the Amazon Resource Name (ARN) for the resource.
	//
	// At this time, supported resources are Network Load Balancers and Application
	// Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`

	// The time (UTC) when the zonal shift starts.
	//
	// StartTime is a required field
	StartTime *time.Time `locationName:"startTime" type:"timestamp" required:"true"`

	// A status for a zonal shift.
	//
	// The Status for a zonal shift can have one of the following values:
	//
	//    * ACTIVE: The zonal shift has been started and active.
	//
	//    * EXPIRED: The zonal shift has expired (the expiry time was exceeded).
	//
	//    * CANCELED: The zonal shift was canceled.
	//
	// Status is a required field
	Status *string `locationName:"status" type:"string" required:"true" enum:"ZonalShiftStatus"`

	// The identifier of a zonal shift.
	//
	// ZonalShiftId is a required field
	ZonalShiftId *string `locationName:"zonalShiftId" min:"6" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (UpdateZonalShiftOutput) GoString

func (s UpdateZonalShiftOutput) 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 (*UpdateZonalShiftOutput) SetAwayFrom

SetAwayFrom sets the AwayFrom field's value.

func (*UpdateZonalShiftOutput) SetComment

SetComment sets the Comment field's value.

func (*UpdateZonalShiftOutput) SetExpiryTime

SetExpiryTime sets the ExpiryTime field's value.

func (*UpdateZonalShiftOutput) SetResourceIdentifier

func (s *UpdateZonalShiftOutput) SetResourceIdentifier(v string) *UpdateZonalShiftOutput

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*UpdateZonalShiftOutput) SetStartTime

SetStartTime sets the StartTime field's value.

func (*UpdateZonalShiftOutput) SetStatus

SetStatus sets the Status field's value.

func (*UpdateZonalShiftOutput) SetZonalShiftId

func (s *UpdateZonalShiftOutput) SetZonalShiftId(v string) *UpdateZonalShiftOutput

SetZonalShiftId sets the ZonalShiftId field's value.

func (UpdateZonalShiftOutput) String

func (s UpdateZonalShiftOutput) 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:"-"`

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

	// The reason for the validation exception.
	//
	// Reason is a required field
	Reason *string `locationName:"reason" type:"string" required:"true" enum:"ValidationExceptionReason"`
	// contains filtered or unexported fields
}

The input fails to satisfy the constraints specified by an Amazon Web Services service.

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 ZonalShiftInResource

type ZonalShiftInResource struct {

	// The appliedStatus field specifies which application traffic shift is in effect
	// for a resource when there is more than one traffic shift active. There can
	// be more than one application traffic shift in progress at the same time -
	// that is, practice run zonal shifts, customer-started zonal shifts, or an
	// autoshift. The appliedStatus field for an autoshift for a resource can have
	// one of two values: APPLIED or NOT_APPLIED. The zonal shift or autoshift that
	// is currently in effect for the resource has an applied status set to APPLIED.
	//
	// The overall principle for precedence is that zonal shifts that you start
	// as a customer take precedence autoshifts, which take precedence over practice
	// runs. That is, customer-started zonal shifts > autoshifts > practice run
	// zonal shifts.
	//
	// For more information, see How zonal autoshift and practice runs work (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.how-it-works.html)
	// in the Amazon Route 53 Application Recovery Controller Developer Guide.
	//
	// AppliedStatus is a required field
	AppliedStatus *string `locationName:"appliedStatus" type:"string" required:"true" enum:"AppliedStatus"`

	// The Availability Zone that traffic is moved away from for a resource when
	// you start a zonal shift. Until the zonal shift expires or you cancel it,
	// traffic for the resource is instead moved to other Availability Zones in
	// the Amazon Web Services Region.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// A comment that you enter about the zonal shift. Only the latest comment is
	// retained; no comment history is maintained. That is, a new comment overwrites
	// any existing comment string.
	//
	// Comment is a required field
	Comment *string `locationName:"comment" type:"string" required:"true"`

	// The expiry time (expiration time) for a customer-started zonal shift. A zonal
	// shift is temporary and must be set to expire when you start the zonal shift.
	// You can initially set a zonal shift to expire in a maximum of three days
	// (72 hours). However, you can update a zonal shift to set a new expiration
	// at any time.
	//
	// When you start a zonal shift, you specify how long you want it to be active,
	// which Route 53 ARC converts to an expiry time (expiration time). You can
	// cancel a zonal shift when you're ready to restore traffic to the Availability
	// Zone, or just wait for it to expire. Or you can update the zonal shift to
	// specify another length of time to expire in.
	//
	// ExpiryTime is a required field
	ExpiryTime *time.Time `locationName:"expiryTime" type:"timestamp" required:"true"`

	// The outcome, or end state, returned for a practice run. The following values
	// can be returned:
	//
	//    * PENDING: Outcome value when a practice run is in progress.
	//
	//    * SUCCEEDED: Outcome value when the outcome alarm specified for the practice
	//    run configuration does not go into an ALARM state during the practice
	//    run, and the practice run was not interrupted before it completed the
	//    expected 30 minute zonal shift.
	//
	//    * INTERRUPTED: Outcome value when the practice run was stopped before
	//    the expected 30 minute zonal shift duration, or there was another problem
	//    with the practice run that created an inconclusive outcome.
	//
	//    * FAILED: Outcome value when the outcome alarm specified for the practice
	//    run configuration goes into an ALARM state during the practice run, and
	//    the practice run was not interrupted before it completed.
	//
	// For more information about practice run outcomes, see Considerations when
	// you configure zonal autoshift (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.configure.html)
	// in the Amazon Route 53 Application Recovery Controller Developer Guide.
	PracticeRunOutcome *string `locationName:"practiceRunOutcome" type:"string" enum:"PracticeRunOutcome"`

	// The identifier for the resource to include in a zonal shift. The identifier
	// is the Amazon Resource Name (ARN) for the resource.
	//
	// At this time, you can only start a zonal shift for Network Load Balancers
	// and Application Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`

	// The time (UTC) when the zonal shift starts.
	//
	// StartTime is a required field
	StartTime *time.Time `locationName:"startTime" type:"timestamp" required:"true"`

	// The identifier of a zonal shift.
	//
	// ZonalShiftId is a required field
	ZonalShiftId *string `locationName:"zonalShiftId" min:"6" type:"string" required:"true"`
	// contains filtered or unexported fields
}

A complex structure that lists the zonal shifts for a managed resource and their statuses for the resource.

func (ZonalShiftInResource) GoString

func (s ZonalShiftInResource) 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 (*ZonalShiftInResource) SetAppliedStatus

func (s *ZonalShiftInResource) SetAppliedStatus(v string) *ZonalShiftInResource

SetAppliedStatus sets the AppliedStatus field's value.

func (*ZonalShiftInResource) SetAwayFrom

SetAwayFrom sets the AwayFrom field's value.

func (*ZonalShiftInResource) SetComment

SetComment sets the Comment field's value.

func (*ZonalShiftInResource) SetExpiryTime

func (s *ZonalShiftInResource) SetExpiryTime(v time.Time) *ZonalShiftInResource

SetExpiryTime sets the ExpiryTime field's value.

func (*ZonalShiftInResource) SetPracticeRunOutcome added in v1.48.10

func (s *ZonalShiftInResource) SetPracticeRunOutcome(v string) *ZonalShiftInResource

SetPracticeRunOutcome sets the PracticeRunOutcome field's value.

func (*ZonalShiftInResource) SetResourceIdentifier

func (s *ZonalShiftInResource) SetResourceIdentifier(v string) *ZonalShiftInResource

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*ZonalShiftInResource) SetStartTime

func (s *ZonalShiftInResource) SetStartTime(v time.Time) *ZonalShiftInResource

SetStartTime sets the StartTime field's value.

func (*ZonalShiftInResource) SetZonalShiftId

func (s *ZonalShiftInResource) SetZonalShiftId(v string) *ZonalShiftInResource

SetZonalShiftId sets the ZonalShiftId field's value.

func (ZonalShiftInResource) String

func (s ZonalShiftInResource) 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 ZonalShiftSummary

type ZonalShiftSummary struct {

	// The Availability Zone that traffic is moved away from for a resource when
	// you start a zonal shift. Until the zonal shift expires or you cancel it,
	// traffic for the resource is instead moved to other Availability Zones in
	// the Amazon Web Services Region.
	//
	// AwayFrom is a required field
	AwayFrom *string `locationName:"awayFrom" type:"string" required:"true"`

	// A comment that you enter about the zonal shift. Only the latest comment is
	// retained; no comment history is maintained. That is, a new comment overwrites
	// any existing comment string.
	//
	// Comment is a required field
	Comment *string `locationName:"comment" type:"string" required:"true"`

	// The expiry time (expiration time) for a customer-started zonal shift. A zonal
	// shift is temporary and must be set to expire when you start the zonal shift.
	// You can initially set a zonal shift to expire in a maximum of three days
	// (72 hours). However, you can update a zonal shift to set a new expiration
	// at any time.
	//
	// When you start a zonal shift, you specify how long you want it to be active,
	// which Route 53 ARC converts to an expiry time (expiration time). You can
	// cancel a zonal shift when you're ready to restore traffic to the Availability
	// Zone, or just wait for it to expire. Or you can update the zonal shift to
	// specify another length of time to expire in.
	//
	// ExpiryTime is a required field
	ExpiryTime *time.Time `locationName:"expiryTime" type:"timestamp" required:"true"`

	// The outcome, or end state, of a practice run. The following values can be
	// returned:
	//
	//    * PENDING: Outcome value when the practice run is in progress.
	//
	//    * SUCCEEDED: Outcome value when the outcome alarm specified for the practice
	//    run configuration does not go into an ALARM state during the practice
	//    run, and the practice run was not interrupted before it completed.
	//
	//    * INTERRUPTED: Outcome value when the practice run did not run for the
	//    expected 30 minutes or there was another problem with the practice run
	//    that created an inconclusive outcome.
	//
	//    * FAILED: Outcome value when the outcome alarm specified for the practice
	//    run configuration goes into an ALARM state during the practice run, and
	//    the practice run was not interrupted before it completed.
	//
	// For more information about practice run outcomes, see Considerations when
	// you configure zonal autoshift (https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.configure.html)
	// in the Amazon Route 53 Application Recovery Controller Developer Guide.
	PracticeRunOutcome *string `locationName:"practiceRunOutcome" type:"string" enum:"PracticeRunOutcome"`

	// The identifier for the resource to include in a zonal shift. The identifier
	// is the Amazon Resource Name (ARN) for the resource.
	//
	// At this time, you can only start a zonal shift for Network Load Balancers
	// and Application Load Balancers with cross-zone load balancing turned off.
	//
	// ResourceIdentifier is a required field
	ResourceIdentifier *string `locationName:"resourceIdentifier" min:"8" type:"string" required:"true"`

	// The time (UTC) when the zonal shift starts.
	//
	// StartTime is a required field
	StartTime *time.Time `locationName:"startTime" type:"timestamp" required:"true"`

	// A status for a zonal shift.
	//
	// The Status for a zonal shift can have one of the following values:
	//
	//    * ACTIVE: The zonal shift has been started and active.
	//
	//    * EXPIRED: The zonal shift has expired (the expiry time was exceeded).
	//
	//    * CANCELED: The zonal shift was canceled.
	//
	// Status is a required field
	Status *string `locationName:"status" type:"string" required:"true" enum:"ZonalShiftStatus"`

	// The identifier of a zonal shift.
	//
	// ZonalShiftId is a required field
	ZonalShiftId *string `locationName:"zonalShiftId" min:"6" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Lists information about zonal shifts in Amazon Route 53 Application Recovery Controller, including zonal shifts that you start yourself and zonal shifts that Route 53 ARC starts on your behalf for practice runs with zonal autoshift.

Zonal shifts are temporary, including customer-started zonal shifts and the zonal autoshift practice run zonal shifts that Route 53 ARC starts weekly, on your behalf. A zonal shift that a customer starts can be active for up to three days (72 hours). A practice run zonal shift has a 30 minute duration.

func (ZonalShiftSummary) GoString

func (s ZonalShiftSummary) 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 (*ZonalShiftSummary) SetAwayFrom

func (s *ZonalShiftSummary) SetAwayFrom(v string) *ZonalShiftSummary

SetAwayFrom sets the AwayFrom field's value.

func (*ZonalShiftSummary) SetComment

func (s *ZonalShiftSummary) SetComment(v string) *ZonalShiftSummary

SetComment sets the Comment field's value.

func (*ZonalShiftSummary) SetExpiryTime

func (s *ZonalShiftSummary) SetExpiryTime(v time.Time) *ZonalShiftSummary

SetExpiryTime sets the ExpiryTime field's value.

func (*ZonalShiftSummary) SetPracticeRunOutcome added in v1.48.10

func (s *ZonalShiftSummary) SetPracticeRunOutcome(v string) *ZonalShiftSummary

SetPracticeRunOutcome sets the PracticeRunOutcome field's value.

func (*ZonalShiftSummary) SetResourceIdentifier

func (s *ZonalShiftSummary) SetResourceIdentifier(v string) *ZonalShiftSummary

SetResourceIdentifier sets the ResourceIdentifier field's value.

func (*ZonalShiftSummary) SetStartTime

func (s *ZonalShiftSummary) SetStartTime(v time.Time) *ZonalShiftSummary

SetStartTime sets the StartTime field's value.

func (*ZonalShiftSummary) SetStatus

func (s *ZonalShiftSummary) SetStatus(v string) *ZonalShiftSummary

SetStatus sets the Status field's value.

func (*ZonalShiftSummary) SetZonalShiftId

func (s *ZonalShiftSummary) SetZonalShiftId(v string) *ZonalShiftSummary

SetZonalShiftId sets the ZonalShiftId field's value.

func (ZonalShiftSummary) String

func (s ZonalShiftSummary) 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".

Directories

Path Synopsis
Package arczonalshiftiface provides an interface to enable mocking the AWS ARC - Zonal Shift service client for testing your code.
Package arczonalshiftiface provides an interface to enable mocking the AWS ARC - Zonal Shift service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL