Update generated code (#1780)

update generated code

Author: async-aws-bot

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Changed
+
+- AWS enhancement: Documentation updates.
+
 ## 1.7.1
 
 ### Changed

src/CloudFormationClient.php

@@ -21,8 +21,8 @@ class CloudFormationClient extends AbstractApi
      * Returns information about a stack drift detection operation. A stack drift detection operation detects whether a
      * stack's actual configuration differs, or has *drifted*, from its expected configuration, as defined in the stack
      * template and any values specified as template parameters. A stack is considered to have drifted if one or more of its
-     * resources have drifted. For more information about stack and resource drift, see Detecting Unregulated Configuration
-     * Changes to Stacks and Resources [^1].
+     * resources have drifted. For more information about stack and resource drift, see Detect unmanaged configuration
+     * changes to stacks and resources with drift detection [^1].
      *
      * Use DetectStackDrift to initiate a stack drift detection operation. `DetectStackDrift` returns a
      * `StackDriftDetectionId` you can use to monitor the progress of the operation using
@@ -49,7 +49,7 @@ public function describeStackDriftDetectionStatus($input): DescribeStackDriftDet
 
     /**
      * Returns all stack related events for a specified stack in reverse chronological order. For more information about a
-     * stack's event history, see CloudFormation stack creation events [^1] in the *CloudFormation User Guide*.
+     * stack's event history, see Understand CloudFormation stack creation events [^1] in the *CloudFormation User Guide*.
      *
      * > You can list events for stacks that have failed to create or have been deleted by specifying the unique stack
      * > identifier (stack ID).
@@ -75,8 +75,8 @@ public function describeStackEvents($input = []): DescribeStackEventsOutput
 
     /**
      * Returns the description for the specified stack; if no stack name was specified, then it returns the description for
-     * all the stacks created. For more information about a stack's event history, see CloudFormation stack creation events
-     * [^1] in the *CloudFormation User Guide*.
+     * all the stacks created. For more information about a stack's event history, see Understand CloudFormation stack
+     * creation events [^1] in the *CloudFormation User Guide*.
      *
      * > If the stack doesn't exist, a `ValidationError` is returned.
      *

src/ValueObject/Parameter.php

@@ -31,10 +31,11 @@ final class Parameter
     private $usePreviousValue;
 
     /**
-     * Read-only. The value that corresponds to a SSM parameter key. This field is returned only for SSM [^1] parameter
-     * types in the template.
+     * Read-only. The value that corresponds to a Systems Manager parameter key. This field is returned only for Systems
+     * Manager parameter types in the template. For more information, see Use CloudFormation-supplied parameter types [^1]
+     * in the *CloudFormation User Guide*.
      *
-     * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html#aws-ssm-parameter-types
+     * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-supplied-parameter-types.html
      *
      * @var string|null
      */

src/ValueObject/RollbackConfiguration.php

@@ -8,7 +8,7 @@
  *
  * Rollback triggers enable you to have CloudFormation monitor the state of your application during stack creation and
  * updating, and to roll back that operation if the application breaches the threshold of any of the alarms you've
- * specified. For more information, see Monitor and Roll Back Stack Operations [^1].
+ * specified. For more information, see Roll back your CloudFormation stack on alarm breach with rollback triggers [^1].
  *
  * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-rollback-triggers.html
  */

src/ValueObject/RollbackTrigger.php

@@ -24,7 +24,7 @@ final class RollbackTrigger
      * The resource type of the rollback trigger. Specify either AWS::CloudWatch::Alarm [^1] or
      * AWS::CloudWatch::CompositeAlarm [^2] resource types.
      *
-     * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cw-alarm.html
+     * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-alarm.html
      * [^2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-compositealarm.html
      *
      * @var string

src/ValueObject/Stack.php

@@ -130,8 +130,8 @@ final class Stack
     private $outputs;
 
     /**
-     * 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.
+     * The Amazon Resource Name (ARN) of an IAM role that's associated with the stack. During a stack operation,
+     * CloudFormation uses this role's credentials to make calls on your behalf.
      *
      * @var string|null
      */
@@ -148,7 +148,8 @@ final class Stack
      * Whether termination protection is enabled for the stack.
      *
      * For nested stacks [^1], termination protection is set on the root stack and can't be changed directly on the nested
-     * stack. For more information, see Protecting a Stack From Being Deleted [^2] in the *CloudFormation User Guide*.
+     * stack. For more information, see Protect a CloudFormation stack from being deleted [^2] in the *CloudFormation User
+     * Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
      * [^2]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html
@@ -161,7 +162,8 @@ final class Stack
      * For nested stacks--stacks created as resources for another stack--the stack ID of the direct parent of this stack.
      * For the first level of nested stacks, the root stack is also the parent stack.
      *
-     * For more information, see Working with Nested Stacks [^1] in the *CloudFormation User Guide*.
+     * For more information, see Embed stacks within other stacks using nested stacks [^1] in the *CloudFormation User
+     * Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
      *
@@ -173,7 +175,8 @@ final class Stack
      * For nested stacks--stacks created as resources for another stack--the stack ID of the top-level stack to which the
      * nested stack ultimately belongs.
      *
-     * For more information, see Working with Nested Stacks [^1] in the *CloudFormation User Guide*.
+     * For more information, see Embed stacks within other stacks using nested stacks [^1] in the *CloudFormation User
+     * Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html
      *
@@ -183,8 +186,8 @@ final class Stack
 
     /**
      * Information about whether a stack's actual configuration differs, or has *drifted*, from its expected configuration,
-     * as defined in the stack template and any values specified as template parameters. For more information, see Detecting
-     * Unregulated Configuration Changes to Stacks and Resources [^1].
+     * as defined in the stack template and any values specified as template parameters. For more information, see Detect
+     * unmanaged configuration changes to stacks and resources with drift detection [^1].
      *
      * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
      *
@@ -216,7 +219,7 @@ final class Stack
      * The detailed status of the resource or stack. If `CONFIGURATION_COMPLETE` is present, the resource or resource
      * configuration phase has completed and the stabilization of the resources is in progress. The stack sets
      * `CONFIGURATION_COMPLETE` when all of the resources in the stack have reached that event. For more information, see
-     * CloudFormation stack deployment [^1] in the *CloudFormation User Guide*.
+     * Understand CloudFormation stack creation events [^1] in the *CloudFormation User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html
      *

src/ValueObject/StackEvent.php

@@ -50,8 +50,8 @@ final class StackEvent
     private $physicalResourceId;
 
     /**
-     * Type of resource. (For more information, go to Amazon Web Services Resource Types Reference [^1] in the
-     * *CloudFormation User Guide*.).
+     * Type of resource. For more information, see Amazon Web Services resource and property types reference [^1] in the
+     * *CloudFormation User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html
      *
@@ -145,7 +145,7 @@ final class StackEvent
      * An optional field containing information about the detailed status of the stack event.
      *
      * - `CONFIGURATION_COMPLETE` - all of the resources in the stack have reached that event. For more information, see
-     *   CloudFormation stack deployment [^1] in the *CloudFormation User Guide*.
+     *   Understand CloudFormation stack creation events [^1] in the *CloudFormation User Guide*.
      *
      * - `VALIDATION_FAILED` - template validation failed because of invalid properties in the template. The
      *   `ResourceStatusReason` field shows what properties are defined incorrectly.

src/ValueObject/Tag.php

@@ -12,7 +12,7 @@ final class Tag
 {
     /**
      * *Required*. A string used to identify this tag. You can specify a maximum of 128 characters for a tag key. Tags owned
-     * by Amazon Web Services (Amazon Web Services) have the reserved prefix: `aws:`.
+     * by Amazon Web Services have the reserved prefix: `aws:`.
      *
      * @var string
      */