Update generated code (#1741)

* update generated code

* Update src/Service/StepFunctions/CHANGELOG.md

---------

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

Author: async-aws-bot

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Added `KmsAccessDeniedException`, `KmsInvalidStateException` and `KmsThrottlingException` exceptions
+
 ## 1.2.3
 
 ### Changed

composer.json

@@ -27,7 +27,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "1.2-dev"
+            "dev-master": "1.3-dev"
         }
     }
 }

src/Enum/KmsKeyState.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace AsyncAws\StepFunctions\Enum;
+
+final class KmsKeyState
+{
+    public const CREATING = 'CREATING';
+    public const DISABLED = 'DISABLED';
+    public const PENDING_DELETION = 'PENDING_DELETION';
+    public const PENDING_IMPORT = 'PENDING_IMPORT';
+    public const UNAVAILABLE = 'UNAVAILABLE';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::CREATING => true,
+            self::DISABLED => true,
+            self::PENDING_DELETION => true,
+            self::PENDING_IMPORT => true,
+            self::UNAVAILABLE => true,
+        ][$value]);
+    }
+}

src/Exception/KmsAccessDeniedException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\StepFunctions\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * Either your KMS key policy or API caller does not have the required permissions.
+ */
+final class KmsAccessDeniedException extends ClientException
+{
+}

src/Exception/KmsInvalidStateException.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace AsyncAws\StepFunctions\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use AsyncAws\StepFunctions\Enum\KmsKeyState;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * The KMS key is not in valid state, for example: Disabled or Deleted.
+ */
+final class KmsInvalidStateException extends ClientException
+{
+    /**
+     * Current status of the KMS; key. For example: `DISABLED`, `PENDING_DELETION`, `PENDING_IMPORT`, `UNAVAILABLE`,
+     * `CREATING`.
+     *
+     * @var KmsKeyState::*|null
+     */
+    private $kmsKeyState;
+
+    /**
+     * @return KmsKeyState::*|null
+     */
+    public function getKmsKeyState(): ?string
+    {
+        return $this->kmsKeyState;
+    }
+
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        $this->kmsKeyState = isset($data['kmsKeyState']) ? (string) $data['kmsKeyState'] : null;
+    }
+}

src/Exception/KmsThrottlingException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\StepFunctions\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * Received when KMS returns `ThrottlingException` for a KMS call that Step Functions makes on behalf of the caller.
+ */
+final class KmsThrottlingException extends ClientException
+{
+}

src/StepFunctionsClient.php

@@ -15,6 +15,9 @@
 use AsyncAws\StepFunctions\Exception\InvalidNameException;
 use AsyncAws\StepFunctions\Exception\InvalidOutputException;
 use AsyncAws\StepFunctions\Exception\InvalidTokenException;
+use AsyncAws\StepFunctions\Exception\KmsAccessDeniedException;
+use AsyncAws\StepFunctions\Exception\KmsInvalidStateException;
+use AsyncAws\StepFunctions\Exception\KmsThrottlingException;
 use AsyncAws\StepFunctions\Exception\StateMachineDeletingException;
 use AsyncAws\StepFunctions\Exception\StateMachineDoesNotExistException;
 use AsyncAws\StepFunctions\Exception\TaskDoesNotExistException;
@@ -37,6 +40,12 @@ class StepFunctionsClient extends AbstractApi
      * Used by activity workers, Task states using the callback [^1] pattern, and optionally Task states using the job run
      * [^2] pattern to report that the task identified by the `taskToken` failed.
      *
+     * For an execution with encryption enabled, Step Functions will encrypt the error and cause fields using the KMS key
+     * for the execution role.
+     *
+     * A caller can mark a task as fail without using any KMS permissions in the execution role if the caller provides a
+     * null value for both `error` and `cause` fields because no data needs to be encrypted.
+     *
      * [^1]: https://docs.aws.amazon.com/step-functions/latest/dg/connect-to-resource.html#connect-wait-token
      * [^2]: https://docs.aws.amazon.com/step-functions/latest/dg/connect-to-resource.html#connect-sync
      *
@@ -53,6 +62,9 @@ class StepFunctionsClient extends AbstractApi
      * @throws TaskDoesNotExistException
      * @throws InvalidTokenException
      * @throws TaskTimedOutException
+     * @throws KmsAccessDeniedException
+     * @throws KmsInvalidStateException
+     * @throws KmsThrottlingException
      */
     public function sendTaskFailure($input): SendTaskFailureOutput
     {
@@ -61,6 +73,9 @@ public function sendTaskFailure($input): SendTaskFailureOutput
             'TaskDoesNotExist' => TaskDoesNotExistException::class,
             'InvalidToken' => InvalidTokenException::class,
             'TaskTimedOut' => TaskTimedOutException::class,
+            'KmsAccessDeniedException' => KmsAccessDeniedException::class,
+            'KmsInvalidStateException' => KmsInvalidStateException::class,
+            'KmsThrottlingException' => KmsThrottlingException::class,
         ]]));
 
         return new SendTaskFailureOutput($response);
@@ -127,6 +142,9 @@ public function sendTaskHeartbeat($input): SendTaskHeartbeatOutput
      * @throws InvalidOutputException
      * @throws InvalidTokenException
      * @throws TaskTimedOutException
+     * @throws KmsAccessDeniedException
+     * @throws KmsInvalidStateException
+     * @throws KmsThrottlingException
      */
     public function sendTaskSuccess($input): SendTaskSuccessOutput
     {
@@ -136,6 +154,9 @@ public function sendTaskSuccess($input): SendTaskSuccessOutput
             'InvalidOutput' => InvalidOutputException::class,
             'InvalidToken' => InvalidTokenException::class,
             'TaskTimedOut' => TaskTimedOutException::class,
+            'KmsAccessDeniedException' => KmsAccessDeniedException::class,
+            'KmsInvalidStateException' => KmsInvalidStateException::class,
+            'KmsThrottlingException' => KmsThrottlingException::class,
         ]]));
 
         return new SendTaskSuccessOutput($response);
@@ -203,6 +224,9 @@ public function sendTaskSuccess($input): SendTaskSuccessOutput
      * @throws StateMachineDoesNotExistException
      * @throws StateMachineDeletingException
      * @throws ValidationException
+     * @throws KmsAccessDeniedException
+     * @throws KmsInvalidStateException
+     * @throws KmsThrottlingException
      */
     public function startExecution($input): StartExecutionOutput
     {
@@ -216,6 +240,9 @@ public function startExecution($input): StartExecutionOutput
             'StateMachineDoesNotExist' => StateMachineDoesNotExistException::class,
             'StateMachineDeleting' => StateMachineDeletingException::class,
             'ValidationException' => ValidationException::class,
+            'KmsAccessDeniedException' => KmsAccessDeniedException::class,
+            'KmsInvalidStateException' => KmsInvalidStateException::class,
+            'KmsThrottlingException' => KmsThrottlingException::class,
         ]]));
 
         return new StartExecutionOutput($response);
@@ -226,6 +253,12 @@ public function startExecution($input): StartExecutionOutput
      *
      * This API action is not supported by `EXPRESS` state machines.
      *
+     * For an execution with encryption enabled, Step Functions will encrypt the error and cause fields using the KMS key
+     * for the execution role.
+     *
+     * A caller can stop an execution without using any KMS permissions in the execution role if the caller provides a null
+     * value for both `error` and `cause` fields because no data needs to be encrypted.
+     *
      * @see https://docs.aws.amazon.com/step-functions/latest/apireference/API_StopExecution.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-states-2016-11-23.html#stopexecution
      *
@@ -239,6 +272,9 @@ public function startExecution($input): StartExecutionOutput
      * @throws ExecutionDoesNotExistException
      * @throws InvalidArnException
      * @throws ValidationException
+     * @throws KmsAccessDeniedException
+     * @throws KmsInvalidStateException
+     * @throws KmsThrottlingException
      */
     public function stopExecution($input): StopExecutionOutput
     {
@@ -247,6 +283,9 @@ public function stopExecution($input): StopExecutionOutput
             'ExecutionDoesNotExist' => ExecutionDoesNotExistException::class,
             'InvalidArn' => InvalidArnException::class,
             'ValidationException' => ValidationException::class,
+            'KmsAccessDeniedException' => KmsAccessDeniedException::class,
+            'KmsInvalidStateException' => KmsInvalidStateException::class,
+            'KmsThrottlingException' => KmsThrottlingException::class,
         ]]));
 
         return new StopExecutionOutput($response);