Update generated code (#1682)

update generated code

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.300.13"
+        "${LATEST}": "3.300.14"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {

src/Service/CodeBuild/CHANGELOG.md

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

src/Service/CodeBuild/src/CodeBuildClient.php

@@ -58,7 +58,12 @@ public function batchGetBuilds($input): BatchGetBuildsOutput
     }
 
     /**
-     * Starts running a build.
+     * Starts running a build with the settings defined in the project. These setting include: how to run a build, where to
+     * get the source code, which build environment to use, which build commands to run, and where to store the build
+     * output.
+     *
+     * You can also start a build run by overriding some of the build settings in the project. The overrides only apply for
+     * that specific start build request. The settings in the project are unaltered.
      *
      * @see https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-codebuild-2016-10-06.html#startbuild

src/Service/CodeBuild/src/Input/StartBuildInput.php

@@ -142,8 +142,8 @@ final class StartBuildInput extends Input
     private $gitSubmodulesConfigOverride;
 
     /**
-     * A buildspec file declaration that overrides, for this build only, the latest one already defined in the build
-     * project.
+     * A buildspec file declaration that overrides the latest one defined in the build project, for this build only. The
+     * buildspec defined on the project is not changed.
      *
      * If this value is set, it can be either an inline buildspec definition, the path to an alternate buildspec file
      * relative to the value of the built-in `CODEBUILD_SRC_DIR` environment variable, or the path to an S3 bucket. The
@@ -152,6 +152,11 @@ final class StartBuildInput extends Input
      * string, the source code must contain a buildspec file in its root directory. For more information, see Buildspec File
      * Name and Storage Location [^1].
      *
+     * > Since this property allows you to change the build commands that will run in the container, you should note that an
+     * > IAM principal with the ability to call this API and set this parameter can override the default settings. Moreover,
+     * > we encourage that you use a trustworthy buildspec location like a file in your source repository or a Amazon S3
+     * > bucket.
+     *
      * [^1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec-ref-name-storage
      *
      * @var string|null

src/Service/CognitoIdentityProvider/CHANGELOG.md

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

src/Service/CognitoIdentityProvider/src/CognitoIdentityProviderClient.php

@@ -648,16 +648,19 @@ public function adminRemoveUserFromGroup($input): Result
     /**
      * Resets the specified user's password in a user pool as an administrator. Works on any user.
      *
+     * To use this API operation, your user pool must have self-service account recovery configured. Use
+     * AdminSetUserPassword [^1] if you manage passwords as an administrator.
+     *
      * > This action might generate an SMS text message. Starting June 1, 2021, US telecom carriers require you to register
      * > an origination phone number before you can send SMS messages to US phone numbers. If you use SMS text messages in
-     * > Amazon Cognito, you must register a phone number with Amazon Pinpoint [^1]. Amazon Cognito uses the registered
+     * > Amazon Cognito, you must register a phone number with Amazon Pinpoint [^2]. Amazon Cognito uses the registered
      * > number automatically. Otherwise, Amazon Cognito users who must receive SMS messages might not be able to sign up,
      * > activate their accounts, or sign in.
      * >
      * > If you have never used SMS text messages with Amazon Cognito or any other Amazon Web Service, Amazon Simple
-     * > Notification Service might place your account in the SMS sandbox. In *sandbox mode [^2]*, you can send messages
+     * > Notification Service might place your account in the SMS sandbox. In *sandbox mode [^3]*, you can send messages
      * > only to verified phone numbers. After you test your app while in the sandbox environment, you can move out of the
-     * > sandbox and into production. For more information, see SMS message settings for Amazon Cognito user pools [^3] in
+     * > sandbox and into production. For more information, see SMS message settings for Amazon Cognito user pools [^4] in
      * > the *Amazon Cognito Developer Guide*.
      *
      * Deactivates a user's password, requiring them to change it. If a user tries to sign in after the API is called,
@@ -673,15 +676,16 @@ public function adminRemoveUserFromGroup($input): Result
      * >
      * > **Learn more**
      * >
-     * > - Signing Amazon Web Services API Requests [^4]
-     * > - Using the Amazon Cognito user pools API and user pool endpoints [^5]
+     * > - Signing Amazon Web Services API Requests [^5]
+     * > - Using the Amazon Cognito user pools API and user pool endpoints [^6]
      * >
      *
-     * [^1]: https://console.aws.amazon.com/pinpoint/home/
-     * [^2]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
-     * [^3]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html
-     * [^4]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html
-     * [^5]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pools-API-operations.html
+     * [^1]: https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminSetUserPassword.html
+     * [^2]: https://console.aws.amazon.com/pinpoint/home/
+     * [^3]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
+     * [^4]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html
+     * [^5]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html
+     * [^6]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pools-API-operations.html
      *
      * @see https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminResetUserPassword.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cognito-idp-2016-04-18.html#adminresetuserpassword
@@ -1258,29 +1262,33 @@ public function createGroup($input): CreateGroupResponse
      * app client has a client secret and you don't provide a `SECRET_HASH` parameter, this API returns
      * `NotAuthorizedException`.
      *
+     * To use this API operation, your user pool must have self-service account recovery configured. Use
+     * AdminSetUserPassword [^3] if you manage passwords as an administrator.
+     *
      * > Amazon Cognito doesn't evaluate Identity and Access Management (IAM) policies in requests for this API operation.
      * > For this operation, you can't use IAM credentials to authorize requests, and you can't grant IAM permissions in
      * > policies. For more information about authorization models in Amazon Cognito, see Using the Amazon Cognito user
-     * > pools API and user pool endpoints [^3].
+     * > pools API and user pool endpoints [^4].
      *
      * > This action might generate an SMS text message. Starting June 1, 2021, US telecom carriers require you to register
      * > an origination phone number before you can send SMS messages to US phone numbers. If you use SMS text messages in
-     * > Amazon Cognito, you must register a phone number with Amazon Pinpoint [^4]. Amazon Cognito uses the registered
+     * > Amazon Cognito, you must register a phone number with Amazon Pinpoint [^5]. Amazon Cognito uses the registered
      * > number automatically. Otherwise, Amazon Cognito users who must receive SMS messages might not be able to sign up,
      * > activate their accounts, or sign in.
      * >
      * > If you have never used SMS text messages with Amazon Cognito or any other Amazon Web Service, Amazon Simple
-     * > Notification Service might place your account in the SMS sandbox. In *sandbox mode [^5]*, you can send messages
+     * > Notification Service might place your account in the SMS sandbox. In *sandbox mode [^6]*, you can send messages
      * > only to verified phone numbers. After you test your app while in the sandbox environment, you can move out of the
-     * > sandbox and into production. For more information, see SMS message settings for Amazon Cognito user pools [^6] in
+     * > sandbox and into production. For more information, see SMS message settings for Amazon Cognito user pools [^7] in
      * > the *Amazon Cognito Developer Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/cognito/latest/developerguide/how-to-recover-a-user-account.html
      * [^2]: https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ConfirmForgotPassword.html
-     * [^3]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pools-API-operations.html
-     * [^4]: https://console.aws.amazon.com/pinpoint/home/
-     * [^5]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
-     * [^6]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html
+     * [^3]: https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminSetUserPassword.html
+     * [^4]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pools-API-operations.html
+     * [^5]: https://console.aws.amazon.com/pinpoint/home/
+     * [^6]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
+     * [^7]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html
      *
      * @see https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ForgotPassword.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cognito-idp-2016-04-18.html#forgotpassword

src/Service/CognitoIdentityProvider/src/Input/AdminAddUserToGroupRequest.php

@@ -20,8 +20,8 @@ final class AdminAddUserToGroupRequest extends Input
 
     /**
      * The username of the user that you want to query or modify. The value of this parameter is typically your user's
-     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, you
-     * can also use their `sub` in this request.
+     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, this
+     * value must be the `sub` of a local user or the username of a user from a third-party IdP.
      *
      * @required
      *

src/Service/CognitoIdentityProvider/src/Input/AdminConfirmSignUpRequest.php

@@ -23,8 +23,8 @@ final class AdminConfirmSignUpRequest extends Input
 
     /**
      * The username of the user that you want to query or modify. The value of this parameter is typically your user's
-     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, you
-     * can also use their `sub` in this request.
+     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, this
+     * value must be the `sub` of a local user or the username of a user from a third-party IdP.
      *
      * @required
      *

src/Service/CognitoIdentityProvider/src/Input/AdminDeleteUserRequest.php

@@ -23,8 +23,8 @@ final class AdminDeleteUserRequest extends Input
 
     /**
      * The username of the user that you want to query or modify. The value of this parameter is typically your user's
-     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, you
-     * can also use their `sub` in this request.
+     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, this
+     * value must be the `sub` of a local user or the username of a user from a third-party IdP.
      *
      * @required
      *

src/Service/CognitoIdentityProvider/src/Input/AdminDisableUserRequest.php

@@ -23,8 +23,8 @@ final class AdminDisableUserRequest extends Input
 
     /**
      * The username of the user that you want to query or modify. The value of this parameter is typically your user's
-     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, you
-     * can also use their `sub` in this request.
+     * username, but it can be any of their alias attributes. If `username` isn't an alias attribute in your user pool, this
+     * value must be the `sub` of a local user or the username of a user from a third-party IdP.
      *
      * @required
      *