Update generated code (#1344)

* update generated code

* Apply suggestions from code review

Co-authored-by: Jérémy Derussé <[email protected]>

Author: async-aws-bot

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Add a `ValidationException` exception
+
 ## 1.0.0
 
 ### Added

src/Enum/ValidationExceptionReason.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace AsyncAws\StepFunctions\Enum;
+
+/**
+ * The input does not satisfy the constraints specified by an Amazon Web Services service.
+ */
+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 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::MISSING_REQUIRED_PARAMETER => true,
+        ][$value]);
+    }
+}

src/Exception/InvalidArnException.php

@@ -6,7 +6,7 @@
 use Symfony\Contracts\HttpClient\ResponseInterface;
 
 /**
- * The provided Amazon Resource Name (ARN) is invalid.
+ * The provided Amazon Resource Name (ARN) is not valid.
  */
 final class InvalidArnException extends ClientException
 {

src/Exception/InvalidExecutionInputException.php

@@ -6,7 +6,7 @@
 use Symfony\Contracts\HttpClient\ResponseInterface;
 
 /**
- * The provided JSON input data is invalid.
+ * The provided JSON input data is not valid.
  */
 final class InvalidExecutionInputException extends ClientException
 {

src/Exception/InvalidNameException.php

@@ -6,7 +6,7 @@
 use Symfony\Contracts\HttpClient\ResponseInterface;
 
 /**
- * The provided name is invalid.
+ * The provided name is not valid.
  */
 final class InvalidNameException extends ClientException
 {

src/Exception/InvalidOutputException.php

@@ -6,7 +6,7 @@
 use Symfony\Contracts\HttpClient\ResponseInterface;
 
 /**
- * The provided JSON output data is invalid.
+ * The provided JSON output data is not valid.
  */
 final class InvalidOutputException extends ClientException
 {

src/Exception/InvalidTokenException.php

@@ -6,7 +6,7 @@
 use Symfony\Contracts\HttpClient\ResponseInterface;
 
 /**
- * The provided token is invalid.
+ * The provided token is not valid.
  */
 final class InvalidTokenException extends ClientException
 {

src/Exception/ValidationException.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace AsyncAws\StepFunctions\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+use AsyncAws\StepFunctions\Enum\ValidationExceptionReason;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * The input does not satisfy the constraints specified by an Amazon Web Services service.
+ */
+final class ValidationException extends ClientException
+{
+    /**
+     * The input does not satisfy the constraints specified by an Amazon Web Services service.
+     */
+    private $reason;
+
+    /**
+     * @return ValidationExceptionReason::*|null
+     */
+    public function getReason(): ?string
+    {
+        return $this->reason;
+    }
+
+    protected function populateResult(ResponseInterface $response): void
+    {
+        $data = $response->toArray(false);
+
+        if (null !== $v = (isset($data['message']) ? (string) $data['message'] : null)) {
+            $this->message = $v;
+        }
+        $this->reason = isset($data['reason']) ? (string) $data['reason'] : null;
+    }
+}

src/StepFunctionsClient.php

@@ -19,6 +19,7 @@
 use AsyncAws\StepFunctions\Exception\StateMachineDoesNotExistException;
 use AsyncAws\StepFunctions\Exception\TaskDoesNotExistException;
 use AsyncAws\StepFunctions\Exception\TaskTimedOutException;
+use AsyncAws\StepFunctions\Exception\ValidationException;
 use AsyncAws\StepFunctions\Input\SendTaskFailureInput;
 use AsyncAws\StepFunctions\Input\SendTaskHeartbeatInput;
 use AsyncAws\StepFunctions\Input\SendTaskSuccessInput;
@@ -131,7 +132,8 @@ public function sendTaskSuccess($input): SendTaskSuccessOutput
     }
 
     /**
-     * Starts a state machine execution.
+     * 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.
      *
      * @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
@@ -151,6 +153,7 @@ public function sendTaskSuccess($input): SendTaskSuccessOutput
      * @throws InvalidNameException
      * @throws StateMachineDoesNotExistException
      * @throws StateMachineDeletingException
+     * @throws ValidationException
      */
     public function startExecution($input): StartExecutionOutput
     {
@@ -163,6 +166,7 @@ public function startExecution($input): StartExecutionOutput
             'InvalidName' => InvalidNameException::class,
             'StateMachineDoesNotExist' => StateMachineDoesNotExistException::class,
             'StateMachineDeleting' => StateMachineDeletingException::class,
+            'ValidationException' => ValidationException::class,
         ]]));
 
         return new StartExecutionOutput($response);
@@ -183,13 +187,15 @@ public function startExecution($input): StartExecutionOutput
      *
      * @throws ExecutionDoesNotExistException
      * @throws InvalidArnException
+     * @throws ValidationException
      */
     public function stopExecution($input): StopExecutionOutput
     {
         $input = StopExecutionInput::create($input);
         $response = $this->getResponse($input->request(), new RequestContext(['operation' => 'StopExecution', 'region' => $input->getRegion(), 'exceptionMapping' => [
             'ExecutionDoesNotExist' => ExecutionDoesNotExistException::class,
             'InvalidArn' => InvalidArnException::class,
+            'ValidationException' => ValidationException::class,
         ]]));
 
         return new StopExecutionOutput($response);