From 2152324b25b1c7cfe9cdde7454c2d3fd0a7b12fd Mon Sep 17 00:00:00 2001
From: awstools This is the API Reference Guide for the zonal shift feature of Amazon Route 53 Application Recovery Controller. This guide is for developers who need detailed information about
-zonal shift API actions, data types, and errors. Zonal shift is in preview release for Amazon Route 53 Application Recovery Controller and is subject to change. Zonal shift in Route 53 ARC enables you to move traffic for a load balancer resource away from an Availability Zone. Starting
-a zonal shift helps your application recover immediately, for example, from a developer's bad code deployment
-or from an AWS infrastructure failure in a single Availability Zone, reducing the impact and time lost from an issue
-in one zone. Supported AWS resources are automatically registered with Route 53 ARC. Resources that are registered for zonal shifts
-in Route 53 ARC are managed resources in Route 53 ARC. You can start a zonal shift for any managed resource in your account in a Region.
-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. Zonal shifts are temporary. You must specify an expiration when you start a zonal shift, of up to three days initially.
-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. For more information about using zonal shift, see the
-Amazon Route 53 Application Recovery Controller Developer Guide. 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. This is the API Reference Guide for the zonal shift feature of Amazon Route 53 Application Recovery Controller. This guide is for developers who need detailed information about
- * zonal shift API actions, data types, and errors. Zonal shift is in preview release for Amazon Route 53 Application Recovery Controller and is subject to change. Zonal shift in Route 53 ARC enables you to move traffic for a load balancer resource away from an Availability Zone. Starting
- * a zonal shift helps your application recover immediately, for example, from a developer's bad code deployment
- * or from an AWS infrastructure failure in a single Availability Zone, reducing the impact and time lost from an issue
- * in one zone. Supported AWS resources are automatically registered with Route 53 ARC. Resources that are registered for zonal shifts
- * in Route 53 ARC are managed resources in Route 53 ARC. You can start a zonal shift for any managed resource in your account in a Region.
- * 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. Zonal shifts are temporary. You must specify an expiration when you start a zonal shift, of up to three days initially.
- * 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. For more information about using zonal shift, see the
- * Amazon Route 53 Application Recovery Controller Developer Guide. 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. This is the API Reference Guide for the zonal shift feature of Amazon Route 53 Application Recovery Controller. This guide is for developers who need detailed information about
- * zonal shift API actions, data types, and errors. Zonal shift is in preview release for Amazon Route 53 Application Recovery Controller and is subject to change. Zonal shift in Route 53 ARC enables you to move traffic for a load balancer resource away from an Availability Zone. Starting
- * a zonal shift helps your application recover immediately, for example, from a developer's bad code deployment
- * or from an AWS infrastructure failure in a single Availability Zone, reducing the impact and time lost from an issue
- * in one zone. Supported AWS resources are automatically registered with Route 53 ARC. Resources that are registered for zonal shifts
- * in Route 53 ARC are managed resources in Route 53 ARC. You can start a zonal shift for any managed resource in your account in a Region.
- * 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. Zonal shifts are temporary. You must specify an expiration when you start a zonal shift, of up to three days initially.
- * 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. For more information about using zonal shift, see the
- * Amazon Route 53 Application Recovery Controller Developer Guide. 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. Cancel a zonal shift in Amazon Route 53 Application Recovery Controller that you've started for a resource in your AWS account in an AWS Region. 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. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an AWS service. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. 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 in the Amazon Route 53 Application Recovery Controller Developer Guide. You do not have sufficient access to perform this action. The request could not be processed because of conflict in the current state of the resource. There was an internal server error. The input requested a resource that was not found. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. 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. You do not have sufficient access to perform this action. The request could not be processed because of conflict in the current state of the resource. There was an internal server error. The input requested a resource that was not found. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. Get information about a resource that's been registered for zonal shifts with Amazon Route 53 Application Recovery Controller in this AWS Region. Resources that are registered for
- * zonal shifts are managed resources in Route 53 ARC. 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. 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. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an AWS service. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. Returns the active autoshifts for a specified resource. You do not have sufficient access to perform this action. There was an internal server error. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. Lists all the resources in your AWS account in this AWS Region that are managed for zonal shifts in Amazon Route 53 Application Recovery Controller, and information
- * about them. The information includes their Amazon Resource Names (ARNs), the Availability Zones the resources are deployed in, and
+ * 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. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an AWS service. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. Lists all the active zonal shifts in Amazon Route 53 Application Recovery Controller in your AWS account in this AWS Region. 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.
+ * The The request was denied due to request throttling. The input fails to satisfy the constraints specified by an AWS service. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. You start a zonal shift to temporarily move load balancer traffic away from an Availability Zone in a AWS Region,
- * to help your application recover immediately, for example, from a developer's bad code deployment or from an AWS
+ * 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 account in an AWS Region. Resources are automatically registered with Route 53 ARC by AWS 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
+ * 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
+ * For more information, see Zonal shift
* in the Amazon Route 53 Application Recovery Controller Developer Guide. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an AWS service. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. 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. You do not have sufficient access to perform this action. The request could not be processed because of conflict in the current state of the resource. There was an internal server error. The input requested a resource that was not found. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. You can update the zonal autoshift status for a resource, to enable or disable zonal
+ * autoshift. When zonal autoshift is You do not have sufficient access to perform this action. The request could not be processed because of conflict in the current state of the resource. There was an internal server error. The input requested a resource that was not found. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. Update an active zonal shift in Amazon Route 53 Application Recovery Controller in your AWS account. You can update a zonal shift to set a new expiration, or
+ * 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. The request was denied due to request throttling. The input fails to satisfy the constraints specified by an AWS service. The input fails to satisfy the constraints specified by an Amazon Web Services service. Base exception class for all service exceptions from ARCZonalShift service. This is the API Reference Guide for the zonal shift feature of Amazon Route 53 Application Recovery Controller. This guide is for developers who need detailed information about
- * zonal shift API actions, data types, and errors. Zonal shift is in preview release for Amazon Route 53 Application Recovery Controller and is subject to change. Zonal shift in Route 53 ARC enables you to move traffic for a load balancer resource away from an Availability Zone. Starting
- * a zonal shift helps your application recover immediately, for example, from a developer's bad code deployment
- * or from an AWS infrastructure failure in a single Availability Zone, reducing the impact and time lost from an issue
- * in one zone. Supported AWS resources are automatically registered with Route 53 ARC. Resources that are registered for zonal shifts
- * in Route 53 ARC are managed resources in Route 53 ARC. You can start a zonal shift for any managed resource in your account in a Region.
- * 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. Zonal shifts are temporary. You must specify an expiration when you start a zonal shift, of up to three days initially.
- * 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. For more information about using zonal shift, see the
- * Amazon Route 53 Application Recovery Controller Developer Guide. 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. There was an internal server error. The internally-generated identifier of a zonal shift. The request could not be processed because of conflict in the current state of the resource. The reason for the conflict exception. Specifies that you want to receive the next page of results. Valid only if you received a The zonal shift ID associated with the conflict exception. The status of the autoshift. The number of objects that you want to return with this call. There was an internal server error. 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. 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. The time (in UTC) when the autoshift ended. The time (in UTC) when the autoshift started. The status for an autoshift. The input requested a resource that was not found. The items in the response list. Specifies that you want to receive the next page of results. Valid only if you received a The input fails to satisfy the constraints specified by an AWS service. The input fails to satisfy the constraints specified by an Amazon Web Services service. 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 in the Amazon Route 53 Application Recovery Controller Developer Guide. The 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 in the Amazon Route 53 Application Recovery Controller Developer Guide. 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. The time (UTC) when the autoshift started. The internally-generated identifier of a zonal shift. The request could not be processed because of conflict in the current state of the resource. The reason for the conflict exception. The zonal shift ID associated with the conflict exception. The input requested a resource that was not found. 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. 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. 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 AWS Region.
+CreatePracticeRunConfiguration
+
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/arc-zonal-shift/command/CreatePracticeRunConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/CreatePracticeRunConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/CreatePracticeRunConfigurationCommandOutput/)
+
+
+DeletePracticeRunConfiguration
+
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/arc-zonal-shift/command/DeletePracticeRunConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/DeletePracticeRunConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/DeletePracticeRunConfigurationCommandOutput/)
+
@@ -232,6 +260,14 @@ GetManagedResource
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/arc-zonal-shift/command/GetManagedResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/GetManagedResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/GetManagedResourceCommandOutput/)
+
+ListAutoshifts
+
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/arc-zonal-shift/command/ListAutoshiftsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/ListAutoshiftsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/ListAutoshiftsCommandOutput/)
+
@@ -256,6 +292,22 @@ StartZonalShift
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/arc-zonal-shift/command/StartZonalShiftCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/StartZonalShiftCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/StartZonalShiftCommandOutput/)
+
+UpdatePracticeRunConfiguration
+
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/arc-zonal-shift/command/UpdatePracticeRunConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/UpdatePracticeRunConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/UpdatePracticeRunConfigurationCommandOutput/)
+
+
+UpdateZonalAutoshiftConfiguration
+
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/arc-zonal-shift/command/UpdateZonalAutoshiftConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/UpdateZonalAutoshiftConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-arc-zonal-shift/Interface/UpdateZonalAutoshiftConfigurationCommandOutput/)
+
diff --git a/clients/client-arc-zonal-shift/src/ARCZonalShift.ts b/clients/client-arc-zonal-shift/src/ARCZonalShift.ts
index 43401596dacc..82c1d1df2227 100644
--- a/clients/client-arc-zonal-shift/src/ARCZonalShift.ts
+++ b/clients/client-arc-zonal-shift/src/ARCZonalShift.ts
@@ -8,11 +8,26 @@ import {
CancelZonalShiftCommandInput,
CancelZonalShiftCommandOutput,
} from "./commands/CancelZonalShiftCommand";
+import {
+ CreatePracticeRunConfigurationCommand,
+ CreatePracticeRunConfigurationCommandInput,
+ CreatePracticeRunConfigurationCommandOutput,
+} from "./commands/CreatePracticeRunConfigurationCommand";
+import {
+ DeletePracticeRunConfigurationCommand,
+ DeletePracticeRunConfigurationCommandInput,
+ DeletePracticeRunConfigurationCommandOutput,
+} from "./commands/DeletePracticeRunConfigurationCommand";
import {
GetManagedResourceCommand,
GetManagedResourceCommandInput,
GetManagedResourceCommandOutput,
} from "./commands/GetManagedResourceCommand";
+import {
+ ListAutoshiftsCommand,
+ ListAutoshiftsCommandInput,
+ ListAutoshiftsCommandOutput,
+} from "./commands/ListAutoshiftsCommand";
import {
ListManagedResourcesCommand,
ListManagedResourcesCommandInput,
@@ -28,6 +43,16 @@ import {
StartZonalShiftCommandInput,
StartZonalShiftCommandOutput,
} from "./commands/StartZonalShiftCommand";
+import {
+ UpdatePracticeRunConfigurationCommand,
+ UpdatePracticeRunConfigurationCommandInput,
+ UpdatePracticeRunConfigurationCommandOutput,
+} from "./commands/UpdatePracticeRunConfigurationCommand";
+import {
+ UpdateZonalAutoshiftConfigurationCommand,
+ UpdateZonalAutoshiftConfigurationCommandInput,
+ UpdateZonalAutoshiftConfigurationCommandOutput,
+} from "./commands/UpdateZonalAutoshiftConfigurationCommand";
import {
UpdateZonalShiftCommand,
UpdateZonalShiftCommandInput,
@@ -36,10 +61,15 @@ import {
const commands = {
CancelZonalShiftCommand,
+ CreatePracticeRunConfigurationCommand,
+ DeletePracticeRunConfigurationCommand,
GetManagedResourceCommand,
+ ListAutoshiftsCommand,
ListManagedResourcesCommand,
ListZonalShiftsCommand,
StartZonalShiftCommand,
+ UpdatePracticeRunConfigurationCommand,
+ UpdateZonalAutoshiftConfigurationCommand,
UpdateZonalShiftCommand,
};
@@ -61,6 +91,40 @@ export interface ARCZonalShift {
cb: (err: any, data?: CancelZonalShiftCommandOutput) => void
): void;
+ /**
+ * @see {@link CreatePracticeRunConfigurationCommand}
+ */
+ createPracticeRunConfiguration(
+ args: CreatePracticeRunConfigurationCommandInput,
+ options?: __HttpHandlerOptions
+ ): Promise
ListZonalShifts
returns customer-started zonal shifts, as well as practice run zonal shifts that Route 53 ARC started on
+ * your behalf for zonal autoshift.ListZonalShifts
operation does not list autoshifts. For more information about listing
+ * autoshifts, see ">ListAutoshifts.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.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
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.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 expiry time (expiration time) for the zonal shift. A zonal shift is temporary and must be set to expire when you start the zonal shift. + *
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, for example, if you're ready to restore traffic to the Availability Zone. Or you - * can update the zonal shift to specify another length of time to expire in.
+ *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: Date | undefined; /** * @public - *The time (UTC) when the zonal shift is started.
+ *The time (UTC) when the zonal shift starts.
*/ startTime: Date | undefined; /** * @public *A status for a zonal shift.
- *The Status
for a zonal shift can have one of the following values:
The Status
for a zonal shift can have one of the following values:
- * ACTIVE: The zonal shift is started and active.
+ * ACTIVE: The zonal shift has been started and active. *@@ -288,18 +447,264 @@ export interface ZonalShift { comment: string | undefined; } +/** + * @public + * @enum + */ +export const ControlConditionType = { + CLOUDWATCH: "CLOUDWATCH", +} as const; + +/** + * @public + */ +export type ControlConditionType = (typeof ControlConditionType)[keyof typeof ControlConditionType]; + +/** + * @public + *
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 in the Amazon Route 53 Application Recovery Controller Developer Guide.
+ */ +export interface ControlCondition { + /** + * @public + *The type of alarm specified for a practice run. The only valid value is CLOUDWATCH
.
The Amazon Resource Name (ARN) for the Amazon CloudWatch alarm that you specify as a control condition for a practice run.
+ */ + alarmIdentifier: string | undefined; +} + +/** + * @public + */ +export interface CreatePracticeRunConfigurationRequest { + /** + * @public + *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: string | undefined; + + /** + * @public + *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
.
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
.
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.
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.
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.
+ */ +export interface PracticeRunConfiguration { + /** + * @public + *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.
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.
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
.
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.
The Amazon Resource Name (ARN) of the resource that you configured the practice + * run for.
+ */ + arn: string | undefined; + + /** + * @public + *The name of the resource that you configured the practice run for.
+ */ + name: string | undefined; + + /** + * @public + *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: ZonalAutoshiftStatus | undefined; + + /** + * @public + *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: PracticeRunConfiguration | undefined; +} + +/** + * @public + */ +export interface DeletePracticeRunConfigurationRequest { + /** + * @public + *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: string | undefined; +} + +/** + * @public + */ +export interface DeletePracticeRunConfigurationResponse { + /** + * @public + *The Amazon Resource Name (ARN) of the resource that you deleted the practice + * run for.
+ */ + arn: string | undefined; + + /** + * @public + *The name of the resource that you deleted the practice + * run for.
+ */ + name: string | undefined; + + /** + * @public + *The status of zonal autoshift for the resource.
+ */ + zonalAutoshiftStatus: ZonalAutoshiftStatus | undefined; +} + /** * @public */ export interface GetManagedResourceRequest { /** * @public - *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.
+ *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: string | undefined; } +/** + * @public + * @enum + */ +export const PracticeRunOutcome = { + FAILED: "FAILED", + INTERRUPTED: "INTERRUPTED", + PENDING: "PENDING", + SUCCEEDED: "SUCCEEDED", +} as const; + +/** + * @public + */ +export type PracticeRunOutcome = (typeof PracticeRunOutcome)[keyof typeof PracticeRunOutcome]; + /** * @public *A complex structure that lists the zonal shifts for a managed resource and their statuses for the resource.
@@ -307,8 +712,18 @@ export interface GetManagedResourceRequest { export interface ZonalShiftInResource { /** * @public - *An appliedStatus
for a zonal shift for a resource can have one of two values: APPLIED
- * or NOT_APPLIED
.
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 in the Amazon Route 53 Application Recovery Controller Developer Guide.
*/ appliedStatus: AppliedStatus | undefined; @@ -321,31 +736,31 @@ export interface ZonalShiftInResource { /** * @public *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.
+ *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: string | undefined; /** * @public *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 AWS Region.
+ * 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: string | undefined; /** * @public - *The expiry time (expiration time) for the zonal shift. A zonal shift is temporary and must be set to expire when you start the zonal shift. + *
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, for example, if you're ready to restore traffic to the Availability Zone. Or you - * can update the zonal shift to specify another length of time to expire in.
+ *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: Date | undefined; /** * @public - *The time (UTC) when the zonal shift is started.
+ *The time (UTC) when the zonal shift starts.
*/ startTime: Date | undefined; @@ -355,6 +770,38 @@ export interface ZonalShiftInResource { * history is maintained. That is, a new comment overwrites any existing comment string. */ comment: string | undefined; + + /** + * @public + *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 in the Amazon Route 53 Application Recovery Controller Developer Guide.
+ */ + practiceRunOutcome?: PracticeRunOutcome; } /** @@ -385,6 +832,29 @@ export interface GetManagedResourceResponse { *The zonal shifts that are currently active for a resource.
*/ zonalShifts: ZonalShiftInResource[] | undefined; + + /** + * @public + *An array of the autoshifts that are active for the resource.
+ */ + autoshifts?: AutoshiftInResource[]; + + /** + * @public + *The practice run configuration for zonal autoshift that's associated with + * the resource.
+ */ + practiceRunConfiguration?: PracticeRunConfiguration; + + /** + * @public + *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.
A complex structure for a managed resource in an account.
- *A managed resource is a Network Load Balancer or Application 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 AWS Region.
- *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.
+ *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.
*The Availability Zones that a resource is deployed in.
*/ availabilityZones: string[] | undefined; + + /** + * @public + *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?: RecordAn array of the zonal shifts for a resource.
+ */ + zonalShifts?: ZonalShiftInResource[]; + + /** + * @public + *An array of the autoshifts that have been completed for a resource.
+ */ + autoshifts?: AutoshiftInResource[]; + + /** + * @public + *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
.
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
.
A status for a zonal shift.
- *The Status
for a zonal shift can have one of the following values:
The Status
for a zonal shift can have one of the following values:
- * ACTIVE: The zonal shift is started and active.
+ * ACTIVE: The zonal shift has been started and active. *@@ -492,18 +1002,22 @@ export interface ListZonalShiftsRequest { *
The number of objects that you want to return with this call.
*/ maxResults?: number; + + /** + * @public + *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; } /** * @public - *You start a zonal shift to temporarily move load balancer traffic away from an Availability Zone in a AWS Region. - * A zonal shift helps your application recover immediately, for example, from a developer's bad code deployment or from an AWS - * infrastructure failure in a single Availability Zone. You can start a zonal shift in Route 53 ARC only for managed - * resources in your account in an AWS Region. Supported AWS resources are automatically registered with Route 53 ARC.
- *Zonal shifts are temporary. A zonal shift can be active for up to three days (72 hours).
- *When you start a zonal shift, you specify how long you want it to be active, which Amazon Route 53 Application Recovery Controller converts - * to an expiry time (expiration time). You can cancel a zonal shift, for example, if you're ready to restore traffic to the Availability Zone. Or you - * can extend the zonal shift by updating the expiration so the zonal shift is active longer.
+ *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.
*/ export interface ZonalShiftSummary { /** @@ -515,42 +1029,42 @@ export interface ZonalShiftSummary { /** * @public *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.
+ *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: string | undefined; /** * @public *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 AWS Region.
+ * 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: string | undefined; /** * @public - *The expiry time (expiration time) for the zonal shift. A zonal shift is temporary and must be set to expire when you start the zonal shift. + *
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, for example, if you're ready to restore traffic to the Availability Zone. Or you - * can update the zonal shift to specify another length of time to expire in.
+ *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: Date | undefined; /** * @public - *The time (UTC) when the zonal shift is started.
+ *The time (UTC) when the zonal shift starts.
*/ startTime: Date | undefined; /** * @public *A status for a zonal shift.
- *The Status
for a zonal shift can have one of the following values:
The Status
for a zonal shift can have one of the following values:
- * ACTIVE: The zonal shift is started and active.
+ * ACTIVE: The zonal shift has been started and active. *@@ -570,6 +1084,38 @@ export interface ZonalShiftSummary { * history is maintained. That is, a new comment overwrites any existing comment string.
*/ comment: string | undefined; + + /** + * @public + *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 in the Amazon Route 53 Application Recovery Controller Developer Guide.
+ */ + practiceRunOutcome?: PracticeRunOutcome; } /** @@ -591,6 +1137,129 @@ export interface ListZonalShiftsResponse { nextToken?: string; } +/** + * @public + */ +export interface UpdateZonalAutoshiftConfigurationRequest { + /** + * @public + *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: string | undefined; + + /** + * @public + *The zonal autoshift status for the resource that you want to update the zonal + * autoshift configuration for.
+ */ + zonalAutoshiftStatus: ZonalAutoshiftStatus | undefined; +} + +/** + * @public + */ +export interface UpdateZonalAutoshiftConfigurationResponse { + /** + * @public + *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: string | undefined; + + /** + * @public + *The zonal autoshift status for the resource that you updated the zonal + * autoshift configuration for.
+ */ + zonalAutoshiftStatus: ZonalAutoshiftStatus | undefined; +} + +/** + * @public + */ +export interface UpdatePracticeRunConfigurationRequest { + /** + * @public + *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: string | undefined; + + /** + * @public + *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
.
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
.
Add, change, or remove the Amazon CloudWatch alarm that you optionally + * specify as the blocking alarm for practice runs.
+ */ + blockingAlarms?: ControlCondition[]; + + /** + * @public + *Specify a new the Amazon CloudWatch alarm as the outcome alarm for practice runs.
+ */ + outcomeAlarms?: ControlCondition[]; +} + +/** + * @public + */ +export interface UpdatePracticeRunConfigurationResponse { + /** + * @public + *The Amazon Resource Name (ARN) of the resource that you updated the practice + * run for.
+ */ + arn: string | undefined; + + /** + * @public + *The name of the resource that you updated the practice + * run for.
+ */ + name: string | undefined; + + /** + * @public + *The zonal autoshift status for the resource that you updated the practice + * run for.
+ */ + zonalAutoshiftStatus: ZonalAutoshiftStatus | undefined; + + /** + * @public + *The practice run configuration that was updated.
+ */ + practiceRunConfiguration: PracticeRunConfiguration | undefined; +} + /** * @public */ @@ -612,11 +1281,11 @@ export interface UpdateZonalShiftRequest { * @public *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 + *
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:
- *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.
@@ -626,7 +1295,7 @@ export interface UpdateZonalShiftRequest { * 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).
For example: 20h
means the zonal shift expires in 20 hours. 120m
means the zonal shift expires in 120 minutes (2 hours).
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.
+ *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: string | undefined; /** * @public *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 AWS Region.
+ * 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: string | undefined; /** * @public *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:
- * - *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.
@@ -668,7 +1336,7 @@ export interface StartZonalShiftRequest { * 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).
For example: 20h
means the zonal shift expires in 20 hours. 120m
means the zonal shift expires in 120 minutes (2 hours).
The appliedStatus
field specifies which application traffic shift is in effect for a\n\t\t\tresource when there is more than one traffic shift active. There can be more than one application traffic \n\t\t\tshift in progress at the same time - that is, practice run zonal shifts, customer-started zonal shifts, \n\t\t\tor an autoshift. The appliedStatus
field for an autoshift for a resource can have one of two \n\t\t\tvalues: APPLIED
or NOT_APPLIED
. The zonal shift or autoshift \n\t\t\tthat 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 \n\t\t\tautoshifts, which take precedence over practice runs. That is, customer-started zonal shifts > autoshifts > practice run \n\t\t\tzonal shifts.
\nFor more information, see \n\t\t\tHow zonal autoshift \n\t\t\t\tand practice runs work in the Amazon Route 53 Application Recovery Controller Developer Guide.
", + "smithy.api#required": {} + } + }, + "awayFrom": { + "target": "com.amazonaws.arczonalshift#AvailabilityZone", + "traits": { + "smithy.api#documentation": "The Availability Zone that traffic is shifted away from for a resource, when Amazon Web Services starts an autoshift. \n\t\t\tUntil the autoshift ends, traffic for the resource is instead directed to other Availability Zones in the Amazon Web Services Region.\n\t\t\tAn autoshift can end for a resource, for example, when Amazon Web Services ends the autoshift for the Availability Zone or when \n\t\t\tyou disable zonal autoshift for the resource.
", + "smithy.api#required": {} + } + }, + "startTime": { + "target": "com.amazonaws.arczonalshift#StartTime", + "traits": { + "smithy.api#documentation": "The time (UTC) when the autoshift started.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#documentation": "A complex structure that lists an autoshift that is currently active for a managed resource and information about\n\t\t\tthe autoshift.
\nFor more information, see How zonal autoshift \n\t\t\tand practice runs work in the Amazon Route 53 Application Recovery Controller Developer Guide.
" + } + }, + "com.amazonaws.arczonalshift#AutoshiftSummaries": { + "type": "list", + "member": { + "target": "com.amazonaws.arczonalshift#AutoshiftSummary" + } + }, + "com.amazonaws.arczonalshift#AutoshiftSummary": { + "type": "structure", + "members": { + "awayFrom": { + "target": "com.amazonaws.arczonalshift#AvailabilityZone", + "traits": { + "smithy.api#documentation": "The Availability Zone that traffic is shifted away from for a resource when Amazon Web Services starts an autoshift. \n\t\t\tUntil the autoshift ends, traffic for the resource is instead directed to other Availability Zones in the Amazon Web Services Region.\n\t\t\tAn autoshift can end for a resource, for example, when Amazon Web Services ends the autoshift for the Availability Zone or when \n\t\t\tyou disable zonal autoshift for the resource.
", + "smithy.api#required": {} + } + }, + "endTime": { + "target": "com.amazonaws.arczonalshift#ExpiryTime", + "traits": { + "smithy.api#documentation": "The time (in UTC) when the autoshift ended.
", + "smithy.api#required": {} + } + }, + "startTime": { + "target": "com.amazonaws.arczonalshift#StartTime", + "traits": { + "smithy.api#documentation": "The time (in UTC) when the autoshift started.
", + "smithy.api#required": {} + } + }, + "status": { + "target": "com.amazonaws.arczonalshift#AutoshiftExecutionStatus", + "traits": { + "smithy.api#documentation": "The status for an autoshift.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#documentation": "Information about an autoshift. Amazon Web Services starts an autoshift to temporarily move traffic for a resource \n\t\t\taway from an Availability Zone in an Amazon Web Services Region\n\t\t\twhen Amazon Web Services determines that there's an issue in the Availability Zone that could potentially affect customers.\n\t\t\tYou can configure zonal autoshift in Route 53 ARC for managed resources in your Amazon Web Services account in a Region. \n\t\t\tSupported Amazon Web Services resources are automatically registered with Route 53 ARC.
\nAutoshifts are temporary. When the Availability Zone recovers, Amazon Web Services ends the autoshift, and \n\t\t\ttraffic for the resource is no longer directed to the other Availability Zones in the Region.
\nYou can stop an autoshift for a resource by disabling zonal autoshift.
" + } + }, + "com.amazonaws.arczonalshift#AutoshiftsInResource": { + "type": "list", + "member": { + "target": "com.amazonaws.arczonalshift#AutoshiftInResource" + } + }, "com.amazonaws.arczonalshift#AvailabilityZone": { "type": "string", "traits": { @@ -54,6 +179,50 @@ "target": "com.amazonaws.arczonalshift#AvailabilityZone" } }, + "com.amazonaws.arczonalshift#BlockedDate": { + "type": "string", + "traits": { + "smithy.api#length": { + "min": 10, + "max": 10 + }, + "smithy.api#pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" + } + }, + "com.amazonaws.arczonalshift#BlockedDates": { + "type": "list", + "member": { + "target": "com.amazonaws.arczonalshift#BlockedDate" + }, + "traits": { + "smithy.api#length": { + "min": 0, + "max": 15 + } + } + }, + "com.amazonaws.arczonalshift#BlockedWindow": { + "type": "string", + "traits": { + "smithy.api#length": { + "min": 19, + "max": 19 + }, + "smithy.api#pattern": "^(Mon|Tue|Wed|Thu|Fri|Sat|Sun):[0-9]{2}:[0-9]{2}-(Mon|Tue|Wed|Thu|Fri|Sat|Sun):[0-9]{2}:[0-9]{2}$" + } + }, + "com.amazonaws.arczonalshift#BlockedWindows": { + "type": "list", + "member": { + "target": "com.amazonaws.arczonalshift#BlockedWindow" + }, + "traits": { + "smithy.api#length": { + "min": 0, + "max": 15 + } + } + }, "com.amazonaws.arczonalshift#CancelZonalShift": { "type": "operation", "input": { @@ -83,7 +252,7 @@ } ], "traits": { - "smithy.api#documentation": "Cancel a zonal shift in Amazon Route 53 Application Recovery Controller that you've started for a resource in your AWS account in an AWS Region.
", + "smithy.api#documentation": "Cancel a zonal shift in Amazon Route 53 Application Recovery Controller. To cancel the zonal shift, specify the zonal shift ID.
\nA zonal shift can be one that you've started for a resource in your Amazon Web Services account \n \t\tin an Amazon Web Services Region, or it can be a zonal shift started by a practice run with zonal \n \t\tautoshift.
", "smithy.api#http": { "method": "DELETE", "uri": "/zonalshifts/{zonalShiftId}", @@ -156,10 +325,273 @@ { "value": "SimultaneousZonalShiftsConflict", "name": "SIMULTANEOUS_ZONAL_SHIFTS_CONFLICT" + }, + { + "value": "PracticeConfigurationAlreadyExists", + "name": "PRACTICE_CONFIGURATION_ALREADY_EXISTS" + }, + { + "value": "AutoShiftEnabled", + "name": "AUTOSHIFT_ENABLED" + }, + { + "value": "PracticeConfigurationDoesNotExist", + "name": "PRACTICE_CONFIGURATION_DOES_NOT_EXIST" } ] } }, + "com.amazonaws.arczonalshift#ControlCondition": { + "type": "structure", + "members": { + "type": { + "target": "com.amazonaws.arczonalshift#ControlConditionType", + "traits": { + "smithy.api#documentation": "The type of alarm specified for a practice run. The only valid value is CLOUDWATCH
.
The Amazon Resource Name (ARN) for the Amazon CloudWatch alarm that you specify as a control condition for a practice run.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#documentation": "A control condition is an alarm that you specify for a practice run. When you configure practice runs\n\t\t\twith zonal autoshift for a resource, you specify Amazon CloudWatch alarms, which you create in CloudWatch \n\t\t\tto use with the practice run. The alarms that you specify are an \n\t\t\toutcome alarm, to monitor application health during practice runs and, \n\t\t\toptionally, a blocking alarm, to block practice runs from starting.
\nControl condition alarms do not apply for autoshifts.
\nFor more information, see \n\t\t\t\n\t\t\t\tConsiderations when you configure zonal autoshift in the Amazon Route 53 Application Recovery Controller Developer Guide.
" + } + }, + "com.amazonaws.arczonalshift#ControlConditionType": { + "type": "enum", + "members": { + "CLOUDWATCH": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "CLOUDWATCH" + } + } + } + }, + "com.amazonaws.arczonalshift#ControlConditions": { + "type": "list", + "member": { + "target": "com.amazonaws.arczonalshift#ControlCondition" + }, + "traits": { + "smithy.api#length": { + "min": 1, + "max": 1 + } + } + }, + "com.amazonaws.arczonalshift#CreatePracticeRunConfiguration": { + "type": "operation", + "input": { + "target": "com.amazonaws.arczonalshift#CreatePracticeRunConfigurationRequest" + }, + "output": { + "target": "com.amazonaws.arczonalshift#CreatePracticeRunConfigurationResponse" + }, + "errors": [ + { + "target": "com.amazonaws.arczonalshift#AccessDeniedException" + }, + { + "target": "com.amazonaws.arczonalshift#ConflictException" + }, + { + "target": "com.amazonaws.arczonalshift#InternalServerException" + }, + { + "target": "com.amazonaws.arczonalshift#ResourceNotFoundException" + }, + { + "target": "com.amazonaws.arczonalshift#ThrottlingException" + }, + { + "target": "com.amazonaws.arczonalshift#ValidationException" + } + ], + "traits": { + "smithy.api#documentation": "A practice run configuration for zonal autoshift is required when you enable zonal autoshift.\n\t\t\tA practice run configuration includes specifications for blocked dates and blocked time windows,\n\t\tand for Amazon CloudWatch alarms that you create to use with practice runs. The alarms that you specify are an \n\t\t\toutcome alarm, to monitor application health during practice runs and, \n\t\t\toptionally, a blocking alarm, to block practice runs from starting.
\nFor more information, see \n\t\t\t\n\t\t\t\tConsiderations when you configure zonal autoshift in the Amazon Route 53 Application Recovery Controller Developer Guide.
", + "smithy.api#http": { + "method": "POST", + "uri": "/configuration", + "code": 201 + } + } + }, + "com.amazonaws.arczonalshift#CreatePracticeRunConfigurationRequest": { + "type": "structure", + "members": { + "resourceIdentifier": { + "target": "com.amazonaws.arczonalshift#ResourceIdentifier", + "traits": { + "smithy.api#documentation": "The identifier of the resource to shift away traffic for when a practice\n\t\t\trun starts a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\nAt this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", + "smithy.api#required": {} + } + }, + "blockedWindows": { + "target": "com.amazonaws.arczonalshift#BlockedWindows", + "traits": { + "smithy.api#documentation": "Optionally, you can block Route 53 ARC from starting practice runs for specific windows of \n\t\t\tdays and times.
\nThe format for blocked windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind, when you specify dates,\n\t\t\tthat dates and times for practice runs are in UTC. Also, be aware of potential time adjustments \n\t\t\tthat might be required for daylight saving time differences. Separate multiple blocked windows \n\t\t\twith spaces.
\nFor example, say you run business report summaries three days a week. For\n\t\t\tthis scenario, you might set the following recurring days and times as blocked windows, \n\t\t\tfor example: MON-20:30-21:30 WED-20:30-21:30 \n\t\t\t\tFRI-20:30-21:30
.
Optionally, you can block Route 53 ARC from starting practice runs for a resource\n\t\t\ton specific calendar dates.
\nThe format for blocked dates is: YYYY-MM-DD. Keep in mind, when you specify dates,\n\t\t\tthat dates and times for practice runs are in UTC. Separate multiple blocked \n\t\t\tdates with spaces.
\nFor example, if you have an application update scheduled to launch on May 1, 2024, and \n\t\t\tyou don't want practice runs to shift traffic away at that time, you could set a blocked date \n\t\t\tfor 2024-05-01
.
An Amazon CloudWatch alarm that you can specify for zonal autoshift \n\t\t\tpractice runs. This alarm blocks Route 53 ARC from starting practice run zonal \n\t\t\tshifts, and ends a practice run that's in progress, when the alarm is in \n\t\t\tan ALARM
state.
The outcome alarm for practice runs is a required\n\t\t\tAmazon CloudWatch alarm that you specify that ends a practice run when the \n\t\t\talarm is in an ALARM
state.
Configure the alarm to monitor the health of your application \n\t\t\twhen traffic is shifted away from an Availability Zone during each weekly \n\t\t\tpractice run. You should configure the alarm to go into an ALARM
state \n\t\t\tif your application is impacted by the zonal shift, and you want to stop the\n\t\t\tzonal shift, to let traffic for the resource return to the Availability Zone.
The Amazon Resource Name (ARN) of the resource that you configured the practice \n\t\t\trun for.
", + "smithy.api#required": {} + } + }, + "name": { + "target": "com.amazonaws.arczonalshift#ResourceName", + "traits": { + "smithy.api#documentation": "The name of the resource that you configured the practice run for.
", + "smithy.api#required": {} + } + }, + "zonalAutoshiftStatus": { + "target": "com.amazonaws.arczonalshift#ZonalAutoshiftStatus", + "traits": { + "smithy.api#documentation": "The status for zonal autoshift for a resource. When you specify the\n\t\t\tautoshift status as ENABLED
, Amazon Web Services shifts traffic \n\t\t\taway from shifts away application resource traffic from an Availability Zone, \n\t\t\ton your behalf, when Amazon Web Services determines that there's an issue in \n\t\t\tthe Availability Zone that could potentially affect customers.
When you enable zonal autoshift, you must also configure practice runs for\n\t\t\tthe resource.
", + "smithy.api#required": {} + } + }, + "practiceRunConfiguration": { + "target": "com.amazonaws.arczonalshift#PracticeRunConfiguration", + "traits": { + "smithy.api#documentation": "A practice run configuration for a resource. Configurations include the\n\t\t\toutcome alarm that you specify for practice runs, and, optionally, a\n\t\t\tblocking alarm and blocking dates and windows.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#output": {} + } + }, + "com.amazonaws.arczonalshift#DeletePracticeRunConfiguration": { + "type": "operation", + "input": { + "target": "com.amazonaws.arczonalshift#DeletePracticeRunConfigurationRequest" + }, + "output": { + "target": "com.amazonaws.arczonalshift#DeletePracticeRunConfigurationResponse" + }, + "errors": [ + { + "target": "com.amazonaws.arczonalshift#AccessDeniedException" + }, + { + "target": "com.amazonaws.arczonalshift#ConflictException" + }, + { + "target": "com.amazonaws.arczonalshift#InternalServerException" + }, + { + "target": "com.amazonaws.arczonalshift#ResourceNotFoundException" + }, + { + "target": "com.amazonaws.arczonalshift#ThrottlingException" + }, + { + "target": "com.amazonaws.arczonalshift#ValidationException" + } + ], + "traits": { + "smithy.api#documentation": "Deletes the practice run configuration for a resource. Before you can delete\n\t\t\ta practice run configuration for a resource., you must disable zonal autoshift for \n\t\t\tthe resource. Practice runs must be configured for zonal autoshift to be enabled.
", + "smithy.api#http": { + "method": "DELETE", + "uri": "/configuration/{resourceIdentifier}", + "code": 200 + }, + "smithy.api#idempotent": {} + } + }, + "com.amazonaws.arczonalshift#DeletePracticeRunConfigurationRequest": { + "type": "structure", + "members": { + "resourceIdentifier": { + "target": "com.amazonaws.arczonalshift#ResourceIdentifier", + "traits": { + "smithy.api#documentation": "The identifier for the resource that you want to delete the practice\n\t\t\trun configuration for. The identifier is the Amazon Resource Name (ARN) for the resource.
", + "smithy.api#httpLabel": {}, + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#input": {}, + "smithy.api#references": [ + { + "resource": "com.amazonaws.arczonalshift#PracticeRunConfigurationResource" + } + ] + } + }, + "com.amazonaws.arczonalshift#DeletePracticeRunConfigurationResponse": { + "type": "structure", + "members": { + "arn": { + "target": "com.amazonaws.arczonalshift#ResourceArn", + "traits": { + "smithy.api#documentation": "The Amazon Resource Name (ARN) of the resource that you deleted the practice \n\t\t\trun for.
", + "smithy.api#required": {} + } + }, + "name": { + "target": "com.amazonaws.arczonalshift#ResourceName", + "traits": { + "smithy.api#documentation": "The name of the resource that you deleted the practice \n\t\t\trun for.
", + "smithy.api#required": {} + } + }, + "zonalAutoshiftStatus": { + "target": "com.amazonaws.arczonalshift#ZonalAutoshiftStatus", + "traits": { + "smithy.api#documentation": "The status of zonal autoshift for the resource.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#output": {} + } + }, "com.amazonaws.arczonalshift#ExpiresIn": { "type": "string", "traits": { @@ -199,7 +631,7 @@ } ], "traits": { - "smithy.api#documentation": "Get information about a resource that's been registered for zonal shifts with Amazon Route 53 Application Recovery Controller in this AWS Region. Resources that are registered for\n \t\tzonal shifts are managed resources in Route 53 ARC.
\n \tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", + "smithy.api#documentation": "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\n \t\tzonal shifts are managed resources in Route 53 ARC. You can start zonal shifts and configure zonal autoshift for managed resources.
\nAt 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.
", "smithy.api#http": { "method": "GET", "uri": "/managedresources/{resourceIdentifier}", @@ -214,7 +646,7 @@ "resourceIdentifier": { "target": "com.amazonaws.arczonalshift#ResourceIdentifier", "traits": { - "smithy.api#documentation": "The identifier for the resource to include in a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\n \tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", + "smithy.api#documentation": "The identifier for the resource to shift away traffic for. The identifier is the Amazon Resource Name (ARN) for the resource.
\nAt this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } @@ -257,6 +689,24 @@ "smithy.api#documentation": "The zonal shifts that are currently active for a resource.
", "smithy.api#required": {} } + }, + "autoshifts": { + "target": "com.amazonaws.arczonalshift#AutoshiftsInResource", + "traits": { + "smithy.api#documentation": "An array of the autoshifts that are active for the resource.
" + } + }, + "practiceRunConfiguration": { + "target": "com.amazonaws.arczonalshift#PracticeRunConfiguration", + "traits": { + "smithy.api#documentation": "The practice run configuration for zonal autoshift that's associated with\n\t\t\tthe resource.
" + } + }, + "zonalAutoshiftStatus": { + "target": "com.amazonaws.arczonalshift#ZonalAutoshiftStatus", + "traits": { + "smithy.api#documentation": "The status for zonal autoshift for a resource. When the\n\t\t\tautoshift status is ENABLED
, Amazon Web Services shifts traffic \n\t\t\tfor a resource away from an Availability Zone, on your behalf, when \n\t\t\tAmazon Web Services determines that there's an issue in \n\t\t\tthe Availability Zone that could potentially affect customers.
Returns the active autoshifts for a specified resource.
", + "smithy.api#http": { + "method": "GET", + "uri": "/autoshifts", + "code": 200 + }, + "smithy.api#paginated": { + "inputToken": "nextToken", + "outputToken": "nextToken", + "pageSize": "maxResults", + "items": "items" + }, + "smithy.api#readonly": {} + } + }, + "com.amazonaws.arczonalshift#ListAutoshiftsRequest": { + "type": "structure", + "members": { + "nextToken": { + "target": "smithy.api#String", + "traits": { + "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a NextToken
response in the \n\t\t\tprevious request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous \n\t\t\tcall's NextToken
response to request the next page of results.
The status of the autoshift.
", + "smithy.api#httpQuery": "status" + } + }, + "maxResults": { + "target": "com.amazonaws.arczonalshift#MaxResults", + "traits": { + "smithy.api#documentation": "The number of objects that you want to return with this call.
", + "smithy.api#httpQuery": "maxResults" + } + } + }, + "traits": { + "smithy.api#input": {} + } + }, + "com.amazonaws.arczonalshift#ListAutoshiftsResponse": { + "type": "structure", + "members": { + "items": { + "target": "com.amazonaws.arczonalshift#AutoshiftSummaries", + "traits": { + "smithy.api#documentation": "The items in the response list.
" + } + }, + "nextToken": { + "target": "smithy.api#String", + "traits": { + "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a NextToken
response in the \n\t\t\tprevious request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous \n\t\t\tcall's NextToken
response to request the next page of results.
Lists all the resources in your AWS account in this AWS Region that are managed for zonal shifts in Amazon Route 53 Application Recovery Controller, and information \n \t\tabout them. The information includes their Amazon Resource Names (ARNs), the Availability Zones the resources are deployed in, and \n \t\tthe resource name.
", + "smithy.api#documentation": "Lists all the resources in your Amazon Web Services account in this Amazon Web Services Region that are managed for \n \t\tzonal shifts in Amazon Route 53 Application Recovery Controller, and information about them. The information includes the zonal autoshift status for the resource, \n \t\tas well as the Amazon Resource Name (ARN), the Availability Zones that each resource is deployed in, and \n \t\tthe resource name.
", "smithy.api#http": { "method": "GET", "uri": "/managedresources", @@ -380,7 +917,7 @@ } ], "traits": { - "smithy.api#documentation": "Lists all the active zonal shifts in Amazon Route 53 Application Recovery Controller in your AWS account in this AWS Region.
", + "smithy.api#documentation": "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.\n \t\tListZonalShifts
returns customer-started zonal shifts, as well as practice run zonal shifts that Route 53 ARC started on \n \t\tyour behalf for zonal autoshift.
The ListZonalShifts
operation does not list autoshifts. For more information about listing\n \t\tautoshifts, see \">ListAutoshifts.
A status for a zonal shift.
\n \tThe Status
for a zonal shift can have one of the following values:
\n ACTIVE: The zonal shift is started and active.
\n\n EXPIRED: The zonal shift has expired (the expiry time was exceeded).
\n\n CANCELED: The zonal shift was canceled.
\nA status for a zonal shift.
\nThe Status
for a zonal shift can have one of the following values:
\n ACTIVE: The zonal shift has been started and active.
\n\n EXPIRED: The zonal shift has expired (the expiry time was exceeded).
\n\n CANCELED: The zonal shift was canceled.
\nThe number of objects that you want to return with this call.
", "smithy.api#httpQuery": "maxResults" } + }, + "resourceIdentifier": { + "target": "com.amazonaws.arczonalshift#ResourceIdentifier", + "traits": { + "smithy.api#documentation": "The identifier for the resource that you want to list zonal shifts for.\n\t\t\tThe identifier is the Amazon Resource Name (ARN) for the resource.
", + "smithy.api#httpQuery": "resourceIdentifier" + } } }, "traits": { @@ -456,7 +1000,12 @@ }, "list": { "target": "com.amazonaws.arczonalshift#ListManagedResources" - } + }, + "operations": [ + { + "target": "com.amazonaws.arczonalshift#UpdateZonalAutoshiftConfiguration" + } + ] }, "com.amazonaws.arczonalshift#ManagedResourceSummaries": { "type": "list", @@ -470,25 +1019,55 @@ "arn": { "target": "com.amazonaws.arczonalshift#ResourceArn", "traits": { - "smithy.api#documentation": "The Amazon Resource Name (ARN) for the managed resource.
" + "smithy.api#documentation": "The Amazon Resource Name (ARN) for the managed resource.
" + } + }, + "name": { + "target": "com.amazonaws.arczonalshift#ResourceName", + "traits": { + "smithy.api#documentation": "The name of the managed resource.
" + } + }, + "availabilityZones": { + "target": "com.amazonaws.arczonalshift#AvailabilityZones", + "traits": { + "smithy.api#documentation": "The Availability Zones that a resource is deployed in.
", + "smithy.api#required": {} + } + }, + "appliedWeights": { + "target": "com.amazonaws.arczonalshift#AppliedWeights", + "traits": { + "smithy.api#documentation": "A collection of key-value pairs that indicate whether resources are active in Availability Zones or not. \n\t\t\tThe key name is the Availability Zone where the resource is deployed. The value is 1 or 0.
" + } + }, + "zonalShifts": { + "target": "com.amazonaws.arczonalshift#ZonalShiftsInResource", + "traits": { + "smithy.api#documentation": "An array of the zonal shifts for a resource.
" } }, - "name": { - "target": "com.amazonaws.arczonalshift#ResourceName", + "autoshifts": { + "target": "com.amazonaws.arczonalshift#AutoshiftsInResource", "traits": { - "smithy.api#documentation": "The name of the managed resource.
" + "smithy.api#documentation": "An array of the autoshifts that have been completed for a resource.
" } }, - "availabilityZones": { - "target": "com.amazonaws.arczonalshift#AvailabilityZones", + "zonalAutoshiftStatus": { + "target": "com.amazonaws.arczonalshift#ZonalAutoshiftStatus", "traits": { - "smithy.api#documentation": "The Availability Zones that a resource is deployed in.
", - "smithy.api#required": {} + "smithy.api#documentation": "The status of autoshift for a resource. When you configure zonal autoshift for a\n\t\t\tresource, you can set the value of the status to ENABLED
or DISABLED
.
This status tracks whether a practice run configuration exists for a resource. When you configure\n\t\t\ta practice run for a resource so that a practice run configuration exists, Route 53 ARC sets this value to \n\t\t\tENABLED
. If a you have not configured a practice run for the resource, or delete a practice \n\t\t\trun 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 \n\t\t\tDISABLED
.
A complex structure for a managed resource in an account.
\n \tA managed resource is a Network Load Balancer or Application Load Balancer that has been registered with Route 53 ARC by Elastic Load Balancing. You can start a\n \t\tzonal shift in Route 53 ARC for a managed resource to temporarily move traffic for the resource away from an Availability Zone in an AWS Region.
\n \tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
\nA complex structure for a managed resource in an Amazon Web Services account with information about zonal shifts\n \t\tand autoshifts.
\nA managed resource is a load balancer that has been registered \n \t\twith Route 53 ARC by Elastic Load Balancing. You can start a zonal shift in Route 53 ARC for a managed resource to \n \t\ttemporarily move traffic for the resource away from an Availability Zone in an Amazon Web Services Region.\n \t\tYou can also configure zonal autoshift for a managed resource.
\nAt this time, managed resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
\nThis is the API Reference Guide for the zonal shift feature of Amazon Route 53 Application Recovery Controller. This guide is for developers who need detailed information about \n\t\t\tzonal shift API actions, data types, and errors.
\n\t\tZonal shift is in preview release for Amazon Route 53 Application Recovery Controller and is subject to change.
\n\t\tZonal shift in Route 53 ARC enables you to move traffic for a load balancer resource away from an Availability Zone. Starting \n\t\t\ta zonal shift helps your application recover immediately, for example, from a developer's bad code deployment \n\t\t\tor from an AWS infrastructure failure in a single Availability Zone, reducing the impact and time lost from an issue \n\t\t\tin one zone.
\n\t\tSupported AWS resources are automatically registered with Route 53 ARC. Resources that are registered for zonal shifts \n\t\t\tin Route 53 ARC are managed resources in Route 53 ARC. You can start a zonal shift for any managed resource in your account in a Region. \n\t\t\tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
\n\t\tZonal shifts are temporary. You must specify an expiration when you start a zonal shift, of up to three days initially. \n\t\t\tIf you want to still keep traffic away from an Availability Zone, you can update the zonal shift and set a new expiration. \n\t\t\tYou can also cancel a zonal shift, before it expires, for example, if you're ready to restore traffic to the Availability Zone.
\n\t\tFor more information about using zonal shift, see the \n\t\t\tAmazon Route 53 Application Recovery Controller Developer Guide.
", + "smithy.api#documentation": "Welcome to the Zonal Shift API Reference Guide for Amazon Route 53 Application Recovery Controller (Route 53 ARC).
\nYou can start a zonal shift to move traffic for a load balancer resource away from an Availability Zone to\n\t\t\thelp your application recover quickly from an impairment in an Availability Zone. For example, \n\t\t\tyou can recover your application from a developer's bad code deployment or from an \n\t\t\tAmazon Web Services infrastructure failure in a single Availability Zone.
\nYou can also configure zonal autoshift for a load balancer resource. Zonal autoshift \n\t\t\tis a capability in Route 53 ARC where Amazon Web Services shifts away application resource \n\t\t\ttraffic from an Availability Zone, on your behalf, to help reduce your time to recovery during events.\n\t\t\tAmazon Web Services shifts away traffic for resources that are enabled for zonal autoshift whenever Amazon Web Services \n\t\t\tdetermines that there's an issue in the Availability Zone that could potentially affect \n\t\t\tcustomers.
\nTo ensure that zonal autoshift is safe for your application, you must \n\t\t\talso configure practice runs when you enable zonal autoshift for a resource. Practice runs start \n\t\t\tweekly zonal shifts for a resource, to shift\n\t\t\ttraffic for the resource out of an Availability Zone. Practice runs make sure, on a regular basis, \n\t\t\tthat you have enough capacity in all the Availability Zones in an Amazon Web Services Region \n\t\t\tfor your application to continue to operate normally \n\t\t\twhen traffic for a resource is shifted away from one Availability Zone.
\nYou must prescale resource capacity in all Availability Zones in the Region \n\t\t\twhere your application is deployed, before you configure practice runs or enable zonal autoshift\n\t\t\tfor a resource. You should not rely on scaling on demand when an autoshift or practice run \n\t\t\tstarts.
\nFor more information about using zonal shift and zonal autoshift, see the \n\t\t\tAmazon Route 53 Application Recovery Controller \n\t\t\t\tDeveloper Guide.
", "smithy.api#title": "AWS ARC - Zonal Shift", "smithy.rules#endpointRuleSet": { "version": "1.0", @@ -1213,6 +1805,93 @@ } } }, + "com.amazonaws.arczonalshift#PracticeRunConfiguration": { + "type": "structure", + "members": { + "blockingAlarms": { + "target": "com.amazonaws.arczonalshift#ControlConditions", + "traits": { + "smithy.api#documentation": "The blocking alarm for practice runs is an optional alarm that you can \n\t\t\tspecify that blocks practice runs when the alarm is in an ALARM
state.
The outcome alarm for practice runs is an alarm that you specify that \n\t\t\tends a practice run when the alarm is in an ALARM
state.
An array of one or more windows of days and times that you can block Route 53 ARC\n\t\t\tfrom starting practice runs for a resource.
\nSpecify the blocked windows in UTC, using the format DAY:HH:MM-DAY:HH:MM
, separated by \n\t\t\tspaces. For example, MON:18:30-MON:19:30 TUE:18:30-TUE:19:30
.
An array of one or more dates that you can specify when Amazon Web Services does not start practice runs for a resource.
\nSpecify blocked dates, in UTC, in the format YYYY-MM-DD
, separated by spaces.
A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice\n\t\trun, as well as any blocked dates or blocked windows for the practice run.
\nYou can update or delete a practice run configuration. Before you delete a practice run configuration, you\n\t\t\tmust disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
" + } + }, + "com.amazonaws.arczonalshift#PracticeRunConfigurationResource": { + "type": "resource", + "identifiers": { + "resourceIdentifier": { + "target": "com.amazonaws.arczonalshift#ResourceIdentifier" + } + }, + "update": { + "target": "com.amazonaws.arczonalshift#UpdatePracticeRunConfiguration" + }, + "delete": { + "target": "com.amazonaws.arczonalshift#DeletePracticeRunConfiguration" + }, + "operations": [ + { + "target": "com.amazonaws.arczonalshift#CreatePracticeRunConfiguration" + } + ], + "traits": { + "aws.cloudformation#cfnResource": { + "name": "ZonalAutoshiftConfiguration" + } + } + }, + "com.amazonaws.arczonalshift#PracticeRunOutcome": { + "type": "enum", + "members": { + "FAILED": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "FAILED" + } + }, + "INTERRUPTED": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "INTERRUPTED" + } + }, + "PENDING": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "PENDING" + } + }, + "SUCCEEDED": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "SUCCEEDED" + } + } + } + }, "com.amazonaws.arczonalshift#ResourceArn": { "type": "string", "traits": { @@ -1289,7 +1968,7 @@ } ], "traits": { - "smithy.api#documentation": "You start a zonal shift to temporarily move load balancer traffic away from an Availability Zone in a AWS Region,\n \t\tto help your application recover immediately, for example, from a developer's bad code deployment or from an AWS \n \t\tinfrastructure failure in a single Availability Zone. You can start a zonal shift in Route 53 ARC only for managed\n \t\tresources in your account in an AWS Region. Resources are automatically registered with Route 53 ARC by AWS services.
\n \tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
\n \tWhen you start a zonal shift, traffic for the resource is no longer routed to the Availability Zone. The\n \t\tzonal shift is created immediately in Route 53 ARC. However, it can take a short time, typically up to a few minutes,\n \t\tfor existing, in-progress connections in the Availability Zone to complete.
\n \tFor more information, see Zonal shift\n \t\tin the Amazon Route 53 Application Recovery Controller Developer Guide.
", + "smithy.api#documentation": "You start a zonal shift to temporarily move load balancer traffic away from an Availability Zone in an Amazon Web Services Region,\n \t\tto help your application recover immediately, for example, from a developer's bad code deployment or from an Amazon Web Services \n \t\tinfrastructure failure in a single Availability Zone. You can start a zonal shift in Route 53 ARC only for managed\n \t\tresources in your Amazon Web Services account in an Amazon Web Services Region. Resources are automatically registered with Route 53 ARC \n \t\tby Amazon Web Services services.
\nAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
\nWhen you start a zonal shift, traffic for the resource is no longer routed to the Availability Zone. The\n \t\tzonal shift is created immediately in Route 53 ARC. However, it can take a short time, typically up to a few minutes,\n \t\tfor existing, in-progress connections in the Availability Zone to complete.
\nFor more information, see Zonal shift\n \t\tin the Amazon Route 53 Application Recovery Controller Developer Guide.
", "smithy.api#http": { "method": "POST", "uri": "/zonalshifts", @@ -1303,21 +1982,21 @@ "resourceIdentifier": { "target": "com.amazonaws.arczonalshift#ResourceIdentifier", "traits": { - "smithy.api#documentation": "The identifier for the resource to include in a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\n \tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", + "smithy.api#documentation": "The identifier for the resource to shift away traffic for. The identifier is the Amazon Resource Name (ARN) for the resource.
\nAt this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", "smithy.api#required": {} } }, "awayFrom": { "target": "com.amazonaws.arczonalshift#AvailabilityZone", "traits": { - "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n \t\tUntil the zonal shift expires or you cancel it, traffic for the resource is instead moved to other Availability Zones in the AWS Region.
", + "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n \t\tUntil 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.
", "smithy.api#required": {} } }, "expiresIn": { "target": "com.amazonaws.arczonalshift#ExpiresIn", "traits": { - "smithy.api#documentation": "The length of time that you want a zonal shift to be active, which Route 53 ARC converts to an expiry time (expiration time).\n \t\tZonal shifts are temporary. You can set a zonal shift to be active initially for up to three days (72 hours).
\n \tIf you want to still keep traffic away from an Availability Zone, you can update the \n \t\tzonal shift and set a new expiration. You can also cancel a zonal shift, before it expires, for example, if you're ready to \n \t\trestore traffic to the Availability Zone.
\n \tTo 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:
\n \t\n \t\n A lowercase letter m: To specify that the value is in minutes.
\n\n A lowercase letter h: To specify that the value is in hours.
\nFor example: 20h
means the zonal shift expires in 20 hours. 120m
means the zonal shift expires in 120 minutes (2 hours).
The length of time that you want a zonal shift to be active, which Route 53 ARC converts to an expiry time (expiration time).\n\t\tZonal shifts are temporary. You can set a zonal shift to be active initially for up to three days (72 hours).
\nIf you want to still keep traffic away from an Availability Zone, you can update the \n\t\tzonal shift and set a new expiration. You can also cancel a zonal shift, before it expires, for example, if you're ready to \n\t\trestore traffic to the Availability Zone.
\nTo 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:
\n\n A lowercase letter m: To specify that the value is in minutes.
\n\n A lowercase letter h: To specify that the value is in hours.
\nFor example: 20h
means the zonal shift expires in 20 hours. 120m
means the zonal shift expires in 120 minutes (2 hours).
Update a practice run configuration to change one or more of the following: add, \n\t\t\tchange, or remove the blocking alarm; change the outcome alarm; or add, change, \n\t\t\tor remove blocking dates or time windows.
", + "smithy.api#http": { + "method": "PATCH", + "uri": "/configuration/{resourceIdentifier}", + "code": 200 + } + } + }, + "com.amazonaws.arczonalshift#UpdatePracticeRunConfigurationRequest": { + "type": "structure", + "members": { + "resourceIdentifier": { + "target": "com.amazonaws.arczonalshift#ResourceIdentifier", + "traits": { + "smithy.api#documentation": "The identifier for the resource that you want to update the practice\n\t\t\trun configuration for. The identifier is the Amazon Resource Name (ARN) for the resource.
", + "smithy.api#httpLabel": {}, + "smithy.api#required": {} + } + }, + "blockedWindows": { + "target": "com.amazonaws.arczonalshift#BlockedWindows", + "traits": { + "smithy.api#documentation": "Add, change, or remove windows of days and times for when you can, optionally,\n\t\t\tblock Route 53 ARC from starting a practice run for a resource.
\nThe format for blocked windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind, when you specify dates,\n\t\t\tthat dates and times for practice runs are in UTC. Also, be aware of potential time adjustments \n\t\t\tthat might be required for daylight saving time differences. Separate multiple blocked windows \n\t\t\twith spaces.
\nFor example, say you run business report summaries three days a week. For\n\t\t\tthis scenario, you might set the following recurring days and times as blocked windows, \n\t\t\tfor example: MON-20:30-21:30 WED-20:30-21:30 \n\t\t\t\tFRI-20:30-21:30
.
Add, change, or remove blocked dates for a practice run in zonal autoshift.
\nOptionally, you can block practice runs for specific calendar dates.\n\t\t\tThe format for blocked dates is: YYYY-MM-DD. Keep in mind, when you specify dates,\n\t\t\tthat dates and times for practice runs are in UTC. Separate multiple blocked \n\t\t\tdates with spaces.
\nFor example, if you have an application update scheduled to launch on May 1, 2024, and \n\t\t\tyou don't want practice runs to shift traffic away at that time, you could set a blocked date \n\t\t\tfor 2024-05-01
.
Add, change, or remove the Amazon CloudWatch alarm that you optionally\n\t\t\tspecify as the blocking alarm for practice runs.
" + } + }, + "outcomeAlarms": { + "target": "com.amazonaws.arczonalshift#ControlConditions", + "traits": { + "smithy.api#documentation": "Specify a new the Amazon CloudWatch alarm as the outcome alarm for practice runs.
" + } + } + }, + "traits": { + "smithy.api#input": {}, + "smithy.api#references": [ + { + "resource": "com.amazonaws.arczonalshift#PracticeRunConfigurationResource" + } + ] + } + }, + "com.amazonaws.arczonalshift#UpdatePracticeRunConfigurationResponse": { + "type": "structure", + "members": { + "arn": { + "target": "com.amazonaws.arczonalshift#ResourceArn", + "traits": { + "smithy.api#documentation": "The Amazon Resource Name (ARN) of the resource that you updated the practice \n\t\t\trun for.
", + "smithy.api#required": {} + } + }, + "name": { + "target": "com.amazonaws.arczonalshift#ResourceName", + "traits": { + "smithy.api#documentation": "The name of the resource that you updated the practice \n\t\t\trun for.
", + "smithy.api#required": {} + } + }, + "zonalAutoshiftStatus": { + "target": "com.amazonaws.arczonalshift#ZonalAutoshiftStatus", + "traits": { + "smithy.api#documentation": "The zonal autoshift status for the resource that you updated the practice\n\t\trun for.
", + "smithy.api#required": {} + } + }, + "practiceRunConfiguration": { + "target": "com.amazonaws.arczonalshift#PracticeRunConfiguration", + "traits": { + "smithy.api#documentation": "The practice run configuration that was updated.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#output": {} + } + }, + "com.amazonaws.arczonalshift#UpdateZonalAutoshiftConfiguration": { + "type": "operation", + "input": { + "target": "com.amazonaws.arczonalshift#UpdateZonalAutoshiftConfigurationRequest" + }, + "output": { + "target": "com.amazonaws.arczonalshift#UpdateZonalAutoshiftConfigurationResponse" + }, + "errors": [ + { + "target": "com.amazonaws.arczonalshift#AccessDeniedException" + }, + { + "target": "com.amazonaws.arczonalshift#ConflictException" + }, + { + "target": "com.amazonaws.arczonalshift#InternalServerException" + }, + { + "target": "com.amazonaws.arczonalshift#ResourceNotFoundException" + }, + { + "target": "com.amazonaws.arczonalshift#ThrottlingException" + }, + { + "target": "com.amazonaws.arczonalshift#ValidationException" + } + ], + "traits": { + "smithy.api#documentation": "You can update the zonal autoshift status for a resource, to enable or disable zonal\n\t\t\tautoshift. When zonal autoshift is ENABLED
, Amazon Web Services shifts away \n\t\t\tresource traffic from an Availability Zone, on your behalf, when Amazon Web Services\n\t\t\tdetermines that there's an issue in the Availability Zone that could potentially affect customers.
The identifier for the resource that you want to update the zonal autoshift\n\t\t\tconfiguration for. The identifier is the Amazon Resource Name (ARN) for the resource.
", + "smithy.api#httpLabel": {}, + "smithy.api#required": {} + } + }, + "zonalAutoshiftStatus": { + "target": "com.amazonaws.arczonalshift#ZonalAutoshiftStatus", + "traits": { + "smithy.api#documentation": "The zonal autoshift status for the resource that you want to update the zonal\n\t\t\tautoshift configuration for.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#input": {} + } + }, + "com.amazonaws.arczonalshift#UpdateZonalAutoshiftConfigurationResponse": { + "type": "structure", + "members": { + "resourceIdentifier": { + "target": "com.amazonaws.arczonalshift#ResourceIdentifier", + "traits": { + "smithy.api#documentation": "The identifier for the resource that you updated the zonal autoshift\n\t\t\tconfiguration for. The identifier is the Amazon Resource Name (ARN) for the resource.
", + "smithy.api#required": {} + } + }, + "zonalAutoshiftStatus": { + "target": "com.amazonaws.arczonalshift#ZonalAutoshiftStatus", + "traits": { + "smithy.api#documentation": "The zonal autoshift status for the resource that you updated the zonal\n\t\t\tautoshift configuration for.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#output": {} + } + }, "com.amazonaws.arczonalshift#UpdateZonalShift": { "type": "operation", "input": { @@ -1380,7 +2260,7 @@ } ], "traits": { - "smithy.api#documentation": "Update an active zonal shift in Amazon Route 53 Application Recovery Controller in your AWS account. You can update a zonal shift to set a new expiration, or \n \tedit or replace the comment for the zonal shift.
", + "smithy.api#documentation": "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 \n \tedit or replace the comment for the zonal shift.
", "smithy.api#http": { "method": "PATCH", "uri": "/zonalshifts/{zonalShiftId}", @@ -1408,7 +2288,7 @@ "expiresIn": { "target": "com.amazonaws.arczonalshift#ExpiresIn", "traits": { - "smithy.api#documentation": "The length of time that you want a zonal shift to be active, which Route 53 ARC converts to an expiry time (expiration time).\n \t\tZonal shifts are temporary. You can set a zonal shift to be active initially for up to three days (72 hours).
\n \tIf you want to still keep traffic away from an Availability Zone, you can update the \n \t\tzonal shift and set a new expiration. You can also cancel a zonal shift, before it expires, for example, if you're ready to \n \t\trestore traffic to the Availability Zone.
\n \tTo 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:
\n \t\n A lowercase letter m: To specify that the value is in minutes.
\n\n A lowercase letter h: To specify that the value is in hours.
\nFor example: 20h
means the zonal shift expires in 20 hours. 120m
means the zonal shift expires in 120 minutes (2 hours).
The length of time that you want a zonal shift to be active, which Route 53 ARC converts to an expiry time (expiration time).\n \t\tZonal shifts are temporary. You can set a zonal shift to be active initially for up to three days (72 hours).
\nIf you want to still keep traffic away from an Availability Zone, you can update the \n \t\tzonal shift and set a new expiration. You can also cancel a zonal shift, before it expires, for example, if you're ready to \n \t\trestore traffic to the Availability Zone.
\nTo 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:
\n\n A lowercase letter m: To specify that the value is in minutes.
\n\n A lowercase letter h: To specify that the value is in hours.
\nFor example: 20h
means the zonal shift expires in 20 hours. 120m
means the zonal shift expires in 120 minutes (2 hours).
The input fails to satisfy the constraints specified by an AWS service.
", + "smithy.api#documentation": "The input fails to satisfy the constraints specified by an Amazon Web Services service.
", "smithy.api#error": "client", "smithy.api#httpError": 400 } @@ -1475,6 +2355,18 @@ { "value": "UnsupportedAz", "name": "UNSUPPORTED_AZ" + }, + { + "value": "InvalidAlarmCondition", + "name": "INVALID_ALARM_CONDITION" + }, + { + "value": "InvalidConditionType", + "name": "INVALID_CONDITION_TYPE" + }, + { + "value": "InvalidPracticeBlocker", + "name": "INVALID_PRACTICE_BLOCKER" } ] } @@ -1483,8 +2375,25 @@ "type": "float", "traits": { "smithy.api#range": { - "min": 0, - "max": 1 + "min": 0.0, + "max": 1.0 + } + } + }, + "com.amazonaws.arczonalshift#ZonalAutoshiftStatus": { + "type": "enum", + "members": { + "ENABLED": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "ENABLED" + } + }, + "DISABLED": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "DISABLED" + } } } }, @@ -1501,35 +2410,35 @@ "resourceIdentifier": { "target": "com.amazonaws.arczonalshift#ResourceIdentifier", "traits": { - "smithy.api#documentation": "The identifier for the resource to include in a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\n\t\tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", + "smithy.api#documentation": "The identifier for the resource to shift away traffic for. The identifier is the Amazon Resource Name (ARN) for the resource.
\nAt this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", "smithy.api#required": {} } }, "awayFrom": { "target": "com.amazonaws.arczonalshift#AvailabilityZone", "traits": { - "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n\t\t\tUntil the zonal shift expires or you cancel it, traffic for the resource is instead moved to other Availability Zones in the AWS Region.
", + "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n\t\t\tUntil 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.
", "smithy.api#required": {} } }, "expiryTime": { "target": "com.amazonaws.arczonalshift#ExpiryTime", "traits": { - "smithy.api#documentation": "The expiry time (expiration time) for the zonal shift. A zonal shift is temporary and must be set to expire when you start the zonal shift. \n\t\t\tYou can initially set a zonal shift to expire in a maximum of three days (72 hours). However, you can update a zonal shift \n\t\t\tto set a new expiration at any time.
\n\t\tWhen you start a zonal shift, you specify how long you want it to be active, which Route 53 ARC converts \n\t\t\tto an expiry time (expiration time). You can cancel a zonal shift, for example, if you're ready to restore traffic to the Availability Zone. Or you\n\t\t\tcan update the zonal shift to specify another length of time to expire in.
", + "smithy.api#documentation": "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. \n\t\t\tYou can initially set a zonal shift to expire in a maximum of three days (72 hours). However, you can update a zonal shift \n\t\t\tto set a new expiration at any time.
\nWhen you start a zonal shift, you specify how long you want it to be active, which Route 53 ARC converts \n\t\t\tto an expiry time (expiration time). You can cancel a zonal shift when you're ready to restore traffic to the Availability Zone, or\n\t\t\tjust wait for it to expire. Or you can update the zonal shift to specify another length of time to expire in.
", "smithy.api#required": {} } }, "startTime": { "target": "com.amazonaws.arczonalshift#StartTime", "traits": { - "smithy.api#documentation": "The time (UTC) when the zonal shift is started.
", + "smithy.api#documentation": "The time (UTC) when the zonal shift starts.
", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.arczonalshift#ZonalShiftStatus", "traits": { - "smithy.api#documentation": "A status for a zonal shift.
\n \tThe Status
for a zonal shift can have one of the following values:
\n ACTIVE: The zonal shift is started and active.
\n\n EXPIRED: The zonal shift has expired (the expiry time was exceeded).
\n\n CANCELED: The zonal shift was canceled.
\nA status for a zonal shift.
\nThe Status
for a zonal shift can have one of the following values:
\n ACTIVE: The zonal shift has been started and active.
\n\n EXPIRED: The zonal shift has expired (the expiry time was exceeded).
\n\n CANCELED: The zonal shift was canceled.
\nAn appliedStatus
for a zonal shift for a resource can have one of two values: APPLIED
\n \t\tor NOT_APPLIED
.
The appliedStatus
field specifies which application traffic shift is in effect for a\n \t\tresource when there is more than one traffic shift active. There can be more than one application traffic \n \t\tshift in progress at the same time - that is, practice run zonal shifts, customer-started zonal shifts, \n \t\tor an autoshift. The appliedStatus
field for an autoshift for a resource can have one of two \n \t\tvalues: APPLIED
or NOT_APPLIED
. The zonal shift or autoshift \n \t\tthat 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 \n \t\tautoshifts, which take precedence over practice runs. That is, customer-started zonal shifts > autoshifts > practice run \n \t\tzonal shifts.
\nFor more information, see \n \t\tHow zonal autoshift \n \t\t\tand practice runs work in the Amazon Route 53 Application Recovery Controller Developer Guide.
", "smithy.api#required": {} } }, @@ -1580,28 +2489,28 @@ "resourceIdentifier": { "target": "com.amazonaws.arczonalshift#ResourceIdentifier", "traits": { - "smithy.api#documentation": "The identifier for the resource to include in a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\n \tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", + "smithy.api#documentation": "The identifier for the resource to include in a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\nAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", "smithy.api#required": {} } }, "awayFrom": { "target": "com.amazonaws.arczonalshift#AvailabilityZone", "traits": { - "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n \t\tUntil the zonal shift expires or you cancel it, traffic for the resource is instead moved to other Availability Zones in the AWS Region.
", + "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n \t\tUntil 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.
", "smithy.api#required": {} } }, "expiryTime": { "target": "com.amazonaws.arczonalshift#ExpiryTime", "traits": { - "smithy.api#documentation": "The expiry time (expiration time) for the zonal shift. A zonal shift is temporary and must be set to expire when you start the zonal shift. \n \t\tYou can initially set a zonal shift to expire in a maximum of three days (72 hours). However, you can update a zonal shift \n \t\tto set a new expiration at any time.
\n \tWhen you start a zonal shift, you specify how long you want it to be active, which Route 53 ARC converts \n \t\tto an expiry time (expiration time). You can cancel a zonal shift, for example, if you're ready to restore traffic to the Availability Zone. Or you\n \t\tcan update the zonal shift to specify another length of time to expire in.
", + "smithy.api#documentation": "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. \n \t\tYou can initially set a zonal shift to expire in a maximum of three days (72 hours). However, you can update a zonal shift \n \t\tto set a new expiration at any time.
\nWhen you start a zonal shift, you specify how long you want it to be active, which Route 53 ARC converts \n \t\tto an expiry time (expiration time). You can cancel a zonal shift when you're ready to restore traffic to the Availability Zone, or\n \t\tjust wait for it to expire. Or you can update the zonal shift to specify another length of time to expire in.
", "smithy.api#required": {} } }, "startTime": { "target": "com.amazonaws.arczonalshift#StartTime", "traits": { - "smithy.api#documentation": "The time (UTC) when the zonal shift is started.
", + "smithy.api#documentation": "The time (UTC) when the zonal shift starts.
", "smithy.api#required": {} } }, @@ -1611,6 +2520,12 @@ "smithy.api#documentation": "A comment that you enter about the zonal shift. Only the latest comment is retained; no comment\n \t\thistory is maintained. That is, a new comment overwrites any existing comment string.
", "smithy.api#required": {} } + }, + "practiceRunOutcome": { + "target": "com.amazonaws.arczonalshift#PracticeRunOutcome", + "traits": { + "smithy.api#documentation": "The outcome, or end state, returned for a practice run. The following values can be returned:
\n\n PENDING: Outcome value when a practice run is in progress.
\n\n SUCCEEDED: Outcome value when the outcome alarm specified for \n\t\t\t\tthe practice run configuration does not go into an ALARM
state during the practice run, and the practice run \n\t\t\t\twas not interrupted before it completed the expected 30 minute zonal shift.
\n INTERRUPTED: Outcome value when the practice run was stopped before the\n\t\t\t\texpected 30 minute zonal shift duration, or there was another problem with the practice run that created an inconclusive outcome.
\n\n FAILED: Outcome value when the outcome alarm specified for \n\t\t\t\tthe practice run configuration goes into an ALARM
state during the practice run, and the practice run \n\t\t\t\twas not interrupted before it completed.
For more information about practice run outcomes, see \n\t\t\t\n\t\t\t\tConsiderations when you configure zonal autoshift in the Amazon Route 53 Application Recovery Controller Developer Guide.
" + } } }, "traits": { @@ -1675,35 +2590,35 @@ "resourceIdentifier": { "target": "com.amazonaws.arczonalshift#ResourceIdentifier", "traits": { - "smithy.api#documentation": "The identifier for the resource to include in a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\n \tAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", + "smithy.api#documentation": "The identifier for the resource to include in a zonal shift. The identifier is the Amazon Resource Name (ARN) for the resource.
\nAt this time, you can only start a zonal shift for Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
", "smithy.api#required": {} } }, "awayFrom": { "target": "com.amazonaws.arczonalshift#AvailabilityZone", "traits": { - "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n \t\tUntil the zonal shift expires or you cancel it, traffic for the resource is instead moved to other Availability Zones in the AWS Region.
", + "smithy.api#documentation": "The Availability Zone that traffic is moved away from for a resource when you start a zonal shift. \n \t\tUntil 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.
", "smithy.api#required": {} } }, "expiryTime": { "target": "com.amazonaws.arczonalshift#ExpiryTime", "traits": { - "smithy.api#documentation": "The expiry time (expiration time) for the zonal shift. A zonal shift is temporary and must be set to expire when you start the zonal shift. \n \t\tYou can initially set a zonal shift to expire in a maximum of three days (72 hours). However, you can update a zonal shift \n \t\tto set a new expiration at any time.
\n \tWhen you start a zonal shift, you specify how long you want it to be active, which Route 53 ARC converts \n \t\tto an expiry time (expiration time). You can cancel a zonal shift, for example, if you're ready to restore traffic to the Availability Zone. Or you\n \t\tcan update the zonal shift to specify another length of time to expire in.
", + "smithy.api#documentation": "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. \n \t\tYou can initially set a zonal shift to expire in a maximum of three days (72 hours). However, you can update a zonal shift \n \t\tto set a new expiration at any time.
\nWhen you start a zonal shift, you specify how long you want it to be active, which Route 53 ARC converts \n \t\tto an expiry time (expiration time). You can cancel a zonal shift when you're ready to restore traffic to the Availability Zone, or\n \t\tjust wait for it to expire. Or you can update the zonal shift to specify another length of time to expire in.
", "smithy.api#required": {} } }, "startTime": { "target": "com.amazonaws.arczonalshift#StartTime", "traits": { - "smithy.api#documentation": "The time (UTC) when the zonal shift is started.
", + "smithy.api#documentation": "The time (UTC) when the zonal shift starts.
", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.arczonalshift#ZonalShiftStatus", "traits": { - "smithy.api#documentation": "A status for a zonal shift.
\n \tThe Status
for a zonal shift can have one of the following values:
\n ACTIVE: The zonal shift is started and active.
\n\n EXPIRED: The zonal shift has expired (the expiry time was exceeded).
\n\n CANCELED: The zonal shift was canceled.
\nA status for a zonal shift.
\nThe Status
for a zonal shift can have one of the following values:
\n ACTIVE: The zonal shift has been started and active.
\n\n EXPIRED: The zonal shift has expired (the expiry time was exceeded).
\n\n CANCELED: The zonal shift was canceled.
\nA comment that you enter about the zonal shift. Only the latest comment is retained; no comment\n \t\thistory is maintained. That is, a new comment overwrites any existing comment string.
", "smithy.api#required": {} } + }, + "practiceRunOutcome": { + "target": "com.amazonaws.arczonalshift#PracticeRunOutcome", + "traits": { + "smithy.api#documentation": "The outcome, or end state, of a practice run. The following values can be returned:
\n\n PENDING: Outcome value when the practice run is in progress.
\n\n SUCCEEDED: Outcome value when the outcome alarm specified for \n\t\t\t\tthe practice run configuration does not go into an ALARM
state during the practice run, and the practice run \n\t\t\t\twas not interrupted before it completed.
\n INTERRUPTED: Outcome value when the practice run did not run for the\n\t\t\t\texpected 30 minutes or there was another problem with the practice run that created an inconclusive outcome.
\n\n FAILED: Outcome value when the outcome alarm specified for \n\t\t\t\tthe practice run configuration goes into an ALARM
state during the practice run, and the practice run \n\t\t\t\twas not interrupted before it completed.
For more information about practice run outcomes, see \n\t\t\t\n\t\t\t\tConsiderations when you configure zonal autoshift in the Amazon Route 53 Application Recovery Controller Developer Guide.
" + } } }, "traits": { - "smithy.api#documentation": "You start a zonal shift to temporarily move load balancer traffic away from an Availability Zone in a AWS Region.\n \t\tA zonal shift helps your application recover immediately, for example, from a developer's bad code deployment or from an AWS \n \t\tinfrastructure failure in a single Availability Zone. You can start a zonal shift in Route 53 ARC only for managed\n \t\tresources in your account in an AWS Region. Supported AWS resources are automatically registered with Route 53 ARC.
\n \tZonal shifts are temporary. A zonal shift can be active for up to three days (72 hours).
\n \tWhen you start a zonal shift, you specify how long you want it to be active, which Amazon Route 53 Application Recovery Controller converts \n \t\tto an expiry time (expiration time). You can cancel a zonal shift, for example, if you're ready to restore traffic to the Availability Zone. Or you\n \t\tcan extend the zonal shift by updating the expiration so the zonal shift is active longer.
" + "smithy.api#documentation": "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\n \t\ton your behalf for practice runs with zonal autoshift.
\nZonal shifts are temporary, including customer-started zonal shifts and the zonal autoshift practice run zonal shifts that\n \t\tRoute 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\n \t\tpractice run zonal shift has a 30 minute duration.
" } }, "com.amazonaws.arczonalshift#ZonalShifts": {