Update generated code (async-aws#1180)

async-aws-bot · jderusse · web-flow · commit 110c91432748 · 2022-02-10T13:59:57.000Z
* update generated code

* Update src/Service/CloudFormation/CHANGELOG.md

Co-authored-by: Jérémy Derussé &lt;jeremy@derusse.com&gt;
diff --git a/manifest.json b/manifest.json
@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.209.20"
+        "${LATEST}": "3.209.21"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {
diff --git a/src/Service/CloudFormation/CHANGELOG.md b/src/Service/CloudFormation/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Add support to AWS CloudFormation Hooks.
+
 ## 1.2.0
 
 ### Added
diff --git a/src/Service/CloudFormation/src/Enum/HookFailureMode.php b/src/Service/CloudFormation/src/Enum/HookFailureMode.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace AsyncAws\CloudFormation\Enum;
+
+/**
+ * Specify the hook failure mode for non-compliant resources in the followings ways.
+ *
+ * - `FAIL` Stops provisioning resources.
+ * - `WARN` Allows provisioning to continue with a warning message.
+ */
+final class HookFailureMode
+{
+    public const FAIL = 'FAIL';
+    public const WARN = 'WARN';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::FAIL => true,
+            self::WARN => true,
+        ][$value]);
+    }
+}
diff --git a/src/Service/CloudFormation/src/Enum/HookInvocationPoint.php b/src/Service/CloudFormation/src/Enum/HookInvocationPoint.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace AsyncAws\CloudFormation\Enum;
+
+/**
+ * Invocation points are points in provisioning logic where hooks are initiated.
+ */
+final class HookInvocationPoint
+{
+    public const PRE_PROVISION = 'PRE_PROVISION';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::PRE_PROVISION => true,
+        ][$value]);
+    }
+}
diff --git a/src/Service/CloudFormation/src/Enum/HookStatus.php b/src/Service/CloudFormation/src/Enum/HookStatus.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace AsyncAws\CloudFormation\Enum;
+
+/**
+ * Provides the status of the change set hook.
+ */
+final class HookStatus
+{
+    public const HOOK_COMPLETE_FAILED = 'HOOK_COMPLETE_FAILED';
+    public const HOOK_COMPLETE_SUCCEEDED = 'HOOK_COMPLETE_SUCCEEDED';
+    public const HOOK_FAILED = 'HOOK_FAILED';
+    public const HOOK_IN_PROGRESS = 'HOOK_IN_PROGRESS';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::HOOK_COMPLETE_FAILED => true,
+            self::HOOK_COMPLETE_SUCCEEDED => true,
+            self::HOOK_FAILED => true,
+            self::HOOK_IN_PROGRESS => true,
+        ][$value]);
+    }
+}
diff --git a/src/Service/CloudFormation/src/Enum/StackDriftDetectionStatus.php b/src/Service/CloudFormation/src/Enum/StackDriftDetectionStatus.php
@@ -6,7 +6,7 @@
  * The status of the stack drift detection operation.
  *
  * - `DETECTION_COMPLETE`: The stack drift detection operation has successfully completed for all resources in the stack
- *   that support drift detection. (Resources that do not currently support stack detection remain unchecked.)
+ *   that support drift detection. (Resources that don't currently support stack detection remain unchecked.)
  *   If you specified logical resource IDs for CloudFormation to use as a filter for the stack drift detection
  *   operation, only the resources with those logical IDs are checked for drift.
  * - `DETECTION_FAILED`: The stack drift detection operation has failed for at least one resource in the stack. Results
diff --git a/src/Service/CloudFormation/src/Enum/StackDriftStatus.php b/src/Service/CloudFormation/src/Enum/StackDriftStatus.php
@@ -7,7 +7,7 @@
  *
  * - `DRIFTED`: The stack differs from its expected template configuration. A stack is considered to have drifted if one
  *   or more of its resources have drifted.
- * - `NOT_CHECKED`: CloudFormation has not checked if the stack differs from its expected template configuration.
+ * - `NOT_CHECKED`: CloudFormation hasn't checked if the stack differs from its expected template configuration.
  * - `IN_SYNC`: The stack's actual configuration matches its expected template configuration.
  * - `UNKNOWN`: This value is reserved for future use.
  */
diff --git a/src/Service/CloudFormation/src/Input/DescribeStackEventsInput.php b/src/Service/CloudFormation/src/Input/DescribeStackEventsInput.php
@@ -12,7 +12,7 @@
 final class DescribeStackEventsInput extends Input
 {
     /**
-     * The name or the unique stack ID that is associated with the stack, which are not always interchangeable:.
+     * The name or the unique stack ID that's associated with the stack, which aren't always interchangeable:.
      *
      * @var string|null
      */
diff --git a/src/Service/CloudFormation/src/Input/DescribeStacksInput.php b/src/Service/CloudFormation/src/Input/DescribeStacksInput.php
@@ -12,7 +12,7 @@
 final class DescribeStacksInput extends Input
 {
     /**
-     * The name or the unique stack ID that is associated with the stack, which are not always interchangeable:.
+     * The name or the unique stack ID that's associated with the stack, which aren't always interchangeable:.
      *
      * @var string|null
      */
diff --git a/src/Service/CloudFormation/src/Result/DescribeStackEventsOutput.php b/src/Service/CloudFormation/src/Result/DescribeStackEventsOutput.php
@@ -116,6 +116,11 @@ private function populateResultStackEvents(\SimpleXMLElement $xml): array
                 'ResourceStatusReason' => ($v = $item->ResourceStatusReason) ? (string) $v : null,
                 'ResourceProperties' => ($v = $item->ResourceProperties) ? (string) $v : null,
                 'ClientRequestToken' => ($v = $item->ClientRequestToken) ? (string) $v : null,
+                'HookType' => ($v = $item->HookType) ? (string) $v : null,
+                'HookStatus' => ($v = $item->HookStatus) ? (string) $v : null,
+                'HookStatusReason' => ($v = $item->HookStatusReason) ? (string) $v : null,
+                'HookInvocationPoint' => ($v = $item->HookInvocationPoint) ? (string) $v : null,
+                'HookFailureMode' => ($v = $item->HookFailureMode) ? (string) $v : null,
             ]);
         }
 
diff --git a/src/Service/CloudFormation/src/ValueObject/Parameter.php b/src/Service/CloudFormation/src/ValueObject/Parameter.php
@@ -9,7 +9,7 @@ final class Parameter
 {
     /**
      * The key associated with the parameter. If you don't specify a key and value for a particular parameter,
-     * CloudFormation uses the default value that is specified in your template.
+     * CloudFormation uses the default value that's specified in your template.
      */
     private $parameterKey;
 
@@ -25,8 +25,8 @@ final class Parameter
     private $usePreviousValue;
 
     /**
-     * Read-only. Read-only. The value that corresponds to a SSM parameter key. This field is returned only for `SSM`
-     * parameter types in the template.
+     * Read-only. The value that corresponds to a SSM parameter key. This field is returned only for `SSM` parameter types
+     * in the template.
      *
      * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html#aws-ssm-parameter-types
      */
diff --git a/src/Service/CloudFormation/src/ValueObject/Stack.php b/src/Service/CloudFormation/src/ValueObject/Stack.php
@@ -72,7 +72,7 @@ final class Stack
     private $disableRollback;
 
     /**
-     * SNS topic ARNs to which stack related events are published.
+     * Amazon SNS topic Amazon Resource Names (ARNs) to which stack related events are published.
      */
     private $notificationArns;
 
@@ -92,7 +92,7 @@ final class Stack
     private $outputs;
 
     /**
-     * The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that is associated with the stack.
+     * The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that's associated with the stack.
      * During a stack operation, CloudFormation uses this role's credentials to make calls on your behalf.
      */
     private $roleArn;
diff --git a/src/Service/CloudFormation/src/ValueObject/StackEvent.php b/src/Service/CloudFormation/src/ValueObject/StackEvent.php
@@ -2,6 +2,9 @@
 
 namespace AsyncAws\CloudFormation\ValueObject;
 
+use AsyncAws\CloudFormation\Enum\HookFailureMode;
+use AsyncAws\CloudFormation\Enum\HookInvocationPoint;
+use AsyncAws\CloudFormation\Enum\HookStatus;
 use AsyncAws\CloudFormation\Enum\ResourceStatus;
 
 /**
@@ -67,6 +70,31 @@ final class StackEvent
      */
     private $clientRequestToken;
 
+    /**
+     * The name of the hook.
+     */
+    private $hookType;
+
+    /**
+     * Provides the status of the change set hook.
+     */
+    private $hookStatus;
+
+    /**
+     * Provides the reason for the hook status.
+     */
+    private $hookStatusReason;
+
+    /**
+     * Invocation points are points in provisioning logic where hooks are initiated.
+     */
+    private $hookInvocationPoint;
+
+    /**
+     * Specify the hook failure mode for non-compliant resources in the followings ways.
+     */
+    private $hookFailureMode;
+
     /**
      * @param array{
      *   StackId: string,
@@ -80,6 +108,11 @@ final class StackEvent
      *   ResourceStatusReason?: null|string,
      *   ResourceProperties?: null|string,
      *   ClientRequestToken?: null|string,
+     *   HookType?: null|string,
+     *   HookStatus?: null|HookStatus::*,
+     *   HookStatusReason?: null|string,
+     *   HookInvocationPoint?: null|HookInvocationPoint::*,
+     *   HookFailureMode?: null|HookFailureMode::*,
      * } $input
      */
     public function __construct(array $input)
@@ -95,6 +128,11 @@ public function __construct(array $input)
         $this->resourceStatusReason = $input['ResourceStatusReason'] ?? null;
         $this->resourceProperties = $input['ResourceProperties'] ?? null;
         $this->clientRequestToken = $input['ClientRequestToken'] ?? null;
+        $this->hookType = $input['HookType'] ?? null;
+        $this->hookStatus = $input['HookStatus'] ?? null;
+        $this->hookStatusReason = $input['HookStatusReason'] ?? null;
+        $this->hookInvocationPoint = $input['HookInvocationPoint'] ?? null;
+        $this->hookFailureMode = $input['HookFailureMode'] ?? null;
     }
 
     public static function create($input): self
@@ -112,6 +150,40 @@ public function getEventId(): string
         return $this->eventId;
     }
 
+    /**
+     * @return HookFailureMode::*|null
+     */
+    public function getHookFailureMode(): ?string
+    {
+        return $this->hookFailureMode;
+    }
+
+    /**
+     * @return HookInvocationPoint::*|null
+     */
+    public function getHookInvocationPoint(): ?string
+    {
+        return $this->hookInvocationPoint;
+    }
+
+    /**
+     * @return HookStatus::*|null
+     */
+    public function getHookStatus(): ?string
+    {
+        return $this->hookStatus;
+    }
+
+    public function getHookStatusReason(): ?string
+    {
+        return $this->hookStatusReason;
+    }
+
+    public function getHookType(): ?string
+    {
+        return $this->hookType;
+    }
+
     public function getLogicalResourceId(): ?string
     {
         return $this->logicalResourceId;

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"variables": {`
`3`		`- "${LATEST}": "3.209.20"`
	`3`	`+ "${LATEST}": "3.209.21"`
`4`	`4`	`},`
`5`	`5`	`"endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",`
`6`	`6`	`"services": {`
Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,7 @@`
`6`	`6`	`* The status of the stack drift detection operation.`
`7`	`7`	`*`
`8`	`8`	* - `DETECTION_COMPLETE`: The stack drift detection operation has successfully completed for all resources in the stack
`9`		`- * that support drift detection. (Resources that do not currently support stack detection remain unchecked.)`
	`9`	`+ * that support drift detection. (Resources that don't currently support stack detection remain unchecked.)`
`10`	`10`	`* If you specified logical resource IDs for CloudFormation to use as a filter for the stack drift detection`
`11`	`11`	`* operation, only the resources with those logical IDs are checked for drift.`
`12`	`12`	* - `DETECTION_FAILED`: The stack drift detection operation has failed for at least one resource in the stack. Results
Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@`
`7`	`7`	`*`
`8`	`8`	* - `DRIFTED`: The stack differs from its expected template configuration. A stack is considered to have drifted if one
`9`	`9`	`* or more of its resources have drifted.`
`10`		- * - `NOT_CHECKED`: CloudFormation has not checked if the stack differs from its expected template configuration.
	`10`	+ * - `NOT_CHECKED`: CloudFormation hasn't checked if the stack differs from its expected template configuration.
`11`	`11`	* - `IN_SYNC`: The stack's actual configuration matches its expected template configuration.
`12`	`12`	* - `UNKNOWN`: This value is reserved for future use.
`13`	`13`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`	`final class DescribeStackEventsInput extends Input`
`13`	`13`	`{`
`14`	`14`	`/**`
`15`		`- * The name or the unique stack ID that is associated with the stack, which are not always interchangeable:.`
	`15`	`+ * The name or the unique stack ID that's associated with the stack, which aren't always interchangeable:.`
`16`	`16`	`*`
`17`	`17`	`* @var string\|null`
`18`	`18`	`*/`