JavaScript is disabled on your browser.
Skip navigation links

AWS SDK for Java 1.x API Reference - 1.12.793

We announced the upcoming end-of-support for AWS SDK for Java (v1). We recommend that you migrate to AWS SDK for Java v2. For dates, additional details, and information on how to migrate, please refer to the linked announcement.
  • Detail:
  • Field |
  • Constr |
  • Method
com.amazonaws.services.arczonalshift

Class AWSARCZonalShiftClient

  • All Implemented Interfaces:
    AWSARCZonalShift
    Direct Known Subclasses:
    AWSARCZonalShiftAsyncClient 

    @ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AWSARCZonalShiftClient
extends AmazonWebServiceClient
implements AWSARCZonalShift
    Client for accessing AWS ARC - Zonal Shift. All service calls made using this client are blocking, and will not return until the service call completes.

    Welcome to the API Reference Guide for zonal shift and zonal autoshift in 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 supported load balancer resources. Zonal autoshift is a capability in Route 53 ARC where you authorize Amazon Web Services to shift away application resource traffic from an Availability Zone during events, on your behalf, to help reduce your time to recovery. Amazon Web Services starts an autoshift when internal telemetry indicates that there is an Availability Zone impairment that could potentially impact customers.

    To help make sure 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 away from an Availability Zone. Practice runs help you to 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.

    Before you configure practice runs or enable zonal autoshift, we strongly recommend that you prescale your application resource capacity in all Availability Zones in the Region where your application resources are deployed. You should not rely on scaling on demand when an autoshift or practice run starts. Zonal autoshift, including practice runs, works independently, and does not wait for auto scaling actions to complete. Relying on auto scaling, instead of pre-scaling, can result in loss of availability.

    If you use auto scaling to handle regular cycles of traffic, we strongly recommend that you configure the minimum capacity of your auto scaling to continue operating normally with the loss of an Availability Zone.

    Be aware that Route 53 ARC does not inspect the health of individual resources. Amazon Web Services only starts an autoshift when Amazon Web Services telemetry detects that there is an Availability Zone impairment that could potentially impact customers. In some cases, resources might be shifted away that are not experiencing impact.

    For more information about using zonal shift and zonal autoshift, see the Amazon Route 53 Application Recovery Controller Developer Guide.

    • Method Detail

      • cancelZonalShift

        public CancelZonalShiftResult cancelZonalShift(CancelZonalShiftRequest request)

        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.

        Specified by:
        cancelZonalShift in interface AWSARCZonalShift
        Parameters:
        cancelZonalShiftRequest -
        Returns:
        Result of the CancelZonalShift operation returned by the service.
        Throws:
        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:
        AWS API Documentation

      • createPracticeRunConfiguration

        public CreatePracticeRunConfigurationResult createPracticeRunConfiguration(CreatePracticeRunConfigurationRequest request)

        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.

        When a resource has a practice run configuration, Route 53 ARC starts zonal shifts for the resource weekly, to shift traffic for practice runs. Practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application.

        For more information, see Considerations when you configure zonal autoshift in the Amazon Route 53 Application Recovery Controller Developer Guide.

        Specified by:
        createPracticeRunConfiguration in interface AWSARCZonalShift
        Parameters:
        createPracticeRunConfigurationRequest -
        Returns:
        Result of the CreatePracticeRunConfiguration operation returned by the service.
        Throws:
        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:
        AWS API Documentation

      • getManagedResource

        public GetManagedResourceResult getManagedResource(GetManagedResourceRequest request)

        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.

        Specified by:
        getManagedResource in interface AWSARCZonalShift
        Parameters:
        getManagedResourceRequest -
        Returns:
        Result of the GetManagedResource operation returned by the service.
        Throws:
        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:
        AWS API Documentation

      • listManagedResources

        public ListManagedResourcesResult listManagedResources(ListManagedResourcesRequest request)

        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.

        Specified by:
        listManagedResources in interface AWSARCZonalShift
        Parameters:
        listManagedResourcesRequest -
        Returns:
        Result of the ListManagedResources operation returned by the service.
        Throws:
        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:
        AWS API Documentation

      • listZonalShifts

        public ListZonalShiftsResult listZonalShifts(ListZonalShiftsRequest request)

        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-initiated 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.

        Specified by:
        listZonalShifts in interface AWSARCZonalShift
        Parameters:
        listZonalShiftsRequest -
        Returns:
        Result of the ListZonalShifts operation returned by the service.
        Throws:
        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:
        AWS API Documentation

      • startZonalShift

        public StartZonalShiftResult startZonalShift(StartZonalShiftRequest request)

        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 in the Amazon Route 53 Application Recovery Controller Developer Guide.

        Specified by:
        startZonalShift in interface AWSARCZonalShift
        Parameters:
        startZonalShiftRequest -
        Returns:
        Result of the StartZonalShift operation returned by the service.
        Throws:
        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:
        AWS API Documentation

      • updateZonalAutoshiftConfiguration

        public UpdateZonalAutoshiftConfigurationResult updateZonalAutoshiftConfiguration(UpdateZonalAutoshiftConfigurationRequest request)

        The zonal autoshift configuration for a resource includes the practice run configuration and the status for running autoshifts, zonal autoshift status. When a resource has a practice run configuation, Route 53 ARC starts weekly zonal shifts for the resource, to shift traffic away from an Availability Zone. Weekly practice runs help you to make sure that your application can continue to operate normally with the loss of one Availability Zone.

        You can update the zonal autoshift autoshift status to enable or disable zonal autoshift. When zonal autoshift is ENABLED, you authorize Amazon Web Services to shift away resource traffic for an application from an Availability Zone during events, on your behalf, to help reduce time to recovery. Traffic is also shifted away for the required weekly practice runs.

        Specified by:
        updateZonalAutoshiftConfiguration in interface AWSARCZonalShift
        Parameters:
        updateZonalAutoshiftConfigurationRequest -
        Returns:
        Result of the UpdateZonalAutoshiftConfiguration operation returned by the service.
        Throws:
        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:
        AWS API Documentation

      • getCachedResponseMetadata

        public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
        Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

        Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.

        Specified by:
        getCachedResponseMetadata in interface AWSARCZonalShift
        Parameters:
        request - The originally executed request
        Returns:
        The response metadata for the specified request, or null if none is available.

      • shutdown

        public void shutdown()
        Description copied from class: AmazonWebServiceClient
        Shuts down this client object, releasing any resources that might be held open. If this method is not invoked, resources may be leaked. Once a client has been shutdown, it should not be used to make any more requests.
        Specified by:
        shutdown in interface AWSARCZonalShift
        Overrides:
        shutdown in class AmazonWebServiceClient
Skip navigation links
  • Detail:
  • Field |
  • Constr |
  • Method

AltStyle によって変換されたページ (->オリジナル) /