Update generated code (#1378)

update generated code

Author: async-aws-bot

src/DynamoDbClient.php

@@ -275,8 +275,11 @@ public function deleteTable($input): DeleteTableOutput
     }
 
     /**
-     * Returns the regional endpoint information.
+     * Returns the regional endpoint information. This action must be included in your VPC endpoint policies, or access to
+     * the DescribeEndpoints API will be denied. For more information on policy permissions, please see Internetwork traffic
+     * privacy.
      *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/inter-network-traffic-privacy.html#inter-network-traffic-DescribeEndpoints
      * @see https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeEndpoints.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-dynamodb-2012-08-10.html#describeendpoints
      *

src/Enum/Select.php

@@ -13,7 +13,8 @@
  * - `ALL_PROJECTED_ATTRIBUTES` - Allowed only when querying an index. Retrieves all attributes that have been projected
  *   into the index. If the index is configured to project all attributes, this return value is equivalent to specifying
  *   `ALL_ATTRIBUTES`.
- * - `COUNT` - Returns the number of matching items, rather than the matching items themselves.
+ * - `COUNT` - Returns the number of matching items, rather than the matching items themselves. Note that this uses the
+ *   same quantity of read capacity units as getting the items, and is subject to the same item size calculations.
  * - `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in `ProjectionExpression`. This return value is
  *   equivalent to specifying `ProjectionExpression` without specifying any value for `Select`.
  *   If you query or scan a local secondary index and request only attributes that are projected into that index, the

src/Exception/TransactionCanceledException.php

@@ -87,8 +87,8 @@
  *     - Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is automatically
  *       scaling your index so please try again shortly.
  *
- *       > This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically
- *       > scaling the GSI.
+ *       > This message is returned when writes get throttled on an On-Demand GSI as DynamoDB is automatically scaling
+ *       > the GSI.
  *
  *
  *

src/Exception/TransactionInProgressException.php

@@ -7,6 +7,32 @@
 
 /**
  * The transaction with the given request token is already in progress.
+ * Recommended Settings.
+ *
+ * > This is a general recommendation for handling the `TransactionInProgressException`. These settings help ensure that
+ * > the client retries will trigger completion of the ongoing `TransactWriteItems` request.
+ *
+ * - Set `clientExecutionTimeout` to a value that allows at least one retry to be processed after 5 seconds have elapsed
+ *   since the first attempt for the `TransactWriteItems` operation.
+ * - Set `socketTimeout` to a value a little lower than the `requestTimeout` setting.
+ * - `requestTimeout` should be set based on the time taken for the individual retries of a single HTTP request for your
+ *   use case, but setting it to 1 second or higher should work well to reduce chances of retries and
+ *   `TransactionInProgressException` errors.
+ * - Use exponential backoff when retrying and tune backoff if needed.
+ *
+ * Assuming default retry policy, example timeout settings based on the guidelines above are as follows:
+ * Example timeline:
+ *
+ * - 0-1000 first attempt
+ * - 1000-1500 first sleep/delay (default retry policy uses 500 ms as base delay for 4xx errors)
+ * - 1500-2500 second attempt
+ * - 2500-3500 second sleep/delay (500 * 2, exponential backoff)
+ * - 3500-4500 third attempt
+ * - 4500-6500 third sleep/delay (500 * 2^2)
+ * - 6500-7500 fourth attempt (this can trigger inline recovery since 5 seconds have elapsed since the first attempt
+ *   reached TC)
+ *
+ * @see https://github.com/aws/aws-sdk-java/blob/fd409dee8ae23fb8953e0bb4dbde65536a7e0514/aws-java-sdk-core/src/main/java/com/amazonaws/retry/PredefinedRetryPolicies.java#L97
  */
 final class TransactionInProgressException extends ClientException
 {

src/Input/UpdateItemInput.php

@@ -68,8 +68,8 @@ final class UpdateItemInput extends Input
     private $conditionalOperator;
 
     /**
-     * Use `ReturnValues` if you want to get the item attributes as they appear before or after they are updated. For
-     * `UpdateItem`, the valid values are:.
+     * Use `ReturnValues` if you want to get the item attributes as they appear before or after they are successfully
+     * updated. For `UpdateItem`, the valid values are:.
      *
      * @var ReturnValue::*|null
      */

src/Result/DeleteItemOutput.php

@@ -24,7 +24,7 @@ class DeleteItemOutput extends Result
      * The capacity units consumed by the `DeleteItem` operation. The data returned includes the total provisioned
      * throughput consumed, along with statistics for the table and any indexes involved in the operation.
      * `ConsumedCapacity` is only returned if the `ReturnConsumedCapacity` parameter was specified. For more information,
-     * see Provisioned Mode in the *Amazon DynamoDB Developer Guide*.
+     * see Provisioned Throughput in the *Amazon DynamoDB Developer Guide*.
      *
      * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
      */

src/Result/GetItemOutput.php

@@ -21,10 +21,10 @@ class GetItemOutput extends Result
     /**
      * The capacity units consumed by the `GetItem` operation. The data returned includes the total provisioned throughput
      * consumed, along with statistics for the table and any indexes involved in the operation. `ConsumedCapacity` is only
-     * returned if the `ReturnConsumedCapacity` parameter was specified. For more information, see Read/Write Capacity Mode
-     * in the *Amazon DynamoDB Developer Guide*.
+     * returned if the `ReturnConsumedCapacity` parameter was specified. For more information, see Provisioned Throughput in
+     * the *Amazon DynamoDB Developer Guide*.
      *
-     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
      */
     private $consumedCapacity;
 

src/Result/PutItemOutput.php

@@ -23,8 +23,8 @@ class PutItemOutput extends Result
     /**
      * The capacity units consumed by the `PutItem` operation. The data returned includes the total provisioned throughput
      * consumed, along with statistics for the table and any indexes involved in the operation. `ConsumedCapacity` is only
-     * returned if the `ReturnConsumedCapacity` parameter was specified. For more information, see Read/Write Capacity Mode
-     * in the *Amazon DynamoDB Developer Guide*.
+     * returned if the `ReturnConsumedCapacity` parameter was specified. For more information, see Provisioned Throughput in
+     * the *Amazon DynamoDB Developer Guide*.
      *
      * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
      */

src/Result/ScanOutput.php

@@ -50,7 +50,7 @@ class ScanOutput extends Result implements \IteratorAggregate
      * returned if the `ReturnConsumedCapacity` parameter was specified. For more information, see Provisioned Throughput in
      * the *Amazon DynamoDB Developer Guide*.
      *
-     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
      */
     private $consumedCapacity;
 

src/Result/UpdateItemOutput.php

@@ -26,7 +26,7 @@ class UpdateItemOutput extends Result
      * `ConsumedCapacity` is only returned if the `ReturnConsumedCapacity` parameter was specified. For more information,
      * see Provisioned Throughput in the *Amazon DynamoDB Developer Guide*.
      *
-     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
      */
     private $consumedCapacity;