diff --git a/manifest.json b/manifest.json index 8ed2dd73f..6e3d212be 100644 --- a/manifest.json +++ b/manifest.json @@ -1,6 +1,6 @@ { "variables": { - "${LATEST}": "3.323.3" + "${LATEST}": "3.324.3" }, "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 index 9cf0d73f9..0483caf5c 100644 --- a/src/Service/CloudFormation/CHANGELOG.md +++ b/src/Service/CloudFormation/CHANGELOG.md @@ -2,6 +2,10 @@ ## NOT RELEASED +### Changed + +- AWS enhancement: Documentation updates. + ## 1.7.1 ### Changed diff --git a/src/Service/CloudFormation/src/CloudFormationClient.php b/src/Service/CloudFormation/src/CloudFormationClient.php index d3e5383b1..b2d3ab48c 100644 --- a/src/Service/CloudFormation/src/CloudFormationClient.php +++ b/src/Service/CloudFormation/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. * diff --git a/src/Service/CloudFormation/src/ValueObject/Parameter.php b/src/Service/CloudFormation/src/ValueObject/Parameter.php index bcaaa27d1..f153518a5 100644 --- a/src/Service/CloudFormation/src/ValueObject/Parameter.php +++ b/src/Service/CloudFormation/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 */ diff --git a/src/Service/CloudFormation/src/ValueObject/RollbackConfiguration.php b/src/Service/CloudFormation/src/ValueObject/RollbackConfiguration.php index 3b4708f38..6a10b5a48 100644 --- a/src/Service/CloudFormation/src/ValueObject/RollbackConfiguration.php +++ b/src/Service/CloudFormation/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 */ diff --git a/src/Service/CloudFormation/src/ValueObject/RollbackTrigger.php b/src/Service/CloudFormation/src/ValueObject/RollbackTrigger.php index 96b28e932..0fa4dae7c 100644 --- a/src/Service/CloudFormation/src/ValueObject/RollbackTrigger.php +++ b/src/Service/CloudFormation/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 diff --git a/src/Service/CloudFormation/src/ValueObject/Stack.php b/src/Service/CloudFormation/src/ValueObject/Stack.php index 63839d7ba..428b3a466 100644 --- a/src/Service/CloudFormation/src/ValueObject/Stack.php +++ b/src/Service/CloudFormation/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 * diff --git a/src/Service/CloudFormation/src/ValueObject/StackEvent.php b/src/Service/CloudFormation/src/ValueObject/StackEvent.php index 4407d3d16..c67b6d137 100644 --- a/src/Service/CloudFormation/src/ValueObject/StackEvent.php +++ b/src/Service/CloudFormation/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. diff --git a/src/Service/CloudFormation/src/ValueObject/Tag.php b/src/Service/CloudFormation/src/ValueObject/Tag.php index 07cbfcbb0..22abcc5a7 100644 --- a/src/Service/CloudFormation/src/ValueObject/Tag.php +++ b/src/Service/CloudFormation/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 */