Update generated code (#1460)

* update generated code

* Update src/Service/StepFunctions/CHANGELOG.md

---------

Co-authored-by: Jérémy Derussé <jeremy@derusse.com>

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.273.5"
+        "${LATEST}": "3.273.6"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {

src/Service/StepFunctions/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Adding `INVALID_ROUTING_CONFIGURATION` reason to ValidationExceptionReason enum
+
 ## 1.1.0
 
 ### Added

src/Service/StepFunctions/src/Enum/ValidationExceptionReason.php

@@ -6,13 +6,15 @@ final class ValidationExceptionReason
 {
     public const API_DOES_NOT_SUPPORT_LABELED_ARNS = 'API_DOES_NOT_SUPPORT_LABELED_ARNS';
     public const CANNOT_UPDATE_COMPLETED_MAP_RUN = 'CANNOT_UPDATE_COMPLETED_MAP_RUN';
+    public const INVALID_ROUTING_CONFIGURATION = 'INVALID_ROUTING_CONFIGURATION';
     public const MISSING_REQUIRED_PARAMETER = 'MISSING_REQUIRED_PARAMETER';
 
     public static function exists(string $value): bool
     {
         return isset([
             self::API_DOES_NOT_SUPPORT_LABELED_ARNS => true,
             self::CANNOT_UPDATE_COMPLETED_MAP_RUN => true,
+            self::INVALID_ROUTING_CONFIGURATION => true,
             self::MISSING_REQUIRED_PARAMETER => true,
         ][$value]);
     }

src/Service/StepFunctions/src/Input/StartExecutionInput.php

@@ -12,16 +12,40 @@ final class StartExecutionInput extends Input
     /**
      * The Amazon Resource Name (ARN) of the state machine to execute.
      *
+     * The `stateMachineArn` parameter accepts one of the following inputs:
+     *
+     * - **An unqualified state machine ARN** – Refers to a state machine ARN that isn't qualified with a version or alias
+     *   ARN. The following is an example of an unqualified state machine ARN.
+     *
+     *   `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine>`
+     *
+     *   Step Functions doesn't associate state machine executions that you start with an unqualified ARN with a version.
+     *   This is true even if that version uses the same revision that the execution used.
+     * - **A state machine version ARN** – Refers to a version ARN, which is a combination of state machine ARN and the
+     *   version number separated by a colon (:). The following is an example of the ARN for version 10.
+     *
+     *   `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine>:10`
+     *
+     *   Step Functions doesn't associate executions that you start with a version ARN with any aliases that point to that
+     *   version.
+     * - **A state machine alias ARN** – Refers to an alias ARN, which is a combination of state machine ARN and the alias
+     *   name separated by a colon (:). The following is an example of the ARN for an alias named `PROD`.
+     *
+     *   `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine:PROD>`
+     *
+     *   Step Functions associates executions that you start with an alias ARN with that alias and the state machine version
+     *   used for that execution.
+     *
      * @required
      *
      * @var string|null
      */
     private $stateMachineArn;
 
     /**
-     * The name of the execution. This name must be unique for your Amazon Web Services account, region, and state machine
-     * for 90 days. For more information, see  Limits Related to State Machine Executions [^1] in the *Step Functions
-     * Developer Guide*.
+     * Optional name of the execution. This name must be unique for your Amazon Web Services account, Region, and state
+     * machine for 90 days. For more information, see  Limits Related to State Machine Executions [^1] in the *Step
+     * Functions Developer Guide*.
      *
      * A name must *not* contain:
      *

src/Service/StepFunctions/src/StepFunctionsClient.php

@@ -142,19 +142,47 @@ public function sendTaskSuccess($input): SendTaskSuccessOutput
     }
 
     /**
-     * Starts a state machine execution. If the given state machine Amazon Resource Name (ARN) is a qualified state machine
-     * ARN, it will fail with ValidationException.
+     * Starts a state machine execution.
      *
-     * A qualified state machine ARN refers to a *Distributed Map state* defined within a state machine. For example, the
-     * qualified state machine ARN `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
-     * refers to a *Distributed Map state* with a label `mapStateLabel` in the state machine named `stateMachineName`.
+     * A qualified state machine ARN can either refer to a *Distributed Map state* defined within a state machine, a version
+     * ARN, or an alias ARN.
      *
-     * > `StartExecution` is idempotent for `STANDARD` workflows. For a `STANDARD` workflow, if `StartExecution` is called
-     * > with the same name and input as a running execution, the call will succeed and return the same response as the
-     * > original request. If the execution is closed or if the input is different, it will return a `400
-     * > ExecutionAlreadyExists` error. Names can be reused after 90 days.
+     * The following are some examples of qualified and unqualified state machine ARNs:
+     *
+     * - The following qualified state machine ARN refers to a *Distributed Map state* with a label `mapStateLabel` in a
+     *   state machine named `myStateMachine`.
+     *
+     *   `arn:partition:states:region:account-id:stateMachine:myStateMachine/mapStateLabel`
+     *
+     *   > If you provide a qualified state machine ARN that refers to a *Distributed Map state*, the request fails with
+     *   > `ValidationException`.
+     *
+     * - The following qualified state machine ARN refers to an alias named `PROD`.
+     *
+     *   `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine:PROD>`
+     *
+     *   > If you provide a qualified state machine ARN that refers to a version ARN or an alias ARN, the request starts
+     *   > execution for that version or alias.
+     *
+     * - The following unqualified state machine ARN refers to a state machine named `myStateMachine`.
+     *
+     *   `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine>`
+     *
+     * If you start an execution with an unqualified state machine ARN, Step Functions uses the latest revision of the state
+     * machine for the execution.
+     *
+     * To start executions of a state machine version [^1], call `StartExecution` and provide the version ARN or the ARN of
+     * an alias [^2] that points to the version.
+     *
+     * > `StartExecution` is idempotent for `STANDARD` workflows. For a `STANDARD` workflow, if you call `StartExecution`
+     * > with the same name and input as a running execution, the call succeeds and return the same response as the original
+     * > request. If the execution is closed or if the input is different, it returns a `400 ExecutionAlreadyExists` error.
+     * > You can reuse names after 90 days.
      * >
-     * > `StartExecution` is not idempotent for `EXPRESS` workflows.
+     * > `StartExecution` isn't idempotent for `EXPRESS` workflows.
+     *
+     * [^1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-state-machine-version.html
+     * [^2]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-state-machine-alias.html
      *
      * @see https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-states-2016-11-23.html#startexecution