aws-sdk-arcregionswitch 1.20.0 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d0e02408287749d07e1b77e20066024a05a0d7eb9f2d67bb8bcf1504ff085d8
-  data.tar.gz: 06037e20fa21bb2d59cb65a87e46d9831e2b444704fad15ea4916cdedb14d308
+  metadata.gz: 368c1498b076fed0b5885711fb70ae8e51a80b0dbb9cae793d70d220b600509c
+  data.tar.gz: ac069898d245d89f17c8911c56e82456e75c13a208a01de9f429db6b8cc5c5df
 SHA512:
-  metadata.gz: d65651490a0fb8e0b0ab18686b94caca7c017dd66914ea214c871f329e3eb444011a4add2d03ea509e39297365f4215a57d14afd55907d96496f197ea318d581
-  data.tar.gz: c3713a0903a10169eddfbc5cebc3ae9b013bbba573489c658dd4b7762b58f75d0f7fa48d9581a1918bdbea2da864e060d39c1aa02ce2767f4d275ddcd19d907d
+  metadata.gz: 7a95c0f5ddc3f8f6df0577580c315a3cc4df69cf811e710103454cf476aacabbaba036545073c035fa2492562e71c2a9aac58105046adab7b21b7e1557d7e69c
+  data.tar.gz: e586357e2eb3e89f64b0409e3d7618e1efe308404d57d944aec4dd7f48e3ceaae08e296b2418249998b1f7b31fe8369a332ca963d520f3ac6672babe5d5ec7eb

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.21.0 (2026-07-22)
+------------------
+
+* Feature - Adds support for a client token in StartPlanExecution to make plan execution requests idempotent for safe retries.
+
 1.20.0 (2026-07-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.20.0
+1.21.0

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

@@ -2202,6 +2202,21 @@ module Aws::ARCRegionswitch
     #   opposite region post-recovery is ran in. Required when starting a
     #   post-recovery execution.
     #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier to ensure that the operation
+    #   completes no more than one time. If this token matches a previous
+    #   request, the service ignores the request and returns the result of the
+    #   original successful request. If you don't provide a client token, the
+    #   service automatically generates one. For more information about
+    #   idempotency, see [Making retries safe with idempotent APIs][1].
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
     # @return [Types::StartPlanExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartPlanExecutionResponse#execution_id #execution_id} => String
@@ -2220,6 +2235,7 @@ module Aws::ARCRegionswitch
     #     comment: "ExecutionComment",
     #     latest_version: "String",
     #     recovery_execution_id: "RecoveryExecutionId",
+    #     client_token: "StartPlanExecutionRequestClientTokenString",
     #   })
     #
     # @example Response structure
@@ -2855,7 +2871,7 @@ module Aws::ARCRegionswitch
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-arcregionswitch'
-      context[:gem_version] = '1.20.0'
+      context[:gem_version] = '1.21.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -43,6 +43,7 @@ module Aws::ARCRegionswitch
     AuroraServerlessScalingConfigurationTimeoutMinutesInteger = Shapes::IntegerShape.new(name: 'AuroraServerlessScalingConfigurationTimeoutMinutesInteger')
     CancelPlanExecutionRequest = Shapes::StructureShape.new(name: 'CancelPlanExecutionRequest')
     CancelPlanExecutionResponse = Shapes::StructureShape.new(name: 'CancelPlanExecutionResponse')
+    ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     CreatePlanRequest = Shapes::StructureShape.new(name: 'CreatePlanRequest')
     CreatePlanRequestRecoveryTimeObjectiveMinutesInteger = Shapes::IntegerShape.new(name: 'CreatePlanRequestRecoveryTimeObjectiveMinutesInteger')
     CreatePlanResponse = Shapes::StructureShape.new(name: 'CreatePlanResponse')
@@ -217,6 +218,7 @@ module Aws::ARCRegionswitch
     Service = Shapes::StructureShape.new(name: 'Service')
     ServiceList = Shapes::ListShape.new(name: 'ServiceList')
     StartPlanExecutionRequest = Shapes::StructureShape.new(name: 'StartPlanExecutionRequest')
+    StartPlanExecutionRequestClientTokenString = Shapes::StringShape.new(name: 'StartPlanExecutionRequestClientTokenString')
     StartPlanExecutionResponse = Shapes::StructureShape.new(name: 'StartPlanExecutionResponse')
     Step = Shapes::StructureShape.new(name: 'Step')
     StepName = Shapes::StringShape.new(name: 'StepName')
@@ -347,6 +349,11 @@ module Aws::ARCRegionswitch
 
     CancelPlanExecutionResponse.struct_class = Types::CancelPlanExecutionResponse
 
+    ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
+    ConflictException.add_member(:resource_id, Shapes::ShapeRef.new(shape: String, location_name: "resourceId"))
+    ConflictException.add_member(:resource_type, Shapes::ShapeRef.new(shape: String, location_name: "resourceType"))
+    ConflictException.struct_class = Types::ConflictException
+
     CreatePlanRequest.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "description"))
     CreatePlanRequest.add_member(:workflows, Shapes::ShapeRef.new(shape: WorkflowList, required: true, location_name: "workflows"))
     CreatePlanRequest.add_member(:execution_role, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "executionRole"))
@@ -827,6 +834,7 @@ module Aws::ARCRegionswitch
     StartPlanExecutionRequest.add_member(:comment, Shapes::ShapeRef.new(shape: ExecutionComment, location_name: "comment"))
     StartPlanExecutionRequest.add_member(:latest_version, Shapes::ShapeRef.new(shape: String, location_name: "latestVersion"))
     StartPlanExecutionRequest.add_member(:recovery_execution_id, Shapes::ShapeRef.new(shape: RecoveryExecutionId, location_name: "recoveryExecutionId"))
+    StartPlanExecutionRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: StartPlanExecutionRequestClientTokenString, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
     StartPlanExecutionRequest.struct_class = Types::StartPlanExecutionRequest
 
     StartPlanExecutionResponse.add_member(:execution_id, Shapes::ShapeRef.new(shape: ExecutionId, location_name: "executionId"))
@@ -1150,6 +1158,7 @@ module Aws::ARCRegionswitch
         o.errors << Shapes::ShapeRef.new(shape: IllegalStateException)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: IllegalArgumentException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-arcregionswitch/errors.rb

@@ -28,6 +28,7 @@ module Aws::ARCRegionswitch
   #
   # ## Error Classes
   # * {AccessDeniedException}
+  # * {ConflictException}
   # * {IllegalArgumentException}
   # * {IllegalStateException}
   # * {InternalServerException}
@@ -54,6 +55,31 @@ module Aws::ARCRegionswitch
       end
     end
 
+    class ConflictException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ARCRegionswitch::Types::ConflictException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+
+      # @return [String]
+      def resource_id
+        @data[:resource_id]
+      end
+
+      # @return [String]
+      def resource_type
+        @data[:resource_type]
+      end
+    end
+
     class IllegalArgumentException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -432,6 +432,32 @@ module Aws::ARCRegionswitch
     #
     class CancelPlanExecutionResponse < Aws::EmptyStructure; end
 
+    # The client token was already used with different request parameters. A
+    # client token must map to the same parameters for every request. To
+    # retry this operation, provide a new client token.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_id
+    #   The identifier of the resource involved in the client token
+    #   conflict.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_type
+    #   The type of the resource involved in the client token conflict.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/arc-region-switch-2022-07-26/ConflictException AWS API Documentation
+    #
+    class ConflictException < Struct.new(
+      :message,
+      :resource_id,
+      :resource_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] description
     #   The description of a Region switch plan.
     #   @return [String]
@@ -2502,6 +2528,23 @@ module Aws::ARCRegionswitch
     #   post-recovery execution.
     #   @return [String]
     #
+    # @!attribute [rw] client_token
+    #   A unique, case-sensitive identifier to ensure that the operation
+    #   completes no more than one time. If this token matches a previous
+    #   request, the service ignores the request and returns the result of
+    #   the original successful request. If you don't provide a client
+    #   token, the service automatically generates one. For more information
+    #   about idempotency, see [Making retries safe with idempotent
+    #   APIs][1].
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/arc-region-switch-2022-07-26/StartPlanExecutionRequest AWS API Documentation
     #
     class StartPlanExecutionRequest < Struct.new(
@@ -2511,7 +2554,8 @@ module Aws::ARCRegionswitch
       :mode,
       :comment,
       :latest_version,
-      :recovery_execution_id)
+      :recovery_execution_id,
+      :client_token)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-arcregionswitch.rb

@@ -55,7 +55,7 @@ module Aws::ARCRegionswitch
   autoload :EndpointProvider, 'aws-sdk-arcregionswitch/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-arcregionswitch/endpoints'
 
-  GEM_VERSION = '1.20.0'
+  GEM_VERSION = '1.21.0'
 
 end
 

data/sig/client.rbs

@@ -318,7 +318,8 @@ module Aws
                                   ?mode: ("graceful" | "ungraceful"),
                                   ?comment: ::String,
                                   ?latest_version: ::String,
-                                  ?recovery_execution_id: ::String
+                                  ?recovery_execution_id: ::String,
+                                  ?client_token: ::String
                                 ) -> _StartPlanExecutionResponseSuccess
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartPlanExecutionResponseSuccess
 

data/sig/errors.rbs

@@ -14,6 +14,11 @@ module Aws
       class AccessDeniedException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class ConflictException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+        def resource_id: () -> ::String
+        def resource_type: () -> ::String
+      end
       class IllegalArgumentException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end

data/sig/types.rbs

@@ -117,6 +117,13 @@ module Aws::ARCRegionswitch
     class CancelPlanExecutionResponse < Aws::EmptyStructure
     end
 
+    class ConflictException
+      attr_accessor message: ::String
+      attr_accessor resource_id: ::String
+      attr_accessor resource_type: ::String
+      SENSITIVE: []
+    end
+
     class CreatePlanRequest
       attr_accessor description: ::String
       attr_accessor workflows: ::Array[Types::Workflow]
@@ -715,6 +722,7 @@ module Aws::ARCRegionswitch
       attr_accessor comment: ::String
       attr_accessor latest_version: ::String
       attr_accessor recovery_execution_id: ::String
+      attr_accessor client_token: ::String
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-arcregionswitch
 version: !ruby/object:Gem::Version
-  version: 1.20.0
+  version: 1.21.0
 platform: ruby
 authors:
 - Amazon Web Services