Update generated code (#1910)

update generated code

Author: async-aws-bot

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: This change adds support for witnesses in global tables. It also adds a new table status, REPLICATION_NOT_AUTHORIZED. This status will indicate scenarios where global replicas table can't be utilized for data plane operations.
+
 ## 3.6.0
 
 ### Added

composer.json

@@ -32,7 +32,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "3.6-dev"
+            "dev-master": "3.7-dev"
         }
     }
 }

src/DynamoDbClient.php

@@ -73,6 +73,7 @@
 use AsyncAws\DynamoDb\ValueObject\ExpectedAttributeValue;
 use AsyncAws\DynamoDb\ValueObject\GlobalSecondaryIndex;
 use AsyncAws\DynamoDb\ValueObject\GlobalSecondaryIndexUpdate;
+use AsyncAws\DynamoDb\ValueObject\GlobalTableWitnessGroupUpdate;
 use AsyncAws\DynamoDb\ValueObject\KeysAndAttributes;
 use AsyncAws\DynamoDb\ValueObject\KeySchemaElement;
 use AsyncAws\DynamoDb\ValueObject\LocalSecondaryIndex;
@@ -241,6 +242,7 @@ public function batchGetItem($input): BatchGetItemOutput
      * @throws InternalServerErrorException
      * @throws ItemCollectionSizeLimitExceededException
      * @throws ProvisionedThroughputExceededException
+     * @throws ReplicatedWriteConflictException
      * @throws RequestLimitExceededException
      * @throws ResourceNotFoundException
      */
@@ -251,6 +253,7 @@ public function batchWriteItem($input): BatchWriteItemOutput
             'InternalServerError' => InternalServerErrorException::class,
             'ItemCollectionSizeLimitExceededException' => ItemCollectionSizeLimitExceededException::class,
             'ProvisionedThroughputExceededException' => ProvisionedThroughputExceededException::class,
+            'ReplicatedWriteConflictException' => ReplicatedWriteConflictException::class,
             'RequestLimitExceeded' => RequestLimitExceededException::class,
             'ResourceNotFoundException' => ResourceNotFoundException::class,
         ], 'usesEndpointDiscovery' => true]));
@@ -375,8 +378,6 @@ public function deleteItem($input): DeleteItemOutput
      * specified table does not exist, DynamoDB returns a `ResourceNotFoundException`. If table is already in the `DELETING`
      * state, no error is returned.
      *
-     * ! For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version).
-     *
      * > DynamoDB might continue to accept data read and write operations, such as `GetItem` and `PutItem`, on a table in
      * > the `DELETING` state until the table deletion is complete. For the full list of table states, see TableStatus [^1].
      *
@@ -440,8 +441,6 @@ public function describeEndpoints($input = []): DescribeEndpointsResponse
      * Returns information about the table, including the current status of the table, when it was created, the primary key
      * schema, and any indexes on the table.
      *
-     * ! For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version).
-     *
      * > If you issue a `DescribeTable` request immediately after a `CreateTable` request, DynamoDB might return a
      * > `ResourceNotFoundException`. This is because `DescribeTable` uses an eventually consistent query, and the metadata
      * > for your table might not be available at that moment. Wait for a few seconds, and then try the `DescribeTable`
@@ -984,8 +983,6 @@ public function updateItem($input): UpdateItemOutput
      * Modifies the provisioned throughput settings, global secondary indexes, or DynamoDB Streams settings for a given
      * table.
      *
-     * ! For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version).
-     *
      * You can only perform one of the following operations at once:
      *
      * - Modify the provisioned throughput settings of the table.
@@ -1012,6 +1009,7 @@ public function updateItem($input): UpdateItemOutput
      *   TableClass?: null|TableClass::*,
      *   DeletionProtectionEnabled?: null|bool,
      *   MultiRegionConsistency?: null|MultiRegionConsistency::*,
+     *   GlobalTableWitnessUpdates?: null|array<GlobalTableWitnessGroupUpdate|array>,
      *   OnDemandThroughput?: null|OnDemandThroughput|array,
      *   WarmThroughput?: null|WarmThroughput|array,
      *   '@region'?: string|null,

src/Enum/ReplicaStatus.php

@@ -5,22 +5,28 @@
 final class ReplicaStatus
 {
     public const ACTIVE = 'ACTIVE';
+    public const ARCHIVED = 'ARCHIVED';
+    public const ARCHIVING = 'ARCHIVING';
     public const CREATING = 'CREATING';
     public const CREATION_FAILED = 'CREATION_FAILED';
     public const DELETING = 'DELETING';
     public const INACCESSIBLE_ENCRYPTION_CREDENTIALS = 'INACCESSIBLE_ENCRYPTION_CREDENTIALS';
     public const REGION_DISABLED = 'REGION_DISABLED';
+    public const REPLICATION_NOT_AUTHORIZED = 'REPLICATION_NOT_AUTHORIZED';
     public const UPDATING = 'UPDATING';
 
     public static function exists(string $value): bool
     {
         return isset([
             self::ACTIVE => true,
+            self::ARCHIVED => true,
+            self::ARCHIVING => true,
             self::CREATING => true,
             self::CREATION_FAILED => true,
             self::DELETING => true,
             self::INACCESSIBLE_ENCRYPTION_CREDENTIALS => true,
             self::REGION_DISABLED => true,
+            self::REPLICATION_NOT_AUTHORIZED => true,
             self::UPDATING => true,
         ][$value]);
     }

src/Enum/TableStatus.php

@@ -10,6 +10,7 @@ final class TableStatus
     public const CREATING = 'CREATING';
     public const DELETING = 'DELETING';
     public const INACCESSIBLE_ENCRYPTION_CREDENTIALS = 'INACCESSIBLE_ENCRYPTION_CREDENTIALS';
+    public const REPLICATION_NOT_AUTHORIZED = 'REPLICATION_NOT_AUTHORIZED';
     public const UPDATING = 'UPDATING';
 
     public static function exists(string $value): bool
@@ -21,6 +22,7 @@ public static function exists(string $value): bool
             self::CREATING => true,
             self::DELETING => true,
             self::INACCESSIBLE_ENCRYPTION_CREDENTIALS => true,
+            self::REPLICATION_NOT_AUTHORIZED => true,
             self::UPDATING => true,
         ][$value]);
     }

src/Enum/WitnessStatus.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace AsyncAws\DynamoDb\Enum;
+
+final class WitnessStatus
+{
+    public const ACTIVE = 'ACTIVE';
+    public const CREATING = 'CREATING';
+    public const DELETING = 'DELETING';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::ACTIVE => true,
+            self::CREATING => true,
+            self::DELETING => true,
+        ][$value]);
+    }
+}

src/Input/UpdateTableInput.php

@@ -11,6 +11,7 @@
 use AsyncAws\DynamoDb\Enum\TableClass;
 use AsyncAws\DynamoDb\ValueObject\AttributeDefinition;
 use AsyncAws\DynamoDb\ValueObject\GlobalSecondaryIndexUpdate;
+use AsyncAws\DynamoDb\ValueObject\GlobalTableWitnessGroupUpdate;
 use AsyncAws\DynamoDb\ValueObject\OnDemandThroughput;
 use AsyncAws\DynamoDb\ValueObject\ProvisionedThroughput;
 use AsyncAws\DynamoDb\ValueObject\ReplicationGroupUpdate;
@@ -104,8 +105,6 @@ final class UpdateTableInput extends Input
     /**
      * A list of replica update actions (create, delete, or update) for the table.
      *
-     * > For global tables, this property only applies to global tables using Version 2019.11.21 (Current version).
-     *
      * @var ReplicationGroupUpdate[]|null
      */
     private $replicaUpdates;
@@ -130,24 +129,39 @@ final class UpdateTableInput extends Input
      *
      * You can specify one of the following consistency modes:
      *
-     * - `EVENTUAL`: Configures a new global table for multi-Region eventual consistency. This is the default consistency
-     *   mode for global tables.
-     * - `STRONG`: Configures a new global table for multi-Region strong consistency (preview).
-     *
-     *   > Multi-Region strong consistency (MRSC) is a new DynamoDB global tables capability currently available in preview
-     *   > mode. For more information, see Global tables multi-Region strong consistency [^3].
+     * - `EVENTUAL`: Configures a new global table for multi-Region eventual consistency (MREC). This is the default
+     *   consistency mode for global tables.
+     * - `STRONG`: Configures a new global table for multi-Region strong consistency (MRSC).
      *
-     *
-     * If you don't specify this parameter, the global table consistency mode defaults to `EVENTUAL`.
+     * If you don't specify this field, the global table consistency mode defaults to `EVENTUAL`. For more information about
+     * global tables consistency modes, see Consistency modes [^3] in DynamoDB developer guide.
      *
      * [^1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ReplicationGroupUpdate.html#DDB-Type-ReplicationGroupUpdate-Create
      * [^2]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html#DDB-UpdateTable-request-ReplicaUpdates
-     * [^3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PreviewFeatures.html#multi-region-strong-consistency-gt
+     * [^3]: https://docs.aws.amazon.com/V2globaltables_HowItWorks.html#V2globaltables_HowItWorks.consistency-modes
      *
      * @var MultiRegionConsistency::*|null
      */
     private $multiRegionConsistency;
 
+    /**
+     * A list of witness updates for a MRSC global table. A witness provides a cost-effective alternative to a full replica
+     * in a MRSC global table by maintaining replicated change data written to global table replicas. You cannot perform
+     * read or write operations on a witness. For each witness, you can request one action:
+     *
+     * - `Create` - add a new witness to the global table.
+     * - `Delete` - remove a witness from the global table.
+     *
+     * You can create or delete only one witness per `UpdateTable` operation.
+     *
+     * For more information, see Multi-Region strong consistency (MRSC) [^1] in the Amazon DynamoDB Developer Guide
+     *
+     * [^1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html#V2globaltables_HowItWorks.consistency-modes
+     *
+     * @var GlobalTableWitnessGroupUpdate[]|null
+     */
+    private $globalTableWitnessUpdates;
+
     /**
      * Updates the maximum number of read and write units for the specified table in on-demand capacity mode. If you use
      * this parameter, you must specify `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both.
@@ -176,6 +190,7 @@ final class UpdateTableInput extends Input
      *   TableClass?: null|TableClass::*,
      *   DeletionProtectionEnabled?: null|bool,
      *   MultiRegionConsistency?: null|MultiRegionConsistency::*,
+     *   GlobalTableWitnessUpdates?: null|array<GlobalTableWitnessGroupUpdate|array>,
      *   OnDemandThroughput?: null|OnDemandThroughput|array,
      *   WarmThroughput?: null|WarmThroughput|array,
      *   '@region'?: string|null,
@@ -194,6 +209,7 @@ public function __construct(array $input = [])
         $this->tableClass = $input['TableClass'] ?? null;
         $this->deletionProtectionEnabled = $input['DeletionProtectionEnabled'] ?? null;
         $this->multiRegionConsistency = $input['MultiRegionConsistency'] ?? null;
+        $this->globalTableWitnessUpdates = isset($input['GlobalTableWitnessUpdates']) ? array_map([GlobalTableWitnessGroupUpdate::class, 'create'], $input['GlobalTableWitnessUpdates']) : null;
         $this->onDemandThroughput = isset($input['OnDemandThroughput']) ? OnDemandThroughput::create($input['OnDemandThroughput']) : null;
         $this->warmThroughput = isset($input['WarmThroughput']) ? WarmThroughput::create($input['WarmThroughput']) : null;
         parent::__construct($input);
@@ -212,6 +228,7 @@ public function __construct(array $input = [])
      *   TableClass?: null|TableClass::*,
      *   DeletionProtectionEnabled?: null|bool,
      *   MultiRegionConsistency?: null|MultiRegionConsistency::*,
+     *   GlobalTableWitnessUpdates?: null|array<GlobalTableWitnessGroupUpdate|array>,
      *   OnDemandThroughput?: null|OnDemandThroughput|array,
      *   WarmThroughput?: null|WarmThroughput|array,
      *   '@region'?: string|null,
@@ -251,6 +268,14 @@ public function getGlobalSecondaryIndexUpdates(): array
         return $this->globalSecondaryIndexUpdates ?? [];
     }
 
+    /**
+     * @return GlobalTableWitnessGroupUpdate[]
+     */
+    public function getGlobalTableWitnessUpdates(): array
+    {
+        return $this->globalTableWitnessUpdates ?? [];
+    }
+
     /**
      * @return MultiRegionConsistency::*|null
      */
@@ -368,6 +393,16 @@ public function setGlobalSecondaryIndexUpdates(array $value): self
         return $this;
     }
 
+    /**
+     * @param GlobalTableWitnessGroupUpdate[] $value
+     */
+    public function setGlobalTableWitnessUpdates(array $value): self
+    {
+        $this->globalTableWitnessUpdates = $value;
+
+        return $this;
+    }
+
     /**
      * @param MultiRegionConsistency::*|null $value
      */
@@ -501,6 +536,14 @@ private function requestBody(): array
             }
             $payload['MultiRegionConsistency'] = $v;
         }
+        if (null !== $v = $this->globalTableWitnessUpdates) {
+            $index = -1;
+            $payload['GlobalTableWitnessUpdates'] = [];
+            foreach ($v as $listValue) {
+                ++$index;
+                $payload['GlobalTableWitnessUpdates'][$index] = $listValue->requestBody();
+            }
+        }
         if (null !== $v = $this->onDemandThroughput) {
             $payload['OnDemandThroughput'] = $v->requestBody();
         }

src/Result/CreateTableOutput.php

@@ -9,6 +9,7 @@
 use AsyncAws\DynamoDb\ValueObject\BillingModeSummary;
 use AsyncAws\DynamoDb\ValueObject\GlobalSecondaryIndexDescription;
 use AsyncAws\DynamoDb\ValueObject\GlobalSecondaryIndexWarmThroughputDescription;
+use AsyncAws\DynamoDb\ValueObject\GlobalTableWitnessDescription;
 use AsyncAws\DynamoDb\ValueObject\KeySchemaElement;
 use AsyncAws\DynamoDb\ValueObject\LocalSecondaryIndexDescription;
 use AsyncAws\DynamoDb\ValueObject\OnDemandThroughput;
@@ -128,6 +129,27 @@ private function populateResultGlobalSecondaryIndexWarmThroughputDescription(arr
         ]);
     }
 
+    private function populateResultGlobalTableWitnessDescription(array $json): GlobalTableWitnessDescription
+    {
+        return new GlobalTableWitnessDescription([
+            'RegionName' => isset($json['RegionName']) ? (string) $json['RegionName'] : null,
+            'WitnessStatus' => isset($json['WitnessStatus']) ? (string) $json['WitnessStatus'] : null,
+        ]);
+    }
+
+    /**
+     * @return GlobalTableWitnessDescription[]
+     */
+    private function populateResultGlobalTableWitnessDescriptionList(array $json): array
+    {
+        $items = [];
+        foreach ($json as $item) {
+            $items[] = $this->populateResultGlobalTableWitnessDescription($item);
+        }
+
+        return $items;
+    }
+
     /**
      * @return KeySchemaElement[]
      */
@@ -341,6 +363,7 @@ private function populateResultTableDescription(array $json): TableDescription
             'LatestStreamArn' => isset($json['LatestStreamArn']) ? (string) $json['LatestStreamArn'] : null,
             'GlobalTableVersion' => isset($json['GlobalTableVersion']) ? (string) $json['GlobalTableVersion'] : null,
             'Replicas' => !isset($json['Replicas']) ? null : $this->populateResultReplicaDescriptionList($json['Replicas']),
+            'GlobalTableWitnesses' => !isset($json['GlobalTableWitnesses']) ? null : $this->populateResultGlobalTableWitnessDescriptionList($json['GlobalTableWitnesses']),
             'RestoreSummary' => empty($json['RestoreSummary']) ? null : $this->populateResultRestoreSummary($json['RestoreSummary']),
             'SSEDescription' => empty($json['SSEDescription']) ? null : $this->populateResultSSEDescription($json['SSEDescription']),
             'ArchivalSummary' => empty($json['ArchivalSummary']) ? null : $this->populateResultArchivalSummary($json['ArchivalSummary']),

src/Result/DeleteTableOutput.php

@@ -9,6 +9,7 @@
 use AsyncAws\DynamoDb\ValueObject\BillingModeSummary;
 use AsyncAws\DynamoDb\ValueObject\GlobalSecondaryIndexDescription;
 use AsyncAws\DynamoDb\ValueObject\GlobalSecondaryIndexWarmThroughputDescription;
+use AsyncAws\DynamoDb\ValueObject\GlobalTableWitnessDescription;
 use AsyncAws\DynamoDb\ValueObject\KeySchemaElement;
 use AsyncAws\DynamoDb\ValueObject\LocalSecondaryIndexDescription;
 use AsyncAws\DynamoDb\ValueObject\OnDemandThroughput;
@@ -128,6 +129,27 @@ private function populateResultGlobalSecondaryIndexWarmThroughputDescription(arr
         ]);
     }
 
+    private function populateResultGlobalTableWitnessDescription(array $json): GlobalTableWitnessDescription
+    {
+        return new GlobalTableWitnessDescription([
+            'RegionName' => isset($json['RegionName']) ? (string) $json['RegionName'] : null,
+            'WitnessStatus' => isset($json['WitnessStatus']) ? (string) $json['WitnessStatus'] : null,
+        ]);
+    }
+
+    /**
+     * @return GlobalTableWitnessDescription[]
+     */
+    private function populateResultGlobalTableWitnessDescriptionList(array $json): array
+    {
+        $items = [];
+        foreach ($json as $item) {
+            $items[] = $this->populateResultGlobalTableWitnessDescription($item);
+        }
+
+        return $items;
+    }
+
     /**
      * @return KeySchemaElement[]
      */
@@ -341,6 +363,7 @@ private function populateResultTableDescription(array $json): TableDescription
             'LatestStreamArn' => isset($json['LatestStreamArn']) ? (string) $json['LatestStreamArn'] : null,
             'GlobalTableVersion' => isset($json['GlobalTableVersion']) ? (string) $json['GlobalTableVersion'] : null,
             'Replicas' => !isset($json['Replicas']) ? null : $this->populateResultReplicaDescriptionList($json['Replicas']),
+            'GlobalTableWitnesses' => !isset($json['GlobalTableWitnesses']) ? null : $this->populateResultGlobalTableWitnessDescriptionList($json['GlobalTableWitnesses']),
             'RestoreSummary' => empty($json['RestoreSummary']) ? null : $this->populateResultRestoreSummary($json['RestoreSummary']),
             'SSEDescription' => empty($json['SSEDescription']) ? null : $this->populateResultSSEDescription($json['SSEDescription']),
             'ArchivalSummary' => empty($json['ArchivalSummary']) ? null : $this->populateResultArchivalSummary($json['ArchivalSummary']),