Update generated code (#1877)

* update generated code

* Apply suggestions from code review

---------

Co-authored-by: Jérémy Derussé <[email protected]>

Author: async-aws-bot

CHANGELOG.md

@@ -10,6 +10,7 @@
 ### Changed
 
 - Sort exception alphabetically.
+- AWS enhancement: Documentation updates.
 
 ## 3.5.0
 

src/DynamoDbClient.php

@@ -131,6 +131,8 @@ class DynamoDbClient extends AbstractApi
      * minimum read capacity units according to the type of read. For more information, see Working with Tables [^2] in the
      * *Amazon DynamoDB Developer Guide*.
      *
+     * > `BatchGetItem` will result in a `ValidationException` if the same key is specified multiple times.
+     *
      * [^1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations
      * [^2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#CapacityUnitCalculations
      *

src/ValueObject/CreateGlobalSecondaryIndexAction.php

@@ -45,7 +45,8 @@ final class CreateGlobalSecondaryIndexAction
 
     /**
      * The maximum number of read and write units for the global secondary index being created. If you use this parameter,
-     * you must specify `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both.
+     * you must specify `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both. You must use either `OnDemand Throughput` or
+     * `ProvisionedThroughput` based on your table's capacity mode.
      *
      * @var OnDemandThroughput|null
      */

src/ValueObject/ProvisionedThroughput.php

@@ -5,8 +5,8 @@
 use AsyncAws\Core\Exception\InvalidArgument;
 
 /**
- * Represents the provisioned throughput settings for a specified table or index. The settings can be modified using the
- * `UpdateTable` operation.
+ * Represents the provisioned throughput settings for the specified global secondary index. You must use
+ * `ProvisionedThroughput` or `OnDemandThroughput` based on your table’s capacity mode.
  *
  * For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas [^1] in the
  * *Amazon DynamoDB Developer Guide*.

src/ValueObject/TableWarmThroughputDescription.php

@@ -5,7 +5,9 @@
 use AsyncAws\DynamoDb\Enum\TableStatus;
 
 /**
- * Represents the warm throughput value (in read units per second and write units per second) of the base table.
+ * Represents the warm throughput value (in read units per second and write units per second) of the table. Warm
+ * throughput is applicable for DynamoDB Standard-IA tables and specifies the minimum provisioned capacity maintained
+ * for immediate data access.
  */
 final class TableWarmThroughputDescription
 {
@@ -24,7 +26,7 @@ final class TableWarmThroughputDescription
     private $writeUnitsPerSecond;
 
     /**
-     * Represents warm throughput value of the base table..
+     * Represents warm throughput value of the base table.
      *
      * @var TableStatus::*|null
      */