aws-sdk-states 1.61.0 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c19641d8f653b60c4cafd89cac180bcfab4cc89d8bed59b5c2683a6d3f3776a
-  data.tar.gz: 99736410c7927fcc13a77030b8c24e00268e72ca83f8b158f87c257a84b4635a
+  metadata.gz: cbbd43f4b15ab975195243bcf474670186fb6c6e813b58436cefe03dc45d0cf9
+  data.tar.gz: a9479935c9fecba65a2247ed26e05eb61f0bbb593bbc94b3db0f2d44fe671afa
 SHA512:
-  metadata.gz: 4ec0eb44ee3b59af2abe8055530a73c5f7f24122cff180f15615542dd87cb0cbb22a545e3716fbd87bc0b2a2c47058af4e79771d9160d8d74e1b48ee745c01c5
-  data.tar.gz: dce45a4d59117f845dd4ce5b2a4a512df4e23c88ef21dbd45910bf46225dbcf4ac31d48aacc83e1c42acd8a4dbfe80896aba1a0868e20c4b578b87a06ead25e2
+  metadata.gz: f3e26ca5050d5bbc104d9cf196fed6fbb06caeb2d279b35ac399dd1acfe125d434ad31cd28d46c22eb4d2f80ea033819c45934ed11a97455825faf0785ba0ac4
+  data.tar.gz: 8505b94996b2ae3353f0cef164f5ef9cd25c7397e3cb857f302f094e8afcaedb3398250238c6d207e9345ece650f6f2c073007ffdee33a0fb17175c2ffb28c7b

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.62.0 (2023-11-27)
+------------------
+
+* Feature - Adds new TestState operation which accepts the definition of a single state and executes it. You can test a state without creating a state machine or updating an existing state machine.
+
 1.61.0 (2023-11-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.61.0
+1.62.0

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

@@ -2157,10 +2157,11 @@ module Aws::States
     # `RedriveExecution` API action reschedules and redrives only the
     # iterations and branches that failed or aborted.
     #
-    # To redrive a workflow that includes a Distributed Map state with
-    # failed child workflow executions, you must redrive the [parent
-    # workflow][4]. The parent workflow redrives all the unsuccessful
-    # states, including Distributed Map.
+    # To redrive a workflow that includes a Distributed Map state whose Map
+    # Run failed, you must redrive the [parent workflow][4]. The parent
+    # workflow redrives all the unsuccessful states, including a failed Map
+    # Run. If a Map Run was not started in the original execution attempt,
+    # the redriven parent workflow starts the Map Run.
     #
     # <note markdown="1"> This API action is not supported by `EXPRESS` state machines.
     #
@@ -2208,8 +2209,10 @@ module Aws::States
     #   A unique, case-sensitive identifier that you provide to ensure the
     #   idempotency of the request. If you don’t specify a client token, the
     #   Amazon Web Services SDK automatically generates a client token and
-    #   uses it for the request to ensure idempotency. The API uses one of the
-    #   last 10 client tokens provided.
+    #   uses it for the request to ensure idempotency. The API will return
+    #   idempotent responses for the last 10 client tokens used to
+    #   successfully redrive the execution. These client tokens are valid for
+    #   up to 15 minutes after they are first used.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
@@ -2722,6 +2725,164 @@ module Aws::States
       req.send_request(options)
     end
 
+    # Accepts the definition of a single state and executes it. You can test
+    # a state without creating a state machine or updating an existing state
+    # machine. Using this API, you can test the following:
+    #
+    # * A state's [input and output processing][1] data flow
+    #
+    # * An [Amazon Web Services service integration][2] request and response
+    #
+    # * An [HTTP Task][3] request and response
+    #
+    # You can call this API on only one state at a time. The states that you
+    # can test include the following:
+    #
+    # * [All Task types][4] except [Activity][5]
+    #
+    # * [Pass][6]
+    #
+    # * [Wait][7]
+    #
+    # * [Choice][8]
+    #
+    # * [Succeed][9]
+    #
+    # * [Fail][10]
+    #
+    # The `TestState` API assumes an IAM role which must contain the
+    # required IAM permissions for the resources your state is accessing.
+    # For information about the permissions a state might need, see [IAM
+    # permissions to test a state][11].
+    #
+    # The `TestState` API can run for up to five minutes. If the execution
+    # of a state exceeds this duration, it fails with the `States.Timeout`
+    # error.
+    #
+    # `TestState` doesn't support [Activity tasks][5], `.sync` or
+    # `.waitForTaskToken` [service integration patterns][12],
+    # [Parallel][13], or [Map][14] states.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html#test-state-input-output-dataflow
+    # [2]: https://docs.aws.amazon.com/step-functions/latest/dg/connect-to-services.html
+    # [3]: https://docs.aws.amazon.com/step-functions/latest/dg/connect-third-party-apis.html
+    # [4]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-task-state.html#task-types
+    # [5]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-activities.html
+    # [6]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-pass-state.html
+    # [7]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-wait-state.html
+    # [8]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-choice-state.html
+    # [9]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-succeed-state.html
+    # [10]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-fail-state.html
+    # [11]: https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html#test-state-permissions
+    # [12]: https://docs.aws.amazon.com/step-functions/latest/dg/connect-to-resource.html
+    # [13]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-parallel-state.html
+    # [14]: https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-map-state.html
+    #
+    # @option params [required, String] :definition
+    #   The [Amazon States Language][1] (ASL) definition of the state.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html
+    #
+    # @option params [required, String] :role_arn
+    #   The Amazon Resource Name (ARN) of the execution role with the required
+    #   IAM permissions for the state.
+    #
+    # @option params [String] :input
+    #   A string that contains the JSON input data for the state.
+    #
+    # @option params [String] :inspection_level
+    #   Determines the values to return when a state is tested. You can
+    #   specify one of the following types:
+    #
+    #   * `INFO`: Shows the final state output. By default, Step Functions
+    #     sets `inspectionLevel` to `INFO` if you don't specify a level.
+    #
+    #   * `DEBUG`: Shows the final state output along with the input and
+    #     output data processing result.
+    #
+    #   * `TRACE`: Shows the HTTP request and response for an HTTP Task. This
+    #     level also shows the final state output along with the input and
+    #     output data processing result.
+    #
+    #   Each of these levels also provide information about the status of the
+    #   state execution and the next state to transition to.
+    #
+    # @option params [Boolean] :reveal_secrets
+    #   Specifies whether or not to include secret information in the test
+    #   result. For HTTP Tasks, a secret includes the data that an EventBridge
+    #   connection adds to modify the HTTP request headers, query parameters,
+    #   and body. Step Functions doesn't omit any information included in the
+    #   state definition or the HTTP response.
+    #
+    #   If you set `revealSecrets` to `true`, you must make sure that the IAM
+    #   user that calls the `TestState` API has permission for the
+    #   `states:RevealSecrets` action. For an example of IAM policy that sets
+    #   the `states:RevealSecrets` permission, see [IAM permissions to test a
+    #   state][1]. Without this permission, Step Functions throws an access
+    #   denied error.
+    #
+    #   By default, `revealSecrets` is set to `false`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html#test-state-permissions
+    #
+    # @return [Types::TestStateOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::TestStateOutput#output #output} => String
+    #   * {Types::TestStateOutput#error #error} => String
+    #   * {Types::TestStateOutput#cause #cause} => String
+    #   * {Types::TestStateOutput#inspection_data #inspection_data} => Types::InspectionData
+    #   * {Types::TestStateOutput#next_state #next_state} => String
+    #   * {Types::TestStateOutput#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.test_state({
+    #     definition: "Definition", # required
+    #     role_arn: "Arn", # required
+    #     input: "SensitiveData",
+    #     inspection_level: "INFO", # accepts INFO, DEBUG, TRACE
+    #     reveal_secrets: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.output #=> String
+    #   resp.error #=> String
+    #   resp.cause #=> String
+    #   resp.inspection_data.input #=> String
+    #   resp.inspection_data.after_input_path #=> String
+    #   resp.inspection_data.after_parameters #=> String
+    #   resp.inspection_data.result #=> String
+    #   resp.inspection_data.after_result_selector #=> String
+    #   resp.inspection_data.after_result_path #=> String
+    #   resp.inspection_data.request.protocol #=> String
+    #   resp.inspection_data.request.method #=> String
+    #   resp.inspection_data.request.url #=> String
+    #   resp.inspection_data.request.headers #=> String
+    #   resp.inspection_data.request.body #=> String
+    #   resp.inspection_data.response.protocol #=> String
+    #   resp.inspection_data.response.status_code #=> String
+    #   resp.inspection_data.response.status_message #=> String
+    #   resp.inspection_data.response.headers #=> String
+    #   resp.inspection_data.response.body #=> String
+    #   resp.next_state #=> String
+    #   resp.status #=> String, one of "SUCCEEDED", "FAILED", "RETRIABLE", "CAUGHT_ERROR"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/TestState AWS API Documentation
+    #
+    # @overload test_state(params = {})
+    # @param [Hash] params ({})
+    def test_state(params = {}, options = {})
+      req = build_request(:test_state, params)
+      req.send_request(options)
+    end
+
     # Remove a tag from a Step Functions resource
     #
     # @option params [required, String] :resource_arn
@@ -3018,7 +3179,7 @@ module Aws::States
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-states'
-      context[:gem_version] = '1.61.0'
+      context[:gem_version] = '1.62.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -84,6 +84,12 @@ module Aws::States
     GetActivityTaskOutput = Shapes::StructureShape.new(name: 'GetActivityTaskOutput')
     GetExecutionHistoryInput = Shapes::StructureShape.new(name: 'GetExecutionHistoryInput')
     GetExecutionHistoryOutput = Shapes::StructureShape.new(name: 'GetExecutionHistoryOutput')
+    HTTPBody = Shapes::StringShape.new(name: 'HTTPBody')
+    HTTPHeaders = Shapes::StringShape.new(name: 'HTTPHeaders')
+    HTTPMethod = Shapes::StringShape.new(name: 'HTTPMethod')
+    HTTPProtocol = Shapes::StringShape.new(name: 'HTTPProtocol')
+    HTTPStatusCode = Shapes::StringShape.new(name: 'HTTPStatusCode')
+    HTTPStatusMessage = Shapes::StringShape.new(name: 'HTTPStatusMessage')
     HistoryEvent = Shapes::StructureShape.new(name: 'HistoryEvent')
     HistoryEventExecutionDataDetails = Shapes::StructureShape.new(name: 'HistoryEventExecutionDataDetails')
     HistoryEventList = Shapes::ListShape.new(name: 'HistoryEventList')
@@ -91,6 +97,10 @@ module Aws::States
     Identity = Shapes::StringShape.new(name: 'Identity')
     IncludeExecutionData = Shapes::BooleanShape.new(name: 'IncludeExecutionData')
     IncludeExecutionDataGetExecutionHistory = Shapes::BooleanShape.new(name: 'IncludeExecutionDataGetExecutionHistory')
+    InspectionData = Shapes::StructureShape.new(name: 'InspectionData')
+    InspectionDataRequest = Shapes::StructureShape.new(name: 'InspectionDataRequest')
+    InspectionDataResponse = Shapes::StructureShape.new(name: 'InspectionDataResponse')
+    InspectionLevel = Shapes::StringShape.new(name: 'InspectionLevel')
     InvalidArn = Shapes::StructureShape.new(name: 'InvalidArn')
     InvalidDefinition = Shapes::StructureShape.new(name: 'InvalidDefinition')
     InvalidExecutionInput = Shapes::StructureShape.new(name: 'InvalidExecutionInput')
@@ -149,6 +159,7 @@ module Aws::States
     RedriveExecutionInput = Shapes::StructureShape.new(name: 'RedriveExecutionInput')
     RedriveExecutionOutput = Shapes::StructureShape.new(name: 'RedriveExecutionOutput')
     ResourceNotFound = Shapes::StructureShape.new(name: 'ResourceNotFound')
+    RevealSecrets = Shapes::BooleanShape.new(name: 'RevealSecrets')
     ReverseOrder = Shapes::BooleanShape.new(name: 'ReverseOrder')
     RevisionId = Shapes::StringShape.new(name: 'RevisionId')
     RoutingConfigurationList = Shapes::ListShape.new(name: 'RoutingConfigurationList')
@@ -183,6 +194,7 @@ module Aws::States
     StateMachineTypeNotSupported = Shapes::StructureShape.new(name: 'StateMachineTypeNotSupported')
     StateMachineVersionList = Shapes::ListShape.new(name: 'StateMachineVersionList')
     StateMachineVersionListItem = Shapes::StructureShape.new(name: 'StateMachineVersionListItem')
+    StateName = Shapes::StringShape.new(name: 'StateName')
     StopExecutionInput = Shapes::StructureShape.new(name: 'StopExecutionInput')
     StopExecutionOutput = Shapes::StructureShape.new(name: 'StopExecutionOutput')
     SyncExecutionStatus = Shapes::StringShape.new(name: 'SyncExecutionStatus')
@@ -205,6 +217,9 @@ module Aws::States
     TaskTimedOut = Shapes::StructureShape.new(name: 'TaskTimedOut')
     TaskTimedOutEventDetails = Shapes::StructureShape.new(name: 'TaskTimedOutEventDetails')
     TaskToken = Shapes::StringShape.new(name: 'TaskToken')
+    TestExecutionStatus = Shapes::StringShape.new(name: 'TestExecutionStatus')
+    TestStateInput = Shapes::StructureShape.new(name: 'TestStateInput')
+    TestStateOutput = Shapes::StructureShape.new(name: 'TestStateOutput')
     TimeoutInSeconds = Shapes::IntegerShape.new(name: 'TimeoutInSeconds')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     ToleratedFailureCount = Shapes::IntegerShape.new(name: 'ToleratedFailureCount')
@@ -212,6 +227,7 @@ module Aws::States
     TooManyTags = Shapes::StructureShape.new(name: 'TooManyTags')
     TraceHeader = Shapes::StringShape.new(name: 'TraceHeader')
     TracingConfiguration = Shapes::StructureShape.new(name: 'TracingConfiguration')
+    URL = Shapes::StringShape.new(name: 'URL')
     UnsignedInteger = Shapes::IntegerShape.new(name: 'UnsignedInteger')
     UnsignedLong = Shapes::IntegerShape.new(name: 'UnsignedLong')
     UntagResourceInput = Shapes::StructureShape.new(name: 'UntagResourceInput')
@@ -550,6 +566,30 @@ module Aws::States
 
     HistoryEventList.member = Shapes::ShapeRef.new(shape: HistoryEvent)
 
+    InspectionData.add_member(:input, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "input"))
+    InspectionData.add_member(:after_input_path, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "afterInputPath"))
+    InspectionData.add_member(:after_parameters, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "afterParameters"))
+    InspectionData.add_member(:result, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "result"))
+    InspectionData.add_member(:after_result_selector, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "afterResultSelector"))
+    InspectionData.add_member(:after_result_path, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "afterResultPath"))
+    InspectionData.add_member(:request, Shapes::ShapeRef.new(shape: InspectionDataRequest, location_name: "request"))
+    InspectionData.add_member(:response, Shapes::ShapeRef.new(shape: InspectionDataResponse, location_name: "response"))
+    InspectionData.struct_class = Types::InspectionData
+
+    InspectionDataRequest.add_member(:protocol, Shapes::ShapeRef.new(shape: HTTPProtocol, location_name: "protocol"))
+    InspectionDataRequest.add_member(:method, Shapes::ShapeRef.new(shape: HTTPMethod, location_name: "method"))
+    InspectionDataRequest.add_member(:url, Shapes::ShapeRef.new(shape: URL, location_name: "url"))
+    InspectionDataRequest.add_member(:headers, Shapes::ShapeRef.new(shape: HTTPHeaders, location_name: "headers"))
+    InspectionDataRequest.add_member(:body, Shapes::ShapeRef.new(shape: HTTPBody, location_name: "body"))
+    InspectionDataRequest.struct_class = Types::InspectionDataRequest
+
+    InspectionDataResponse.add_member(:protocol, Shapes::ShapeRef.new(shape: HTTPProtocol, location_name: "protocol"))
+    InspectionDataResponse.add_member(:status_code, Shapes::ShapeRef.new(shape: HTTPStatusCode, location_name: "statusCode"))
+    InspectionDataResponse.add_member(:status_message, Shapes::ShapeRef.new(shape: HTTPStatusMessage, location_name: "statusMessage"))
+    InspectionDataResponse.add_member(:headers, Shapes::ShapeRef.new(shape: HTTPHeaders, location_name: "headers"))
+    InspectionDataResponse.add_member(:body, Shapes::ShapeRef.new(shape: HTTPBody, location_name: "body"))
+    InspectionDataResponse.struct_class = Types::InspectionDataResponse
+
     InvalidArn.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     InvalidArn.struct_class = Types::InvalidArn
 
@@ -930,6 +970,21 @@ module Aws::States
     TaskTimedOutEventDetails.add_member(:cause, Shapes::ShapeRef.new(shape: SensitiveCause, location_name: "cause"))
     TaskTimedOutEventDetails.struct_class = Types::TaskTimedOutEventDetails
 
+    TestStateInput.add_member(:definition, Shapes::ShapeRef.new(shape: Definition, required: true, location_name: "definition"))
+    TestStateInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "roleArn"))
+    TestStateInput.add_member(:input, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "input"))
+    TestStateInput.add_member(:inspection_level, Shapes::ShapeRef.new(shape: InspectionLevel, location_name: "inspectionLevel"))
+    TestStateInput.add_member(:reveal_secrets, Shapes::ShapeRef.new(shape: RevealSecrets, location_name: "revealSecrets"))
+    TestStateInput.struct_class = Types::TestStateInput
+
+    TestStateOutput.add_member(:output, Shapes::ShapeRef.new(shape: SensitiveData, location_name: "output"))
+    TestStateOutput.add_member(:error, Shapes::ShapeRef.new(shape: SensitiveError, location_name: "error"))
+    TestStateOutput.add_member(:cause, Shapes::ShapeRef.new(shape: SensitiveCause, location_name: "cause"))
+    TestStateOutput.add_member(:inspection_data, Shapes::ShapeRef.new(shape: InspectionData, location_name: "inspectionData"))
+    TestStateOutput.add_member(:next_state, Shapes::ShapeRef.new(shape: StateName, location_name: "nextState"))
+    TestStateOutput.add_member(:status, Shapes::ShapeRef.new(shape: TestExecutionStatus, location_name: "status"))
+    TestStateOutput.struct_class = Types::TestStateOutput
+
     TooManyTags.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     TooManyTags.add_member(:resource_name, Shapes::ShapeRef.new(shape: Arn, location_name: "resourceName"))
     TooManyTags.struct_class = Types::TooManyTags
@@ -1389,6 +1444,21 @@ module Aws::States
         o.errors << Shapes::ShapeRef.new(shape: TooManyTags)
       end)
 
+      api.add_operation(:test_state, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "TestState"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.endpoint_pattern = {
+          "hostPrefix" => "sync-",
+        }
+        o.input = Shapes::ShapeRef.new(shape: TestStateInput)
+        o.output = Shapes::ShapeRef.new(shape: TestStateOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidArn)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidDefinition)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidExecutionInput)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
       api.add_operation(:untag_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UntagResource"
         o.http_method = "POST"
@@ -1438,6 +1508,7 @@ module Aws::States
         o.errors << Shapes::ShapeRef.new(shape: InvalidArn)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFound)
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: StateMachineDeleting)
       end)
     end
 

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

@@ -446,6 +446,20 @@ module Aws::States
       end
     end
 
+    class TestState
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::States::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 UntagResource
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -118,6 +118,8 @@ module Aws::States
             Aws::States::Endpoints::StopExecution.build(context)
           when :tag_resource
             Aws::States::Endpoints::TagResource.build(context)
+          when :test_state
+            Aws::States::Endpoints::TestState.build(context)
           when :untag_resource
             Aws::States::Endpoints::UntagResource.build(context)
           when :update_map_run

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

@@ -759,8 +759,7 @@ module Aws::States
     # @!attribute [rw] redrive_count
     #   The number of times you've redriven an execution. If you have not
     #   yet redriven an execution, the `redriveCount` is 0. This count is
-    #   not updated for redrives that failed to start or are pending to be
-    #   redriven.
+    #   only updated if you successfully redrive an execution.
     #   @return [Integer]
     #
     # @!attribute [rw] redrive_date
@@ -914,9 +913,8 @@ module Aws::States
     #
     # @!attribute [rw] redrive_count
     #   The number of times you've redriven a Map Run. If you have not yet
-    #   redriven a Map Run, the `redriveCount` is 0. This count is not
-    #   updated for redrives that failed to start or are pending to be
-    #   redriven.
+    #   redriven a Map Run, the `redriveCount` is 0. This count is only
+    #   updated if you successfully redrive a Map Run.
     #   @return [Integer]
     #
     # @!attribute [rw] redrive_date
@@ -1371,8 +1369,7 @@ module Aws::States
     # @!attribute [rw] redrive_count
     #   The number of times you've redriven an execution. If you have not
     #   yet redriven an execution, the `redriveCount` is 0. This count is
-    #   not updated for redrives that failed to start or are pending to be
-    #   redriven.
+    #   only updated when you successfully redrive an execution.
     #   @return [Integer]
     #
     # @!attribute [rw] redrive_date
@@ -1852,6 +1849,149 @@ module Aws::States
       include Aws::Structure
     end
 
+    # Contains additional details about the state's execution, including
+    # its input and output data processing flow, and HTTP request and
+    # response information.
+    #
+    # @!attribute [rw] input
+    #   The raw state input.
+    #   @return [String]
+    #
+    # @!attribute [rw] after_input_path
+    #   The input after Step Functions applies the [InputPath][1] filter.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-inputpath
+    #   @return [String]
+    #
+    # @!attribute [rw] after_parameters
+    #   The effective input after Step Functions applies the [Parameters][1]
+    #   filter.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-parameters
+    #   @return [String]
+    #
+    # @!attribute [rw] result
+    #   The state's raw result.
+    #   @return [String]
+    #
+    # @!attribute [rw] after_result_selector
+    #   The effective result after Step Functions applies the
+    #   [ResultSelector][1] filter.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-resultselector
+    #   @return [String]
+    #
+    # @!attribute [rw] after_result_path
+    #   The effective result combined with the raw state input after Step
+    #   Functions applies the [ResultPath][1] filter.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/input-output-resultpath.html
+    #   @return [String]
+    #
+    # @!attribute [rw] request
+    #   The raw HTTP request that is sent when you test an HTTP Task.
+    #   @return [Types::InspectionDataRequest]
+    #
+    # @!attribute [rw] response
+    #   The raw HTTP response that is returned when you test an HTTP Task.
+    #   @return [Types::InspectionDataResponse]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/InspectionData AWS API Documentation
+    #
+    class InspectionData < Struct.new(
+      :input,
+      :after_input_path,
+      :after_parameters,
+      :result,
+      :after_result_selector,
+      :after_result_path,
+      :request,
+      :response)
+      SENSITIVE = [:input, :after_input_path, :after_parameters, :result, :after_result_selector, :after_result_path]
+      include Aws::Structure
+    end
+
+    # Contains additional details about the state's execution, including
+    # its input and output data processing flow, and HTTP request
+    # information.
+    #
+    # @!attribute [rw] protocol
+    #   The protocol used to make the HTTP request.
+    #   @return [String]
+    #
+    # @!attribute [rw] method
+    #   The HTTP method used for the HTTP request.
+    #   @return [String]
+    #
+    # @!attribute [rw] url
+    #   The API endpoint used for the HTTP request.
+    #   @return [String]
+    #
+    # @!attribute [rw] headers
+    #   The request headers associated with the HTTP request.
+    #   @return [String]
+    #
+    # @!attribute [rw] body
+    #   The request body for the HTTP request.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/InspectionDataRequest AWS API Documentation
+    #
+    class InspectionDataRequest < Struct.new(
+      :protocol,
+      :method,
+      :url,
+      :headers,
+      :body)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains additional details about the state's execution, including
+    # its input and output data processing flow, and HTTP response
+    # information. The `inspectionLevel` request parameter specifies which
+    # details are returned.
+    #
+    # @!attribute [rw] protocol
+    #   The protocol used to return the HTTP response.
+    #   @return [String]
+    #
+    # @!attribute [rw] status_code
+    #   The HTTP response status code for the HTTP response.
+    #   @return [String]
+    #
+    # @!attribute [rw] status_message
+    #   The message associated with the HTTP status code.
+    #   @return [String]
+    #
+    # @!attribute [rw] headers
+    #   The response headers associated with the HTTP response.
+    #   @return [String]
+    #
+    # @!attribute [rw] body
+    #   The HTTP response returned.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/InspectionDataResponse AWS API Documentation
+    #
+    class InspectionDataResponse < Struct.new(
+      :protocol,
+      :status_code,
+      :status_message,
+      :headers,
+      :body)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The provided Amazon Resource Name (ARN) is not valid.
     #
     # @!attribute [rw] message
@@ -2610,9 +2750,9 @@ module Aws::States
     # @!attribute [rw] failures_not_redrivable
     #   The number of `FAILED`, `ABORTED`, or `TIMED_OUT` child workflow
     #   executions that cannot be redriven because their execution status is
-    #   terminal. For example, if your execution event history contains
-    #   25,000 entries, or the `toleratedFailureCount` or
-    #   `toleratedFailurePercentage` for the Distributed Map has exceeded.
+    #   terminal. For example, child workflows with an execution status of
+    #   `FAILED`, `ABORTED`, or `TIMED_OUT` and a `redriveStatus` of
+    #   `NOT_REDRIVABLE`.
     #   @return [Integer]
     #
     # @!attribute [rw] pending_redrive
@@ -2711,10 +2851,9 @@ module Aws::States
     # @!attribute [rw] failures_not_redrivable
     #   The number of `FAILED`, `ABORTED`, or `TIMED_OUT` items in child
     #   workflow executions that cannot be redriven because the execution
-    #   status of those child workflows is terminal. For example, if your
-    #   execution event history contains 25,000 entries, or the
-    #   `toleratedFailureCount` or `toleratedFailurePercentage` for the
-    #   Distributed Map has exceeded.
+    #   status of those child workflows is terminal. For example, child
+    #   workflows with an execution status of `FAILED`, `ABORTED`, or
+    #   `TIMED_OUT` and a `redriveStatus` of `NOT_REDRIVABLE`.
     #   @return [Integer]
     #
     # @!attribute [rw] pending_redrive
@@ -2900,8 +3039,10 @@ module Aws::States
     #   A unique, case-sensitive identifier that you provide to ensure the
     #   idempotency of the request. If you don’t specify a client token, the
     #   Amazon Web Services SDK automatically generates a client token and
-    #   uses it for the request to ensure idempotency. The API uses one of
-    #   the last 10 client tokens provided.
+    #   uses it for the request to ensure idempotency. The API will return
+    #   idempotent responses for the last 10 client tokens used to
+    #   successfully redrive the execution. These client tokens are valid
+    #   for up to 15 minutes after they are first used.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
@@ -3913,6 +4054,118 @@ module Aws::States
       include Aws::Structure
     end
 
+    # @!attribute [rw] definition
+    #   The [Amazon States Language][1] (ASL) definition of the state.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html
+    #   @return [String]
+    #
+    # @!attribute [rw] role_arn
+    #   The Amazon Resource Name (ARN) of the execution role with the
+    #   required IAM permissions for the state.
+    #   @return [String]
+    #
+    # @!attribute [rw] input
+    #   A string that contains the JSON input data for the state.
+    #   @return [String]
+    #
+    # @!attribute [rw] inspection_level
+    #   Determines the values to return when a state is tested. You can
+    #   specify one of the following types:
+    #
+    #   * `INFO`: Shows the final state output. By default, Step Functions
+    #     sets `inspectionLevel` to `INFO` if you don't specify a level.
+    #
+    #   * `DEBUG`: Shows the final state output along with the input and
+    #     output data processing result.
+    #
+    #   * `TRACE`: Shows the HTTP request and response for an HTTP Task.
+    #     This level also shows the final state output along with the input
+    #     and output data processing result.
+    #
+    #   Each of these levels also provide information about the status of
+    #   the state execution and the next state to transition to.
+    #   @return [String]
+    #
+    # @!attribute [rw] reveal_secrets
+    #   Specifies whether or not to include secret information in the test
+    #   result. For HTTP Tasks, a secret includes the data that an
+    #   EventBridge connection adds to modify the HTTP request headers,
+    #   query parameters, and body. Step Functions doesn't omit any
+    #   information included in the state definition or the HTTP response.
+    #
+    #   If you set `revealSecrets` to `true`, you must make sure that the
+    #   IAM user that calls the `TestState` API has permission for the
+    #   `states:RevealSecrets` action. For an example of IAM policy that
+    #   sets the `states:RevealSecrets` permission, see [IAM permissions to
+    #   test a state][1]. Without this permission, Step Functions throws an
+    #   access denied error.
+    #
+    #   By default, `revealSecrets` is set to `false`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html#test-state-permissions
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/TestStateInput AWS API Documentation
+    #
+    class TestStateInput < Struct.new(
+      :definition,
+      :role_arn,
+      :input,
+      :inspection_level,
+      :reveal_secrets)
+      SENSITIVE = [:definition, :input]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] output
+    #   The JSON output data of the state. Length constraints apply to the
+    #   payload size, and are expressed as bytes in UTF-8 encoding.
+    #   @return [String]
+    #
+    # @!attribute [rw] error
+    #   The error returned when the execution of a state fails.
+    #   @return [String]
+    #
+    # @!attribute [rw] cause
+    #   A detailed explanation of the cause for the error when the execution
+    #   of a state fails.
+    #   @return [String]
+    #
+    # @!attribute [rw] inspection_data
+    #   Returns additional details about the state's execution, including
+    #   its input and output data processing flow, and HTTP request and
+    #   response information. The `inspectionLevel` request parameter
+    #   specifies which details are returned.
+    #   @return [Types::InspectionData]
+    #
+    # @!attribute [rw] next_state
+    #   The name of the next state to transition to. If you haven't defined
+    #   a next state in your definition or if the execution of the state
+    #   fails, this field doesn't contain a value.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The execution status of the state.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/TestStateOutput AWS API Documentation
+    #
+    class TestStateOutput < Struct.new(
+      :output,
+      :error,
+      :cause,
+      :inspection_data,
+      :next_state,
+      :status)
+      SENSITIVE = [:output, :error, :cause, :inspection_data]
+      include Aws::Structure
+    end
+
     # You've exceeded the number of tags allowed for a resource. See the [
     # Limits Topic][1] in the Step Functions Developer Guide.
     #

data/lib/aws-sdk-states.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-states/customizations'
 # @!group service
 module Aws::States
 
-  GEM_VERSION = '1.61.0'
+  GEM_VERSION = '1.62.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-states
 version: !ruby/object:Gem::Version
-  version: 1.61.0
+  version: 1.62.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-22 00:00:00.000000000 Z
+date: 2023-11-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core