aws-sdk-arczonalshift 1.18.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f45eb293167e5d37f802f39c2ddf63f38c5e3b67e179056282790c24826b5d69
-  data.tar.gz: 31829da6c866829e83ddeb3c358873c1d90b98c3326fe17312f5e1e088c7923e
+  metadata.gz: 68b6ed972ec9ee2167d90d46106d744ca0565fbe00b5d7dc5c2c57282203a599
+  data.tar.gz: fd50e7809284074ee0083d4fa8f65048a533a4a546aecaf1d3e440a81db24887
 SHA512:
-  metadata.gz: effbf2338ba350a14df8876e3afa8fba035fe3d914a5efcf5615ce461cafd4001f73571e7db2e6a093f0b00e573ee916c6adfb9bc9c9ab12666c495f07382156
-  data.tar.gz: 967feef037205eff0310f37c5ede052387e0a147855c9c89ce98e039aa32ff6a4b071c9b347e77a8db0d5a913ef7bcdc7b6b5c97fb23abae0c69dfd4c184d855
+  metadata.gz: 36a6be214f7af5aacf71f6585520a4ca457b271090ee2ff1c9ec7e55cc944401ad171dfd73e32c853f636bc57783ca53c5d6dfb88608d4ff0ab88948e6f00fc7
+  data.tar.gz: 69570ac76b7f414ecec3ce97109ae85d1af0dc5a070edf1e142c51ae918adf250069b9164438e84b2e6228caf149d4f8bcb8ce0cfc8277e14dc19a280b7c853d

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.19.0 (2024-07-12)
+------------------
+
+* Feature - Adds the option to subscribe to get notifications when a zonal autoshift occurs in a region.
+
 1.18.0 (2024-07-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.18.0
+1.19.0

data/lib/aws-sdk-arczonalshift/client.rb

@@ -478,6 +478,11 @@ module Aws::ARCZonalShift
     # application health during practice runs and, optionally, a *blocking
     # alarm*, to block practice runs from starting.
     #
+    # When a resource has a practice run configuration, Route 53 ARC starts
+    # zonal shifts for the resource weekly, to shift traffic for practice
+    # runs. Practice runs help you to ensure that shifting away traffic from
+    # an Availability Zone during an autoshift is safe for your application.
+    #
     # For more information, see [ Considerations when you configure zonal
     # autoshift][1] in the Amazon Route 53 Application Recovery Controller
     # Developer Guide.
@@ -532,8 +537,8 @@ module Aws::ARCZonalShift
     #   Availability Zone.
     #
     # @option params [required, String] :resource_identifier
-    #   The identifier of the resource to shift away traffic for when a
-    #   practice run starts a zonal shift. The identifier is the Amazon
+    #   The identifier of the resource that Amazon Web Services shifts traffic
+    #   for with a practice run zonal shift. The identifier is the Amazon
     #   Resource Name (ARN) for the resource.
     #
     #   At this time, supported resources are Network Load Balancers and
@@ -628,6 +633,41 @@ module Aws::ARCZonalShift
       req.send_request(options)
     end
 
+    # Returns the status of autoshift observer notification. Autoshift
+    # observer notification enables you to be notified, through Amazon
+    # EventBridge, when there is an autoshift event for zonal autoshift.
+    #
+    # If the status is `ENABLED`, Route 53 ARC includes all autoshift events
+    # when you use the EventBridge pattern `Autoshift In Progress`. When the
+    # status is `DISABLED`, Route 53 ARC includes only autoshift events for
+    # autoshifts when one or more of your resources is included in the
+    # autoshift.
+    #
+    # For more information, see [ Notifications for practice runs and
+    # autoshifts][1] in the Amazon Route 53 Application Recovery Controller
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.how-it-works.html#ZAShiftNotification
+    #
+    # @return [Types::GetAutoshiftObserverNotificationStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetAutoshiftObserverNotificationStatusResponse#status #status} => String
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "ENABLED", "DISABLED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/GetAutoshiftObserverNotificationStatus AWS API Documentation
+    #
+    # @overload get_autoshift_observer_notification_status(params = {})
+    # @param [Hash] params ({})
+    def get_autoshift_observer_notification_status(params = {}, options = {})
+      req = build_request(:get_autoshift_observer_notification_status, params)
+      req.send_request(options)
+    end
+
     # 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
@@ -639,8 +679,9 @@ module Aws::ARCZonalShift
     # with cross-zone load balancing turned off.
     #
     # @option params [required, String] :resource_identifier
-    #   The identifier for the resource to shift away traffic for. The
-    #   identifier is the Amazon Resource Name (ARN) for the resource.
+    #   The identifier for the resource that Amazon Web Services shifts
+    #   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.
@@ -701,7 +742,9 @@ module Aws::ARCZonalShift
       req.send_request(options)
     end
 
-    # Returns the active autoshifts for a specified resource.
+    # Returns a list of autoshifts for an Amazon Web Services Region. By
+    # default, the call returns only `ACTIVE` autoshifts. Optionally, you
+    # can specify the `status` parameter to return `COMPLETED` autoshifts.
     #
     # @option params [Integer] :max_results
     #   The number of objects that you want to return with this call.
@@ -818,7 +861,7 @@ module Aws::ARCZonalShift
     # Lists all active and completed zonal shifts in Amazon Route 53
     # Application Recovery Controller in your Amazon Web Services account in
     # this Amazon Web Services Region. `ListZonalShifts` returns
-    # customer-started zonal shifts, as well as practice run zonal shifts
+    # customer-initiated zonal shifts, as well as practice run zonal shifts
     # that Route 53 ARC started on your behalf for zonal autoshift.
     #
     # The `ListZonalShifts` operation does not list autoshifts. For more
@@ -920,10 +963,10 @@ module Aws::ARCZonalShift
     # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-shift.html
     #
     # @option params [required, String] :away_from
-    #   The Availability Zone that traffic is moved away from for a resource
-    #   when you start a zonal shift. Until the zonal shift expires or you
-    #   cancel it, traffic for the resource is instead moved to other
-    #   Availability Zones in the Amazon Web Services Region.
+    #   The Availability Zone (for example, `use1-az1`) that traffic is moved
+    #   away from for a resource when you start a zonal shift. Until the zonal
+    #   shift expires or you cancel it, traffic for the resource is instead
+    #   moved to other Availability Zones in the Amazon Web Services Region.
     #
     # @option params [required, String] :comment
     #   A comment that you enter about the zonal shift. Only the latest
@@ -952,8 +995,9 @@ module Aws::ARCZonalShift
     #   means the zonal shift expires in 120 minutes (2 hours).
     #
     # @option params [required, String] :resource_identifier
-    #   The identifier for the resource to shift away traffic for. The
-    #   identifier is the Amazon Resource Name (ARN) for the resource.
+    #   The identifier for the resource that Amazon Web Services shifts
+    #   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.
@@ -996,6 +1040,55 @@ module Aws::ARCZonalShift
       req.send_request(options)
     end
 
+    # Update the status of autoshift observer notification. Autoshift
+    # observer notification enables you to be notified, through Amazon
+    # EventBridge, when there is an autoshift event for zonal autoshift.
+    #
+    # If the status is `ENABLED`, Route 53 ARC includes all autoshift events
+    # when you use the EventBridge pattern `Autoshift In Progress`. When the
+    # status is `DISABLED`, Route 53 ARC includes only autoshift events for
+    # autoshifts when one or more of your resources is included in the
+    # autoshift.
+    #
+    # For more information, see [ Notifications for practice runs and
+    # autoshifts][1] in the Amazon Route 53 Application Recovery Controller
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.how-it-works.html#ZAShiftNotification
+    #
+    # @option params [required, String] :status
+    #   The status to set for autoshift observer notification. If the status
+    #   is `ENABLED`, Route 53 ARC includes all autoshift events when you use
+    #   the Amazon EventBridge pattern `Autoshift In Progress`. When the
+    #   status is `DISABLED`, Route 53 ARC includes only autoshift events for
+    #   autoshifts when one or more of your resources is included in the
+    #   autoshift.
+    #
+    # @return [Types::UpdateAutoshiftObserverNotificationStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateAutoshiftObserverNotificationStatusResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_autoshift_observer_notification_status({
+    #     status: "ENABLED", # required, accepts ENABLED, DISABLED
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "ENABLED", "DISABLED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateAutoshiftObserverNotificationStatus AWS API Documentation
+    #
+    # @overload update_autoshift_observer_notification_status(params = {})
+    # @param [Hash] params ({})
+    def update_autoshift_observer_notification_status(params = {}, options = {})
+      req = build_request(:update_autoshift_observer_notification_status, params)
+      req.send_request(options)
+    end
+
     # 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
@@ -1095,12 +1188,20 @@ module Aws::ARCZonalShift
       req.send_request(options)
     end
 
-    # You can update the zonal autoshift status for a resource, to enable or
-    # disable zonal autoshift. When zonal autoshift is `ENABLED`, Amazon Web
-    # Services shifts away resource traffic from an Availability Zone, on
-    # your behalf, when Amazon Web Services determines that there's an
-    # issue in the Availability Zone that could potentially affect
-    # customers.
+    # The zonal autoshift configuration for a resource includes the practice
+    # run configuration and the status for running autoshifts, zonal
+    # autoshift status. When a resource has a practice run configuation,
+    # Route 53 ARC starts weekly zonal shifts for the resource, to shift
+    # traffic away from an Availability Zone. Weekly practice runs help you
+    # to make sure that your application can continue to operate normally
+    # with the loss of one Availability Zone.
+    #
+    # You can update the zonal autoshift autoshift status to enable or
+    # disable zonal autoshift. When zonal autoshift is `ENABLED`, you
+    # authorize Amazon Web Services to shift away resource traffic for an
+    # application from an Availability Zone during events, on your behalf,
+    # to help reduce time to recovery. Traffic is also shifted away for the
+    # required weekly practice runs.
     #
     # @option params [required, String] :resource_identifier
     #   The identifier for the resource that you want to update the zonal
@@ -1109,7 +1210,10 @@ module Aws::ARCZonalShift
     #
     # @option params [required, String] :zonal_autoshift_status
     #   The zonal autoshift status for the resource that you want to update
-    #   the zonal autoshift configuration for.
+    #   the zonal autoshift configuration for. Choose `ENABLED` to authorize
+    #   Amazon Web Services to shift away resource traffic for an application
+    #   from an Availability Zone during events, on your behalf, to help
+    #   reduce time to recovery.
     #
     # @return [Types::UpdateZonalAutoshiftConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1221,7 +1325,7 @@ module Aws::ARCZonalShift
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-arczonalshift'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-arczonalshift/client_api.rb

@@ -19,6 +19,7 @@ module Aws::ARCZonalShift
     AutoshiftAppliedStatus = Shapes::StringShape.new(name: 'AutoshiftAppliedStatus')
     AutoshiftExecutionStatus = Shapes::StringShape.new(name: 'AutoshiftExecutionStatus')
     AutoshiftInResource = Shapes::StructureShape.new(name: 'AutoshiftInResource')
+    AutoshiftObserverNotificationStatus = Shapes::StringShape.new(name: 'AutoshiftObserverNotificationStatus')
     AutoshiftSummaries = Shapes::ListShape.new(name: 'AutoshiftSummaries')
     AutoshiftSummary = Shapes::StructureShape.new(name: 'AutoshiftSummary')
     AutoshiftsInResource = Shapes::ListShape.new(name: 'AutoshiftsInResource')
@@ -40,6 +41,8 @@ module Aws::ARCZonalShift
     DeletePracticeRunConfigurationResponse = Shapes::StructureShape.new(name: 'DeletePracticeRunConfigurationResponse')
     ExpiresIn = Shapes::StringShape.new(name: 'ExpiresIn')
     ExpiryTime = Shapes::TimestampShape.new(name: 'ExpiryTime')
+    GetAutoshiftObserverNotificationStatusRequest = Shapes::StructureShape.new(name: 'GetAutoshiftObserverNotificationStatusRequest')
+    GetAutoshiftObserverNotificationStatusResponse = Shapes::StructureShape.new(name: 'GetAutoshiftObserverNotificationStatusResponse')
     GetManagedResourceRequest = Shapes::StructureShape.new(name: 'GetManagedResourceRequest')
     GetManagedResourceResponse = Shapes::StructureShape.new(name: 'GetManagedResourceResponse')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
@@ -62,6 +65,8 @@ module Aws::ARCZonalShift
     StartZonalShiftRequest = Shapes::StructureShape.new(name: 'StartZonalShiftRequest')
     String = Shapes::StringShape.new(name: 'String')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
+    UpdateAutoshiftObserverNotificationStatusRequest = Shapes::StructureShape.new(name: 'UpdateAutoshiftObserverNotificationStatusRequest')
+    UpdateAutoshiftObserverNotificationStatusResponse = Shapes::StructureShape.new(name: 'UpdateAutoshiftObserverNotificationStatusResponse')
     UpdatePracticeRunConfigurationRequest = Shapes::StructureShape.new(name: 'UpdatePracticeRunConfigurationRequest')
     UpdatePracticeRunConfigurationResponse = Shapes::StructureShape.new(name: 'UpdatePracticeRunConfigurationResponse')
     UpdateZonalAutoshiftConfigurationRequest = Shapes::StructureShape.new(name: 'UpdateZonalAutoshiftConfigurationRequest')
@@ -142,6 +147,11 @@ module Aws::ARCZonalShift
     DeletePracticeRunConfigurationResponse.add_member(:zonal_autoshift_status, Shapes::ShapeRef.new(shape: ZonalAutoshiftStatus, required: true, location_name: "zonalAutoshiftStatus"))
     DeletePracticeRunConfigurationResponse.struct_class = Types::DeletePracticeRunConfigurationResponse
 
+    GetAutoshiftObserverNotificationStatusRequest.struct_class = Types::GetAutoshiftObserverNotificationStatusRequest
+
+    GetAutoshiftObserverNotificationStatusResponse.add_member(:status, Shapes::ShapeRef.new(shape: AutoshiftObserverNotificationStatus, required: true, location_name: "status"))
+    GetAutoshiftObserverNotificationStatusResponse.struct_class = Types::GetAutoshiftObserverNotificationStatusResponse
+
     GetManagedResourceRequest.add_member(:resource_identifier, Shapes::ShapeRef.new(shape: ResourceIdentifier, required: true, location: "uri", location_name: "resourceIdentifier"))
     GetManagedResourceRequest.struct_class = Types::GetManagedResourceRequest
 
@@ -214,6 +224,12 @@ module Aws::ARCZonalShift
     ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
     ThrottlingException.struct_class = Types::ThrottlingException
 
+    UpdateAutoshiftObserverNotificationStatusRequest.add_member(:status, Shapes::ShapeRef.new(shape: AutoshiftObserverNotificationStatus, required: true, location_name: "status"))
+    UpdateAutoshiftObserverNotificationStatusRequest.struct_class = Types::UpdateAutoshiftObserverNotificationStatusRequest
+
+    UpdateAutoshiftObserverNotificationStatusResponse.add_member(:status, Shapes::ShapeRef.new(shape: AutoshiftObserverNotificationStatus, required: true, location_name: "status"))
+    UpdateAutoshiftObserverNotificationStatusResponse.struct_class = Types::UpdateAutoshiftObserverNotificationStatusResponse
+
     UpdatePracticeRunConfigurationRequest.add_member(:blocked_dates, Shapes::ShapeRef.new(shape: BlockedDates, location_name: "blockedDates"))
     UpdatePracticeRunConfigurationRequest.add_member(:blocked_windows, Shapes::ShapeRef.new(shape: BlockedWindows, location_name: "blockedWindows"))
     UpdatePracticeRunConfigurationRequest.add_member(:blocking_alarms, Shapes::ShapeRef.new(shape: ControlConditions, location_name: "blockingAlarms"))
@@ -285,9 +301,11 @@ module Aws::ARCZonalShift
 
       api.metadata = {
         "apiVersion" => "2022-10-30",
+        "auth" => ["aws.auth#sigv4"],
         "endpointPrefix" => "arc-zonal-shift",
         "jsonVersion" => "1.1",
         "protocol" => "rest-json",
+        "protocols" => ["rest-json"],
         "serviceFullName" => "AWS ARC - Zonal Shift",
         "serviceId" => "ARC Zonal Shift",
         "signatureVersion" => "v4",
@@ -337,6 +355,17 @@ module Aws::ARCZonalShift
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
       end)
 
+      api.add_operation(:get_autoshift_observer_notification_status, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetAutoshiftObserverNotificationStatus"
+        o.http_method = "GET"
+        o.http_request_uri = "/autoshift-observer-notification"
+        o.input = Shapes::ShapeRef.new(shape: GetAutoshiftObserverNotificationStatusRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetAutoshiftObserverNotificationStatusResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:get_managed_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetManagedResource"
         o.http_method = "GET"
@@ -418,6 +447,18 @@ module Aws::ARCZonalShift
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
       end)
 
+      api.add_operation(:update_autoshift_observer_notification_status, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateAutoshiftObserverNotificationStatus"
+        o.http_method = "PUT"
+        o.http_request_uri = "/autoshift-observer-notification"
+        o.input = Shapes::ShapeRef.new(shape: UpdateAutoshiftObserverNotificationStatusRequest)
+        o.output = Shapes::ShapeRef.new(shape: UpdateAutoshiftObserverNotificationStatusResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:update_practice_run_configuration, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdatePracticeRunConfiguration"
         o.http_method = "PATCH"

data/lib/aws-sdk-arczonalshift/endpoints.rb

@@ -54,6 +54,20 @@ module Aws::ARCZonalShift
       end
     end
 
+    class GetAutoshiftObserverNotificationStatus
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ARCZonalShift::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetManagedResource
       def self.build(context)
         unless context.config.regional_endpoint
@@ -124,6 +138,20 @@ module Aws::ARCZonalShift
       end
     end
 
+    class UpdateAutoshiftObserverNotificationStatus
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ARCZonalShift::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class UpdatePracticeRunConfiguration
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-arczonalshift/plugins/endpoints.rb

@@ -64,6 +64,8 @@ module Aws::ARCZonalShift
             Aws::ARCZonalShift::Endpoints::CreatePracticeRunConfiguration.build(context)
           when :delete_practice_run_configuration
             Aws::ARCZonalShift::Endpoints::DeletePracticeRunConfiguration.build(context)
+          when :get_autoshift_observer_notification_status
+            Aws::ARCZonalShift::Endpoints::GetAutoshiftObserverNotificationStatus.build(context)
           when :get_managed_resource
             Aws::ARCZonalShift::Endpoints::GetManagedResource.build(context)
           when :list_autoshifts
@@ -74,6 +76,8 @@ module Aws::ARCZonalShift
             Aws::ARCZonalShift::Endpoints::ListZonalShifts.build(context)
           when :start_zonal_shift
             Aws::ARCZonalShift::Endpoints::StartZonalShift.build(context)
+          when :update_autoshift_observer_notification_status
+            Aws::ARCZonalShift::Endpoints::UpdateAutoshiftObserverNotificationStatus.build(context)
           when :update_practice_run_configuration
             Aws::ARCZonalShift::Endpoints::UpdatePracticeRunConfiguration.build(context)
           when :update_zonal_autoshift_configuration

data/lib/aws-sdk-arczonalshift/types.rb

@@ -36,18 +36,18 @@ module Aws::ARCZonalShift
     #
     # @!attribute [rw] applied_status
     #   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
+    #   is in effect for a resource when there is more than one active
+    #   traffic shift. 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`.
+    #   customer-initiated zonal shifts, or an autoshift. The
+    #   `appliedStatus` field for a shift that is in progress 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 `appliedStatus` 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
+    #   precedence over practice runs. That is, customer-initiated zonal
     #   shifts > autoshifts > practice run zonal shifts.
     #
     #   For more information, see [How zonal autoshift and practice runs
@@ -60,13 +60,13 @@ module Aws::ARCZonalShift
     #   @return [String]
     #
     # @!attribute [rw] away_from
-    #   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 Availability Zone (for example, `use1-az1`) 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.
     #   @return [String]
     #
     # @!attribute [rw] start_time
@@ -99,13 +99,13 @@ module Aws::ARCZonalShift
     # You can stop an autoshift for a resource by disabling zonal autoshift.
     #
     # @!attribute [rw] away_from
-    #   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 Availability Zone (for example, `use1-az1`) 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.
     #   @return [String]
     #
     # @!attribute [rw] end_time
@@ -173,7 +173,7 @@ module Aws::ARCZonalShift
     # 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.
+    # starting or to interrupt a practice run in progress.
     #
     # Control condition alarms do not apply for autoshifts.
     #
@@ -186,12 +186,13 @@ module Aws::ARCZonalShift
     # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/arc-zonal-autoshift.considerations.html
     #
     # @!attribute [rw] alarm_identifier
-    #   The Amazon Resource Name (ARN) for the Amazon CloudWatch alarm that
+    #   The Amazon Resource Name (ARN) for an Amazon CloudWatch alarm that
     #   you specify as a control condition for a practice run.
     #   @return [String]
     #
     # @!attribute [rw] type
-    #   The type of alarm specified for a practice run. The only valid value
+    #   The type of alarm specified for a practice run. You can only specify
+    #   Amazon CloudWatch alarms for practice runs, so the only valid value
     #   is `CLOUDWATCH`.
     #   @return [String]
     #
@@ -254,9 +255,9 @@ module Aws::ARCZonalShift
     #   @return [Array<Types::ControlCondition>]
     #
     # @!attribute [rw] resource_identifier
-    #   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.
+    #   The identifier of the resource that Amazon Web Services shifts
+    #   traffic for with a practice run 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
@@ -291,12 +292,12 @@ module Aws::ARCZonalShift
     #   @return [Types::PracticeRunConfiguration]
     #
     # @!attribute [rw] zonal_autoshift_status
-    #   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.
+    #   The status for zonal autoshift for a resource. When you specify
+    #   `ENABLED` for the autoshift status, Amazon Web Services shifts
+    #   traffic away from shifts away application resource traffic from an
+    #   Availability Zone, on your behalf, when internal telemetry indicates
+    #   that there is an Availability Zone impairment that could potentially
+    #   impact customers.
     #
     #   When you enable zonal autoshift, you must also configure practice
     #   runs for the resource.
@@ -350,9 +351,33 @@ module Aws::ARCZonalShift
       include Aws::Structure
     end
 
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/GetAutoshiftObserverNotificationStatusRequest AWS API Documentation
+    #
+    class GetAutoshiftObserverNotificationStatusRequest < Aws::EmptyStructure; end
+
+    # @!attribute [rw] status
+    #   The status of autoshift observer notification. If the status is
+    #   `ENABLED`, Route 53 ARC includes all autoshift events when you use
+    #   the Amazon EventBridge pattern `Autoshift In Progress`. When the
+    #   status is `DISABLED`, Route 53 ARC includes only autoshift events
+    #   for autoshifts when one or more of your resources is included in the
+    #   autoshift.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/GetAutoshiftObserverNotificationStatusResponse AWS API Documentation
+    #
+    class GetAutoshiftObserverNotificationStatusResponse < Struct.new(
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] resource_identifier
-    #   The identifier for the resource to shift away traffic for. The
-    #   identifier is the Amazon Resource Name (ARN) for the resource.
+    #   The identifier for the resource that Amazon Web Services shifts
+    #   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
@@ -658,7 +683,14 @@ module Aws::ARCZonalShift
 
     # 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.
+    # as any blocked dates or blocked windows for the practice run. When a
+    # resource has a practice run configuration, Route 53 ARC shifts traffic
+    # for the resource weekly for practice runs.
+    #
+    # Practice runs are required for zonal autoshift. The zonal shifts that
+    # Route 53 ARC starts for practice runs help you to ensure that shifting
+    # away traffic from an Availability Zone during an autoshift is safe for
+    # your application.
     #
     # You can update or delete a practice run configuration. Before you
     # delete a practice run configuration, you must disable zonal autoshift
@@ -718,10 +750,11 @@ module Aws::ARCZonalShift
     end
 
     # @!attribute [rw] away_from
-    #   The Availability Zone that traffic is moved away from for a resource
-    #   when you start a zonal shift. Until the zonal shift expires or you
-    #   cancel it, traffic for the resource is instead moved to other
-    #   Availability Zones in the Amazon Web Services Region.
+    #   The Availability Zone (for example, `use1-az1`) that traffic is
+    #   moved away from for a resource when you start a zonal shift. Until
+    #   the zonal shift expires or you cancel it, traffic for the resource
+    #   is instead moved to other Availability Zones in the Amazon Web
+    #   Services Region.
     #   @return [String]
     #
     # @!attribute [rw] comment
@@ -753,8 +786,9 @@ module Aws::ARCZonalShift
     #   @return [String]
     #
     # @!attribute [rw] resource_identifier
-    #   The identifier for the resource to shift away traffic for. The
-    #   identifier is the Amazon Resource Name (ARN) for the resource.
+    #   The identifier for the resource that Amazon Web Services shifts
+    #   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
@@ -785,6 +819,35 @@ module Aws::ARCZonalShift
       include Aws::Structure
     end
 
+    # @!attribute [rw] status
+    #   The status to set for autoshift observer notification. If the status
+    #   is `ENABLED`, Route 53 ARC includes all autoshift events when you
+    #   use the Amazon EventBridge pattern `Autoshift In Progress`. When the
+    #   status is `DISABLED`, Route 53 ARC includes only autoshift events
+    #   for autoshifts when one or more of your resources is included in the
+    #   autoshift.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateAutoshiftObserverNotificationStatusRequest AWS API Documentation
+    #
+    class UpdateAutoshiftObserverNotificationStatusRequest < Struct.new(
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] status
+    #   The status for autoshift observer notification.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateAutoshiftObserverNotificationStatusResponse AWS API Documentation
+    #
+    class UpdateAutoshiftObserverNotificationStatusResponse < Struct.new(
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] blocked_dates
     #   Add, change, or remove blocked dates for a practice run in zonal
     #   autoshift.
@@ -881,7 +944,10 @@ module Aws::ARCZonalShift
     #
     # @!attribute [rw] zonal_autoshift_status
     #   The zonal autoshift status for the resource that you want to update
-    #   the zonal autoshift configuration for.
+    #   the zonal autoshift configuration for. Choose `ENABLED` to authorize
+    #   Amazon Web Services to shift away resource traffic for an
+    #   application from an Availability Zone during events, on your behalf,
+    #   to help reduce time to recovery.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateZonalAutoshiftConfigurationRequest AWS API Documentation
@@ -900,8 +966,7 @@ module Aws::ARCZonalShift
     #   @return [String]
     #
     # @!attribute [rw] zonal_autoshift_status
-    #   The zonal autoshift status for the resource that you updated the
-    #   zonal autoshift configuration for.
+    #   The updated zonal autoshift status for the resource.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/arc-zonal-shift-2022-10-30/UpdateZonalAutoshiftConfigurationResponse AWS API Documentation
@@ -975,10 +1040,11 @@ module Aws::ARCZonalShift
     end
 
     # @!attribute [rw] away_from
-    #   The Availability Zone that traffic is moved away from for a resource
-    #   when you start a zonal shift. Until the zonal shift expires or you
-    #   cancel it, traffic for the resource is instead moved to other
-    #   Availability Zones in the Amazon Web Services Region.
+    #   The Availability Zone (for example, `use1-az1`) that traffic is
+    #   moved away from for a resource when you start a zonal shift. Until
+    #   the zonal shift expires or you cancel it, traffic for the resource
+    #   is instead moved to other Availability Zones in the Amazon Web
+    #   Services Region.
     #   @return [String]
     #
     # @!attribute [rw] comment
@@ -988,7 +1054,7 @@ module Aws::ARCZonalShift
     #   @return [String]
     #
     # @!attribute [rw] expiry_time
-    #   The expiry time (expiration time) for a customer-started zonal
+    #   The expiry time (expiration time) for a customer-initiated 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
@@ -1003,8 +1069,9 @@ module Aws::ARCZonalShift
     #   @return [Time]
     #
     # @!attribute [rw] resource_identifier
-    #   The identifier for the resource to shift away traffic for. The
-    #   identifier is the Amazon Resource Name (ARN) for the resource.
+    #   The identifier for the resource that Amazon Web Services shifts
+    #   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
@@ -1051,18 +1118,18 @@ module Aws::ARCZonalShift
     #
     # @!attribute [rw] applied_status
     #   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
+    #   is in effect for a resource when there is more than one active
+    #   traffic shift. 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`.
+    #   customer-initiated zonal shifts, or an autoshift. The
+    #   `appliedStatus` field for a shift that is in progress 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 `appliedStatus` 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
+    #   precedence over practice runs. That is, customer-initiated zonal
     #   shifts &gt; autoshifts &gt; practice run zonal shifts.
     #
     #   For more information, see [How zonal autoshift and practice runs
@@ -1075,20 +1142,21 @@ module Aws::ARCZonalShift
     #   @return [String]
     #
     # @!attribute [rw] away_from
-    #   The Availability Zone that traffic is moved away from for a resource
-    #   when you start a zonal shift. Until the zonal shift expires or you
-    #   cancel it, traffic for the resource is instead moved to other
-    #   Availability Zones in the Amazon Web Services Region.
+    #   The Availability Zone (for example, `use1-az1`) that traffic is
+    #   moved away from for a resource when you start a zonal shift. Until
+    #   the zonal shift expires or you cancel it, traffic for the resource
+    #   is instead moved to other Availability Zones in the Amazon Web
+    #   Services Region.
     #   @return [String]
     #
     # @!attribute [rw] comment
-    #   A comment that you enter about the zonal shift. Only the latest
-    #   comment is retained; no comment history is maintained. That is, a
-    #   new comment overwrites any existing comment string.
+    #   A comment that you enter for a customer-initiated zonal shift. Only
+    #   the latest comment is retained; no comment history is maintained.
+    #   That is, a new comment overwrites any existing comment string.
     #   @return [String]
     #
     # @!attribute [rw] expiry_time
-    #   The expiry time (expiration time) for a customer-started zonal
+    #   The expiry time (expiration time) for a customer-initiated 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
@@ -1169,17 +1237,18 @@ module Aws::ARCZonalShift
     # 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
+    # Zonal shifts are temporary, including customer-initiated 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.
     #
     # @!attribute [rw] away_from
-    #   The Availability Zone that traffic is moved away from for a resource
-    #   when you start a zonal shift. Until the zonal shift expires or you
-    #   cancel it, traffic for the resource is instead moved to other
-    #   Availability Zones in the Amazon Web Services Region.
+    #   The Availability Zone (for example, `use1-az1`) that traffic is
+    #   moved away from for a resource when you start a zonal shift. Until
+    #   the zonal shift expires or you cancel it, traffic for the resource
+    #   is instead moved to other Availability Zones in the Amazon Web
+    #   Services Region.
     #   @return [String]
     #
     # @!attribute [rw] comment
@@ -1189,7 +1258,7 @@ module Aws::ARCZonalShift
     #   @return [String]
     #
     # @!attribute [rw] expiry_time
-    #   The expiry time (expiration time) for a customer-started zonal
+    #   The expiry time (expiration time) for a customer-initiated 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

data/lib/aws-sdk-arczonalshift.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-arczonalshift/customizations'
 # @!group service
 module Aws::ARCZonalShift
 
-  GEM_VERSION = '1.18.0'
+  GEM_VERSION = '1.19.0'
 
 end

data/sig/client.rbs

@@ -128,6 +128,15 @@ module Aws
                                              ) -> _DeletePracticeRunConfigurationResponseSuccess
                                            | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DeletePracticeRunConfigurationResponseSuccess
 
+      interface _GetAutoshiftObserverNotificationStatusResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetAutoshiftObserverNotificationStatusResponse]
+        def status: () -> ("ENABLED" | "DISABLED")
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ARCZonalShift/Client.html#get_autoshift_observer_notification_status-instance_method
+      def get_autoshift_observer_notification_status: (
+                                                      ) -> _GetAutoshiftObserverNotificationStatusResponseSuccess
+                                                    | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetAutoshiftObserverNotificationStatusResponseSuccess
+
       interface _GetManagedResourceResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetManagedResourceResponse]
         def applied_weights: () -> ::Hash[::String, ::Float]
@@ -202,6 +211,16 @@ module Aws
                              ) -> _StartZonalShiftResponseSuccess
                            | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartZonalShiftResponseSuccess
 
+      interface _UpdateAutoshiftObserverNotificationStatusResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::UpdateAutoshiftObserverNotificationStatusResponse]
+        def status: () -> ("ENABLED" | "DISABLED")
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ARCZonalShift/Client.html#update_autoshift_observer_notification_status-instance_method
+      def update_autoshift_observer_notification_status: (
+                                                           status: ("ENABLED" | "DISABLED")
+                                                         ) -> _UpdateAutoshiftObserverNotificationStatusResponseSuccess
+                                                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateAutoshiftObserverNotificationStatusResponseSuccess
+
       interface _UpdatePracticeRunConfigurationResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::UpdatePracticeRunConfigurationResponse]
         def arn: () -> ::String

data/sig/types.rbs

@@ -75,6 +75,14 @@ module Aws::ARCZonalShift
       SENSITIVE: []
     end
 
+    class GetAutoshiftObserverNotificationStatusRequest < Aws::EmptyStructure
+    end
+
+    class GetAutoshiftObserverNotificationStatusResponse
+      attr_accessor status: ("ENABLED" | "DISABLED")
+      SENSITIVE: []
+    end
+
     class GetManagedResourceRequest
       attr_accessor resource_identifier: ::String
       SENSITIVE: []
@@ -173,6 +181,16 @@ module Aws::ARCZonalShift
       SENSITIVE: []
     end
 
+    class UpdateAutoshiftObserverNotificationStatusRequest
+      attr_accessor status: ("ENABLED" | "DISABLED")
+      SENSITIVE: []
+    end
+
+    class UpdateAutoshiftObserverNotificationStatusResponse
+      attr_accessor status: ("ENABLED" | "DISABLED")
+      SENSITIVE: []
+    end
+
     class UpdatePracticeRunConfigurationRequest
       attr_accessor blocked_dates: ::Array[::String]
       attr_accessor blocked_windows: ::Array[::String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-arczonalshift
 version: !ruby/object:Gem::Version
-  version: 1.18.0
+  version: 1.19.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-02 00:00:00.000000000 Z
+date: 2024-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -36,14 +36,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
 description: Official AWS Ruby gem for AWS ARC - Zonal Shift. This gem is part of
   the AWS SDK for Ruby.
 email: