@aws-sdk/client-dynamodb 3.839.0 → 3.844.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist-cjs/endpoint/ruleset.js +1 -1
- package/dist-cjs/index.js +35 -22
- package/dist-es/endpoint/ruleset.js +1 -1
- package/dist-es/models/models_0.js +22 -12
- package/dist-es/protocols/Aws_json1_0.js +4 -3
- package/dist-types/commands/BatchWriteItemCommand.d.ts +4 -0
- package/dist-types/commands/CreateBackupCommand.d.ts +14 -11
- package/dist-types/commands/CreateGlobalTableCommand.d.ts +16 -13
- package/dist-types/commands/CreateTableCommand.d.ts +26 -16
- package/dist-types/commands/DeleteBackupCommand.d.ts +12 -10
- package/dist-types/commands/DeleteItemCommand.d.ts +2 -1
- package/dist-types/commands/DeleteResourcePolicyCommand.d.ts +18 -13
- package/dist-types/commands/DeleteTableCommand.d.ts +26 -20
- package/dist-types/commands/DescribeContinuousBackupsCommand.d.ts +2 -1
- package/dist-types/commands/DescribeExportCommand.d.ts +12 -10
- package/dist-types/commands/DescribeGlobalTableCommand.d.ts +2 -2
- package/dist-types/commands/DescribeGlobalTableSettingsCommand.d.ts +1 -1
- package/dist-types/commands/DescribeImportCommand.d.ts +1 -3
- package/dist-types/commands/DescribeTableCommand.d.ts +10 -8
- package/dist-types/commands/DescribeTableReplicaAutoScalingCommand.d.ts +2 -6
- package/dist-types/commands/DisableKinesisStreamingDestinationCommand.d.ts +16 -12
- package/dist-types/commands/EnableKinesisStreamingDestinationCommand.d.ts +16 -12
- package/dist-types/commands/ExecuteTransactionCommand.d.ts +28 -35
- package/dist-types/commands/ExportTableToPointInTimeCommand.d.ts +14 -11
- package/dist-types/commands/GetResourcePolicyCommand.d.ts +2 -1
- package/dist-types/commands/ImportTableCommand.d.ts +19 -17
- package/dist-types/commands/ListExportsCommand.d.ts +12 -10
- package/dist-types/commands/ListImportsCommand.d.ts +12 -10
- package/dist-types/commands/PutItemCommand.d.ts +2 -1
- package/dist-types/commands/PutResourcePolicyCommand.d.ts +18 -13
- package/dist-types/commands/RestoreTableFromBackupCommand.d.ts +22 -14
- package/dist-types/commands/RestoreTableToPointInTimeCommand.d.ts +24 -15
- package/dist-types/commands/TagResourceCommand.d.ts +16 -12
- package/dist-types/commands/TransactGetItemsCommand.d.ts +7 -8
- package/dist-types/commands/TransactWriteItemsCommand.d.ts +28 -35
- package/dist-types/commands/UntagResourceCommand.d.ts +16 -12
- package/dist-types/commands/UpdateContinuousBackupsCommand.d.ts +3 -2
- package/dist-types/commands/UpdateGlobalTableCommand.d.ts +6 -6
- package/dist-types/commands/UpdateGlobalTableSettingsCommand.d.ts +17 -13
- package/dist-types/commands/UpdateItemCommand.d.ts +2 -1
- package/dist-types/commands/UpdateKinesisStreamingDestinationCommand.d.ts +16 -12
- package/dist-types/commands/UpdateTableCommand.d.ts +36 -20
- package/dist-types/commands/UpdateTableReplicaAutoScalingCommand.d.ts +18 -18
- package/dist-types/commands/UpdateTimeToLiveCommand.d.ts +16 -12
- package/dist-types/models/models_0.d.ts +240 -112
- package/dist-types/ts3.4/models/models_0.d.ts +37 -10
- package/package.json +21 -21
|
@@ -613,13 +613,13 @@ export interface Projection {
|
|
|
613
613
|
ProjectionType?: ProjectionType | undefined;
|
|
614
614
|
/**
|
|
615
615
|
* <p>Represents the non-key attribute names which will be projected into the index.</p>
|
|
616
|
-
* <p>For global and local secondary indexes, the total count of
|
|
617
|
-
*
|
|
618
|
-
* attribute into two different indexes, this counts as
|
|
619
|
-
* determining the total. This limit only applies when you
|
|
620
|
-
* <code>INCLUDE</code>. You still can specify the
|
|
621
|
-
* project all attributes from the source table, even
|
|
622
|
-
* attributes.</p>
|
|
616
|
+
* <p>For global and local secondary indexes, the total count of
|
|
617
|
+
* <code>NonKeyAttributes</code> summed across all of the secondary indexes, must not
|
|
618
|
+
* exceed 100. If you project the same attribute into two different indexes, this counts as
|
|
619
|
+
* two distinct attributes when determining the total. This limit only applies when you
|
|
620
|
+
* specify the ProjectionType of <code>INCLUDE</code>. You still can specify the
|
|
621
|
+
* ProjectionType of <code>ALL</code> to project all attributes from the source table, even
|
|
622
|
+
* if the table has more than 100 attributes.</p>
|
|
623
623
|
* @public
|
|
624
624
|
*/
|
|
625
625
|
NonKeyAttributes?: string[] | undefined;
|
|
@@ -1266,6 +1266,20 @@ export declare class ItemCollectionSizeLimitExceededException extends __BaseExce
|
|
|
1266
1266
|
*/
|
|
1267
1267
|
constructor(opts: __ExceptionOptionType<ItemCollectionSizeLimitExceededException, __BaseException>);
|
|
1268
1268
|
}
|
|
1269
|
+
/**
|
|
1270
|
+
* <p>The request was rejected because one or more items in the request are being modified
|
|
1271
|
+
* by a request in another Region. </p>
|
|
1272
|
+
* @public
|
|
1273
|
+
*/
|
|
1274
|
+
export declare class ReplicatedWriteConflictException extends __BaseException {
|
|
1275
|
+
readonly name: "ReplicatedWriteConflictException";
|
|
1276
|
+
readonly $fault: "client";
|
|
1277
|
+
$retryable: {};
|
|
1278
|
+
/**
|
|
1279
|
+
* @internal
|
|
1280
|
+
*/
|
|
1281
|
+
constructor(opts: __ExceptionOptionType<ReplicatedWriteConflictException, __BaseException>);
|
|
1282
|
+
}
|
|
1269
1283
|
/**
|
|
1270
1284
|
* <p>Contains the details for the read/write capacity mode. This page talks about
|
|
1271
1285
|
* <code>PROVISIONED</code> and <code>PAY_PER_REQUEST</code> billing modes. For more
|
|
@@ -1512,19 +1526,21 @@ export interface CreateBackupOutput {
|
|
|
1512
1526
|
}
|
|
1513
1527
|
/**
|
|
1514
1528
|
* <p>There is no limit to the number of daily on-demand backups that can be taken. </p>
|
|
1515
|
-
* <p>For most purposes, up to 500 simultaneous table operations are allowed per account.
|
|
1516
|
-
* include <code>CreateTable</code>, <code>UpdateTable</code>,
|
|
1529
|
+
* <p>For most purposes, up to 500 simultaneous table operations are allowed per account.
|
|
1530
|
+
* These operations include <code>CreateTable</code>, <code>UpdateTable</code>,
|
|
1517
1531
|
* <code>DeleteTable</code>,<code>UpdateTimeToLive</code>,
|
|
1518
1532
|
* <code>RestoreTableFromBackup</code>, and <code>RestoreTableToPointInTime</code>. </p>
|
|
1519
|
-
* <p>When you are creating a table with one or more secondary
|
|
1520
|
-
*
|
|
1521
|
-
*
|
|
1522
|
-
*
|
|
1523
|
-
* <p>When importing into DynamoDB, up to 50 simultaneous import table operations are
|
|
1533
|
+
* <p>When you are creating a table with one or more secondary indexes, you can have up
|
|
1534
|
+
* to 250 such requests running at a time. However, if the table or index specifications
|
|
1535
|
+
* are complex, then DynamoDB might temporarily reduce the number of concurrent
|
|
1536
|
+
* operations.</p>
|
|
1537
|
+
* <p>When importing into DynamoDB, up to 50 simultaneous import table operations are
|
|
1538
|
+
* allowed per account.</p>
|
|
1524
1539
|
* <p>There is a soft account quota of 2,500 tables.</p>
|
|
1525
|
-
* <p>GetRecords was called with a value of more than 1000 for the limit request
|
|
1526
|
-
*
|
|
1527
|
-
*
|
|
1540
|
+
* <p>GetRecords was called with a value of more than 1000 for the limit request
|
|
1541
|
+
* parameter.</p>
|
|
1542
|
+
* <p>More than 2 processes are reading from the same streams shard at the same time.
|
|
1543
|
+
* Exceeding this limit may result in request throttling.</p>
|
|
1528
1544
|
* @public
|
|
1529
1545
|
*/
|
|
1530
1546
|
export declare class LimitExceededException extends __BaseException {
|
|
@@ -1550,7 +1566,8 @@ export declare class TableInUseException extends __BaseException {
|
|
|
1550
1566
|
}
|
|
1551
1567
|
/**
|
|
1552
1568
|
* <p>A source table with the name <code>TableName</code> does not currently exist within
|
|
1553
|
-
* the subscriber's account or the subscriber is operating in the wrong Amazon Web Services
|
|
1569
|
+
* the subscriber's account or the subscriber is operating in the wrong Amazon Web Services
|
|
1570
|
+
* Region.</p>
|
|
1554
1571
|
* @public
|
|
1555
1572
|
*/
|
|
1556
1573
|
export declare class TableNotFoundException extends __BaseException {
|
|
@@ -1616,9 +1633,9 @@ export interface CreateGlobalSecondaryIndexAction {
|
|
|
1616
1633
|
/**
|
|
1617
1634
|
* <p>The maximum number of read and write units for the global secondary index being
|
|
1618
1635
|
* created. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>,
|
|
1619
|
-
* <code>MaxWriteRequestUnits</code>, or both. You must use either
|
|
1620
|
-
*
|
|
1621
|
-
*
|
|
1636
|
+
* <code>MaxWriteRequestUnits</code>, or both. You must use either <code>OnDemand
|
|
1637
|
+
* Throughput</code> or <code>ProvisionedThroughput</code> based on your table's
|
|
1638
|
+
* capacity mode.</p>
|
|
1622
1639
|
* @public
|
|
1623
1640
|
*/
|
|
1624
1641
|
OnDemandThroughput?: OnDemandThroughput | undefined;
|
|
@@ -1766,11 +1783,14 @@ export interface ReplicaGlobalSecondaryIndexDescription {
|
|
|
1766
1783
|
*/
|
|
1767
1784
|
export declare const ReplicaStatus: {
|
|
1768
1785
|
readonly ACTIVE: "ACTIVE";
|
|
1786
|
+
readonly ARCHIVED: "ARCHIVED";
|
|
1787
|
+
readonly ARCHIVING: "ARCHIVING";
|
|
1769
1788
|
readonly CREATING: "CREATING";
|
|
1770
1789
|
readonly CREATION_FAILED: "CREATION_FAILED";
|
|
1771
1790
|
readonly DELETING: "DELETING";
|
|
1772
1791
|
readonly INACCESSIBLE_ENCRYPTION_CREDENTIALS: "INACCESSIBLE_ENCRYPTION_CREDENTIALS";
|
|
1773
1792
|
readonly REGION_DISABLED: "REGION_DISABLED";
|
|
1793
|
+
readonly REPLICATION_NOT_AUTHORIZED: "REPLICATION_NOT_AUTHORIZED";
|
|
1774
1794
|
readonly UPDATING: "UPDATING";
|
|
1775
1795
|
};
|
|
1776
1796
|
/**
|
|
@@ -1817,6 +1837,7 @@ export declare const TableStatus: {
|
|
|
1817
1837
|
readonly CREATING: "CREATING";
|
|
1818
1838
|
readonly DELETING: "DELETING";
|
|
1819
1839
|
readonly INACCESSIBLE_ENCRYPTION_CREDENTIALS: "INACCESSIBLE_ENCRYPTION_CREDENTIALS";
|
|
1840
|
+
readonly REPLICATION_NOT_AUTHORIZED: "REPLICATION_NOT_AUTHORIZED";
|
|
1820
1841
|
readonly UPDATING: "UPDATING";
|
|
1821
1842
|
};
|
|
1822
1843
|
/**
|
|
@@ -1824,9 +1845,9 @@ export declare const TableStatus: {
|
|
|
1824
1845
|
*/
|
|
1825
1846
|
export type TableStatus = (typeof TableStatus)[keyof typeof TableStatus];
|
|
1826
1847
|
/**
|
|
1827
|
-
* <p>Represents the warm throughput value (in read units per second and write units per
|
|
1828
|
-
* of the table. Warm throughput is applicable for DynamoDB Standard-IA tables and
|
|
1829
|
-
* the minimum provisioned capacity maintained for immediate data access.</p>
|
|
1848
|
+
* <p>Represents the warm throughput value (in read units per second and write units per
|
|
1849
|
+
* second) of the table. Warm throughput is applicable for DynamoDB Standard-IA tables and
|
|
1850
|
+
* specifies the minimum provisioned capacity maintained for immediate data access.</p>
|
|
1830
1851
|
* @public
|
|
1831
1852
|
*/
|
|
1832
1853
|
export interface TableWarmThroughputDescription {
|
|
@@ -2022,6 +2043,34 @@ export declare class GlobalTableAlreadyExistsException extends __BaseException {
|
|
|
2022
2043
|
*/
|
|
2023
2044
|
constructor(opts: __ExceptionOptionType<GlobalTableAlreadyExistsException, __BaseException>);
|
|
2024
2045
|
}
|
|
2046
|
+
/**
|
|
2047
|
+
* <p>Specifies the action to add a new witness Region to a MRSC global table. A MRSC global
|
|
2048
|
+
* table can be configured with either three replicas, or with two replicas and one
|
|
2049
|
+
* witness.</p>
|
|
2050
|
+
* @public
|
|
2051
|
+
*/
|
|
2052
|
+
export interface CreateGlobalTableWitnessGroupMemberAction {
|
|
2053
|
+
/**
|
|
2054
|
+
* <p>The Amazon Web Services Region name to be added as a witness Region for the MRSC global
|
|
2055
|
+
* table. The witness must be in a different Region than the replicas and within the same
|
|
2056
|
+
* Region set:</p>
|
|
2057
|
+
* <ul>
|
|
2058
|
+
* <li>
|
|
2059
|
+
* <p>US Region set: US East (N. Virginia), US East (Ohio), US West (Oregon)</p>
|
|
2060
|
+
* </li>
|
|
2061
|
+
* <li>
|
|
2062
|
+
* <p>EU Region set: Europe (Ireland), Europe (London), Europe (Paris), Europe
|
|
2063
|
+
* (Frankfurt)</p>
|
|
2064
|
+
* </li>
|
|
2065
|
+
* <li>
|
|
2066
|
+
* <p>AP Region set: Asia Pacific (Tokyo), Asia Pacific (Seoul), Asia Pacific
|
|
2067
|
+
* (Osaka)</p>
|
|
2068
|
+
* </li>
|
|
2069
|
+
* </ul>
|
|
2070
|
+
* @public
|
|
2071
|
+
*/
|
|
2072
|
+
RegionName: string | undefined;
|
|
2073
|
+
}
|
|
2025
2074
|
/**
|
|
2026
2075
|
* <p>Represents a replica to be added.</p>
|
|
2027
2076
|
* @public
|
|
@@ -2146,9 +2195,8 @@ export interface GlobalSecondaryIndex {
|
|
|
2146
2195
|
Projection: Projection | undefined;
|
|
2147
2196
|
/**
|
|
2148
2197
|
* <p>Represents the provisioned throughput settings for the specified global secondary
|
|
2149
|
-
* index. You must use either
|
|
2150
|
-
*
|
|
2151
|
-
* on your table's capacity mode.</p>
|
|
2198
|
+
* index. You must use either <code>OnDemandThroughput</code> or
|
|
2199
|
+
* <code>ProvisionedThroughput</code> based on your table's capacity mode.</p>
|
|
2152
2200
|
* <p>For current minimum and maximum provisioned throughput values, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html">Service,
|
|
2153
2201
|
* Account, and Table Quotas</a> in the <i>Amazon DynamoDB Developer
|
|
2154
2202
|
* Guide</i>.</p>
|
|
@@ -2159,8 +2207,8 @@ export interface GlobalSecondaryIndex {
|
|
|
2159
2207
|
* <p>The maximum number of read and write units for the specified global secondary index.
|
|
2160
2208
|
* If you use this parameter, you must specify <code>MaxReadRequestUnits</code>,
|
|
2161
2209
|
* <code>MaxWriteRequestUnits</code>, or both. You must use either
|
|
2162
|
-
*
|
|
2163
|
-
*
|
|
2210
|
+
* <code>OnDemandThroughput</code> or <code>ProvisionedThroughput</code> based on your
|
|
2211
|
+
* table's capacity mode.</p>
|
|
2164
2212
|
* @public
|
|
2165
2213
|
*/
|
|
2166
2214
|
OnDemandThroughput?: OnDemandThroughput | undefined;
|
|
@@ -2396,9 +2444,10 @@ export interface CreateTableInput {
|
|
|
2396
2444
|
* of the secondary indexes, must not exceed 100. If you project the same
|
|
2397
2445
|
* attribute into two different indexes, this counts as two distinct
|
|
2398
2446
|
* attributes when determining the total. This limit only applies when you
|
|
2399
|
-
* specify the ProjectionType of <code>INCLUDE</code>. You still can
|
|
2400
|
-
* ProjectionType of <code>ALL</code> to project all attributes
|
|
2401
|
-
* source table, even if the table has more than 100
|
|
2447
|
+
* specify the ProjectionType of <code>INCLUDE</code>. You still can
|
|
2448
|
+
* specify the ProjectionType of <code>ALL</code> to project all attributes
|
|
2449
|
+
* from the source table, even if the table has more than 100
|
|
2450
|
+
* attributes.</p>
|
|
2402
2451
|
* </li>
|
|
2403
2452
|
* </ul>
|
|
2404
2453
|
* </li>
|
|
@@ -2460,7 +2509,8 @@ export interface CreateTableInput {
|
|
|
2460
2509
|
* attributes when determining the total. This limit only applies when you
|
|
2461
2510
|
* specify the ProjectionType of <code>INCLUDE</code>. You still can
|
|
2462
2511
|
* specify the ProjectionType of <code>ALL</code> to project all attributes
|
|
2463
|
-
* from the source table, even if the table has more than 100
|
|
2512
|
+
* from the source table, even if the table has more than 100
|
|
2513
|
+
* attributes.</p>
|
|
2464
2514
|
* </li>
|
|
2465
2515
|
* </ul>
|
|
2466
2516
|
* </li>
|
|
@@ -2765,6 +2815,36 @@ export interface GlobalSecondaryIndexDescription {
|
|
|
2765
2815
|
*/
|
|
2766
2816
|
WarmThroughput?: GlobalSecondaryIndexWarmThroughputDescription | undefined;
|
|
2767
2817
|
}
|
|
2818
|
+
/**
|
|
2819
|
+
* @public
|
|
2820
|
+
* @enum
|
|
2821
|
+
*/
|
|
2822
|
+
export declare const WitnessStatus: {
|
|
2823
|
+
readonly ACTIVE: "ACTIVE";
|
|
2824
|
+
readonly CREATING: "CREATING";
|
|
2825
|
+
readonly DELETING: "DELETING";
|
|
2826
|
+
};
|
|
2827
|
+
/**
|
|
2828
|
+
* @public
|
|
2829
|
+
*/
|
|
2830
|
+
export type WitnessStatus = (typeof WitnessStatus)[keyof typeof WitnessStatus];
|
|
2831
|
+
/**
|
|
2832
|
+
* <p>Represents the properties of a witness Region in a MRSC global table. </p>
|
|
2833
|
+
* @public
|
|
2834
|
+
*/
|
|
2835
|
+
export interface GlobalTableWitnessDescription {
|
|
2836
|
+
/**
|
|
2837
|
+
* <p>The name of the Amazon Web Services Region that serves as a witness for the MRSC global
|
|
2838
|
+
* table.</p>
|
|
2839
|
+
* @public
|
|
2840
|
+
*/
|
|
2841
|
+
RegionName?: string | undefined;
|
|
2842
|
+
/**
|
|
2843
|
+
* <p>The current status of the witness Region in the MRSC global table.</p>
|
|
2844
|
+
* @public
|
|
2845
|
+
*/
|
|
2846
|
+
WitnessStatus?: WitnessStatus | undefined;
|
|
2847
|
+
}
|
|
2768
2848
|
/**
|
|
2769
2849
|
* <p>Represents the properties of a local secondary index.</p>
|
|
2770
2850
|
* @public
|
|
@@ -3068,7 +3148,8 @@ export interface TableDescription {
|
|
|
3068
3148
|
* attributes when determining the total. This limit only applies when you
|
|
3069
3149
|
* specify the ProjectionType of <code>INCLUDE</code>. You still can
|
|
3070
3150
|
* specify the ProjectionType of <code>ALL</code> to project all attributes
|
|
3071
|
-
* from the source table, even if the table has more than 100
|
|
3151
|
+
* from the source table, even if the table has more than 100
|
|
3152
|
+
* attributes.</p>
|
|
3072
3153
|
* </li>
|
|
3073
3154
|
* </ul>
|
|
3074
3155
|
* </li>
|
|
@@ -3192,7 +3273,8 @@ export interface TableDescription {
|
|
|
3192
3273
|
* attributes when determining the total. This limit only applies when you
|
|
3193
3274
|
* specify the ProjectionType of <code>INCLUDE</code>. You still can
|
|
3194
3275
|
* specify the ProjectionType of <code>ALL</code> to project all attributes
|
|
3195
|
-
* from the source table, even if the table has more than 100
|
|
3276
|
+
* from the source table, even if the table has more than 100
|
|
3277
|
+
* attributes.</p>
|
|
3196
3278
|
* </li>
|
|
3197
3279
|
* </ul>
|
|
3198
3280
|
* </li>
|
|
@@ -3252,6 +3334,12 @@ export interface TableDescription {
|
|
|
3252
3334
|
* @public
|
|
3253
3335
|
*/
|
|
3254
3336
|
Replicas?: ReplicaDescription[] | undefined;
|
|
3337
|
+
/**
|
|
3338
|
+
* <p>The witness Region and its current status in the MRSC global table. Only one witness
|
|
3339
|
+
* Region can be configured per MRSC global table.</p>
|
|
3340
|
+
* @public
|
|
3341
|
+
*/
|
|
3342
|
+
GlobalTableWitnesses?: GlobalTableWitnessDescription[] | undefined;
|
|
3255
3343
|
/**
|
|
3256
3344
|
* <p>Contains details for the restore.</p>
|
|
3257
3345
|
* @public
|
|
@@ -3295,17 +3383,19 @@ export interface TableDescription {
|
|
|
3295
3383
|
* <ul>
|
|
3296
3384
|
* <li>
|
|
3297
3385
|
* <p>
|
|
3298
|
-
* <code>EVENTUAL</code>: Indicates that the global table is configured for
|
|
3386
|
+
* <code>EVENTUAL</code>: Indicates that the global table is configured for
|
|
3387
|
+
* multi-Region eventual consistency (MREC).</p>
|
|
3299
3388
|
* </li>
|
|
3300
3389
|
* <li>
|
|
3301
3390
|
* <p>
|
|
3302
|
-
* <code>STRONG</code>: Indicates that the global table is configured for
|
|
3303
|
-
*
|
|
3304
|
-
* <p>Multi-Region strong consistency (MRSC) is a new DynamoDB global tables capability currently available in preview mode. For more information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PreviewFeatures.html#multi-region-strong-consistency-gt">Global tables multi-Region strong consistency</a>.</p>
|
|
3305
|
-
* </note>
|
|
3391
|
+
* <code>STRONG</code>: Indicates that the global table is configured for
|
|
3392
|
+
* multi-Region strong consistency (MRSC).</p>
|
|
3306
3393
|
* </li>
|
|
3307
3394
|
* </ul>
|
|
3308
|
-
* <p>If you don't specify this field, the global table consistency mode defaults to
|
|
3395
|
+
* <p>If you don't specify this field, the global table consistency mode defaults to
|
|
3396
|
+
* <code>EVENTUAL</code>. For more information about global tables consistency modes,
|
|
3397
|
+
* see <a href="https://docs.aws.amazon.com/V2globaltables_HowItWorks.html#V2globaltables_HowItWorks.consistency-modes">
|
|
3398
|
+
* Consistency modes</a> in DynamoDB developer guide. </p>
|
|
3309
3399
|
* @public
|
|
3310
3400
|
*/
|
|
3311
3401
|
MultiRegionConsistency?: MultiRegionConsistency | undefined;
|
|
@@ -3328,13 +3418,15 @@ export interface CreateTableOutput {
|
|
|
3328
3418
|
* <p>You attempted to recreate an existing table.</p>
|
|
3329
3419
|
* </li>
|
|
3330
3420
|
* <li>
|
|
3331
|
-
* <p>You tried to delete a table currently in the <code>CREATING</code>
|
|
3421
|
+
* <p>You tried to delete a table currently in the <code>CREATING</code>
|
|
3422
|
+
* state.</p>
|
|
3332
3423
|
* </li>
|
|
3333
3424
|
* <li>
|
|
3334
3425
|
* <p>You tried to update a resource that was already being updated.</p>
|
|
3335
3426
|
* </li>
|
|
3336
3427
|
* </ul>
|
|
3337
|
-
* <p>When appropriate, wait for the ongoing update to complete and attempt the request
|
|
3428
|
+
* <p>When appropriate, wait for the ongoing update to complete and attempt the request
|
|
3429
|
+
* again.</p>
|
|
3338
3430
|
* @public
|
|
3339
3431
|
*/
|
|
3340
3432
|
export declare class ResourceInUseException extends __BaseException {
|
|
@@ -3395,6 +3487,20 @@ export interface DeleteGlobalSecondaryIndexAction {
|
|
|
3395
3487
|
*/
|
|
3396
3488
|
IndexName: string | undefined;
|
|
3397
3489
|
}
|
|
3490
|
+
/**
|
|
3491
|
+
* <p>Specifies the action to remove a witness Region from a MRSC global table. You cannot
|
|
3492
|
+
* delete a single witness from a MRSC global table - you must delete both a replica and
|
|
3493
|
+
* the witness together. The deletion of both a witness and replica converts the remaining
|
|
3494
|
+
* replica to a single-Region DynamoDB table. </p>
|
|
3495
|
+
* @public
|
|
3496
|
+
*/
|
|
3497
|
+
export interface DeleteGlobalTableWitnessGroupMemberAction {
|
|
3498
|
+
/**
|
|
3499
|
+
* <p>The witness Region name to be removed from the MRSC global table.</p>
|
|
3500
|
+
* @public
|
|
3501
|
+
*/
|
|
3502
|
+
RegionName: string | undefined;
|
|
3503
|
+
}
|
|
3398
3504
|
/**
|
|
3399
3505
|
* @public
|
|
3400
3506
|
* @enum
|
|
@@ -3410,18 +3516,6 @@ export declare const ReturnValue: {
|
|
|
3410
3516
|
* @public
|
|
3411
3517
|
*/
|
|
3412
3518
|
export type ReturnValue = (typeof ReturnValue)[keyof typeof ReturnValue];
|
|
3413
|
-
/**
|
|
3414
|
-
* <p>The request was rejected because one or more items in the request are being modified by a request in another Region. </p>
|
|
3415
|
-
* @public
|
|
3416
|
-
*/
|
|
3417
|
-
export declare class ReplicatedWriteConflictException extends __BaseException {
|
|
3418
|
-
readonly name: "ReplicatedWriteConflictException";
|
|
3419
|
-
readonly $fault: "client";
|
|
3420
|
-
/**
|
|
3421
|
-
* @internal
|
|
3422
|
-
*/
|
|
3423
|
-
constructor(opts: __ExceptionOptionType<ReplicatedWriteConflictException, __BaseException>);
|
|
3424
|
-
}
|
|
3425
3519
|
/**
|
|
3426
3520
|
* <p>Operation was rejected because there is an ongoing transaction for the
|
|
3427
3521
|
* item.</p>
|
|
@@ -3493,7 +3587,8 @@ export interface DeleteResourcePolicyOutput {
|
|
|
3493
3587
|
}
|
|
3494
3588
|
/**
|
|
3495
3589
|
* <p>The operation tried to access a nonexistent resource-based policy.</p>
|
|
3496
|
-
* <p>If you specified an <code>ExpectedRevisionId</code>, it's possible that a policy is
|
|
3590
|
+
* <p>If you specified an <code>ExpectedRevisionId</code>, it's possible that a policy is
|
|
3591
|
+
* present for the resource but its revision ID didn't match the expected value.</p>
|
|
3497
3592
|
* @public
|
|
3498
3593
|
*/
|
|
3499
3594
|
export declare class PolicyNotFoundException extends __BaseException {
|
|
@@ -4400,9 +4495,7 @@ export interface DescribeImportOutput {
|
|
|
4400
4495
|
ImportTableDescription: ImportTableDescription | undefined;
|
|
4401
4496
|
}
|
|
4402
4497
|
/**
|
|
4403
|
-
* <p>
|
|
4404
|
-
* The specified import was not found.
|
|
4405
|
-
* </p>
|
|
4498
|
+
* <p> The specified import was not found. </p>
|
|
4406
4499
|
* @public
|
|
4407
4500
|
*/
|
|
4408
4501
|
export declare class ImportNotFoundException extends __BaseException {
|
|
@@ -4812,51 +4905,44 @@ export declare class IdempotentParameterMismatchException extends __BaseExceptio
|
|
|
4812
4905
|
}
|
|
4813
4906
|
/**
|
|
4814
4907
|
* <p>The transaction with the given request token is already in progress.</p>
|
|
4815
|
-
* <p>
|
|
4816
|
-
* Recommended Settings
|
|
4817
|
-
* </p>
|
|
4908
|
+
* <p> Recommended Settings </p>
|
|
4818
4909
|
* <note>
|
|
4819
|
-
* <p>
|
|
4820
|
-
*
|
|
4821
|
-
*
|
|
4822
|
-
*
|
|
4910
|
+
* <p> This is a general recommendation for handling the
|
|
4911
|
+
* <code>TransactionInProgressException</code>. These settings help ensure that the
|
|
4912
|
+
* client retries will trigger completion of the ongoing
|
|
4913
|
+
* <code>TransactWriteItems</code> request. </p>
|
|
4823
4914
|
* </note>
|
|
4824
4915
|
* <ul>
|
|
4825
4916
|
* <li>
|
|
4826
|
-
* <p>
|
|
4827
|
-
*
|
|
4828
|
-
*
|
|
4829
|
-
* </p>
|
|
4917
|
+
* <p> Set <code>clientExecutionTimeout</code> to a value that allows at least one
|
|
4918
|
+
* retry to be processed after 5 seconds have elapsed since the first attempt for
|
|
4919
|
+
* the <code>TransactWriteItems</code> operation. </p>
|
|
4830
4920
|
* </li>
|
|
4831
4921
|
* <li>
|
|
4832
|
-
* <p>
|
|
4833
|
-
*
|
|
4834
|
-
* </p>
|
|
4922
|
+
* <p> Set <code>socketTimeout</code> to a value a little lower than the
|
|
4923
|
+
* <code>requestTimeout</code> setting. </p>
|
|
4835
4924
|
* </li>
|
|
4836
4925
|
* <li>
|
|
4837
4926
|
* <p>
|
|
4838
|
-
* <code>requestTimeout</code> should be set based on the time taken for the
|
|
4839
|
-
* HTTP request for your use case, but setting it to
|
|
4840
|
-
* retries and
|
|
4841
|
-
*
|
|
4927
|
+
* <code>requestTimeout</code> should be set based on the time taken for the
|
|
4928
|
+
* individual retries of a single HTTP request for your use case, but setting it to
|
|
4929
|
+
* 1 second or higher should work well to reduce chances of retries and
|
|
4930
|
+
* <code>TransactionInProgressException</code> errors. </p>
|
|
4842
4931
|
* </li>
|
|
4843
4932
|
* <li>
|
|
4844
|
-
* <p>
|
|
4845
|
-
* Use exponential backoff when retrying and tune backoff if needed.
|
|
4846
|
-
* </p>
|
|
4933
|
+
* <p> Use exponential backoff when retrying and tune backoff if needed. </p>
|
|
4847
4934
|
* </li>
|
|
4848
4935
|
* </ul>
|
|
4849
|
-
* <p>
|
|
4850
|
-
*
|
|
4851
|
-
* example timeout settings based on the guidelines above are as follows:
|
|
4852
|
-
* </p>
|
|
4936
|
+
* <p> Assuming <a href="https://github.com/aws/aws-sdk-java/blob/fd409dee8ae23fb8953e0bb4dbde65536a7e0514/aws-java-sdk-core/src/main/java/com/amazonaws/retry/PredefinedRetryPolicies.java#L97">default retry policy</a>, example timeout settings based on the guidelines
|
|
4937
|
+
* above are as follows: </p>
|
|
4853
4938
|
* <p>Example timeline:</p>
|
|
4854
4939
|
* <ul>
|
|
4855
4940
|
* <li>
|
|
4856
4941
|
* <p>0-1000 first attempt</p>
|
|
4857
4942
|
* </li>
|
|
4858
4943
|
* <li>
|
|
4859
|
-
* <p>1000-1500 first sleep/delay (default retry policy uses 500 ms as base delay
|
|
4944
|
+
* <p>1000-1500 first sleep/delay (default retry policy uses 500 ms as base delay
|
|
4945
|
+
* for 4xx errors)</p>
|
|
4860
4946
|
* </li>
|
|
4861
4947
|
* <li>
|
|
4862
4948
|
* <p>1500-2500 second attempt</p>
|
|
@@ -4871,7 +4957,8 @@ export declare class IdempotentParameterMismatchException extends __BaseExceptio
|
|
|
4871
4957
|
* <p>4500-6500 third sleep/delay (500 * 2^2)</p>
|
|
4872
4958
|
* </li>
|
|
4873
4959
|
* <li>
|
|
4874
|
-
* <p>6500-7500 fourth attempt (this can trigger inline recovery since 5 seconds
|
|
4960
|
+
* <p>6500-7500 fourth attempt (this can trigger inline recovery since 5 seconds
|
|
4961
|
+
* have elapsed since the first attempt reached TC)</p>
|
|
4875
4962
|
* </li>
|
|
4876
4963
|
* </ul>
|
|
4877
4964
|
* @public
|
|
@@ -5055,11 +5142,9 @@ export interface GetResourcePolicyOutput {
|
|
|
5055
5142
|
RevisionId?: string | undefined;
|
|
5056
5143
|
}
|
|
5057
5144
|
/**
|
|
5058
|
-
* <p>
|
|
5059
|
-
*
|
|
5060
|
-
*
|
|
5061
|
-
* that had the same client token.
|
|
5062
|
-
* </p>
|
|
5145
|
+
* <p> There was a conflict when importing from the specified S3 source. This can occur when
|
|
5146
|
+
* the current import conflicts with a previous import request that had the same client
|
|
5147
|
+
* token. </p>
|
|
5063
5148
|
* @public
|
|
5064
5149
|
*/
|
|
5065
5150
|
export declare class ImportConflictException extends __BaseException {
|
|
@@ -6292,6 +6377,34 @@ export interface GlobalSecondaryIndexUpdate {
|
|
|
6292
6377
|
*/
|
|
6293
6378
|
Delete?: DeleteGlobalSecondaryIndexAction | undefined;
|
|
6294
6379
|
}
|
|
6380
|
+
/**
|
|
6381
|
+
* <p>Represents one of the following:</p>
|
|
6382
|
+
* <ul>
|
|
6383
|
+
* <li>
|
|
6384
|
+
* <p>A new witness to be added to a new global table.</p>
|
|
6385
|
+
* </li>
|
|
6386
|
+
* <li>
|
|
6387
|
+
* <p>An existing witness to be removed from an existing global table.</p>
|
|
6388
|
+
* </li>
|
|
6389
|
+
* </ul>
|
|
6390
|
+
* <p>You can configure one witness per MRSC global table.</p>
|
|
6391
|
+
* @public
|
|
6392
|
+
*/
|
|
6393
|
+
export interface GlobalTableWitnessGroupUpdate {
|
|
6394
|
+
/**
|
|
6395
|
+
* <p>Specifies a witness Region to be added to a new MRSC global table. The witness must be
|
|
6396
|
+
* added when creating the MRSC global table.</p>
|
|
6397
|
+
* @public
|
|
6398
|
+
*/
|
|
6399
|
+
Create?: CreateGlobalTableWitnessGroupMemberAction | undefined;
|
|
6400
|
+
/**
|
|
6401
|
+
* <p>Specifies a witness Region to be removed from an existing global table. Must be done
|
|
6402
|
+
* in conjunction with removing a replica. The deletion of both a witness and replica
|
|
6403
|
+
* converts the remaining replica to a single-Region DynamoDB table.</p>
|
|
6404
|
+
* @public
|
|
6405
|
+
*/
|
|
6406
|
+
Delete?: DeleteGlobalTableWitnessGroupMemberAction | undefined;
|
|
6407
|
+
}
|
|
6295
6408
|
/**
|
|
6296
6409
|
* <p>Represents a replica to be modified.</p>
|
|
6297
6410
|
* @public
|
|
@@ -6464,10 +6577,6 @@ export interface UpdateTableInput {
|
|
|
6464
6577
|
SSESpecification?: SSESpecification | undefined;
|
|
6465
6578
|
/**
|
|
6466
6579
|
* <p>A list of replica update actions (create, delete, or update) for the table.</p>
|
|
6467
|
-
* <note>
|
|
6468
|
-
* <p>For global tables, this property only applies to global tables using Version
|
|
6469
|
-
* 2019.11.21 (Current version). </p>
|
|
6470
|
-
* </note>
|
|
6471
6580
|
* @public
|
|
6472
6581
|
*/
|
|
6473
6582
|
ReplicaUpdates?: ReplicationGroupUpdate[] | undefined;
|
|
@@ -6491,24 +6600,44 @@ export interface UpdateTableInput {
|
|
|
6491
6600
|
* <li>
|
|
6492
6601
|
* <p>
|
|
6493
6602
|
* <code>EVENTUAL</code>: Configures a new global table for multi-Region eventual
|
|
6494
|
-
* consistency. This is the default consistency mode for global
|
|
6603
|
+
* consistency (MREC). This is the default consistency mode for global
|
|
6604
|
+
* tables.</p>
|
|
6495
6605
|
* </li>
|
|
6496
6606
|
* <li>
|
|
6497
6607
|
* <p>
|
|
6498
6608
|
* <code>STRONG</code>: Configures a new global table for multi-Region strong
|
|
6499
|
-
* consistency (
|
|
6500
|
-
* <note>
|
|
6501
|
-
* <p>Multi-Region strong consistency (MRSC) is a new DynamoDB global
|
|
6502
|
-
* tables capability currently available in preview mode. For more information,
|
|
6503
|
-
* see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PreviewFeatures.html#multi-region-strong-consistency-gt">Global tables multi-Region strong consistency</a>.</p>
|
|
6504
|
-
* </note>
|
|
6609
|
+
* consistency (MRSC).</p>
|
|
6505
6610
|
* </li>
|
|
6506
6611
|
* </ul>
|
|
6507
|
-
* <p>If you don't specify this
|
|
6508
|
-
* <code>EVENTUAL</code
|
|
6612
|
+
* <p>If you don't specify this field, the global table consistency mode defaults to
|
|
6613
|
+
* <code>EVENTUAL</code>. For more information about global tables consistency modes,
|
|
6614
|
+
* see <a href="https://docs.aws.amazon.com/V2globaltables_HowItWorks.html#V2globaltables_HowItWorks.consistency-modes">
|
|
6615
|
+
* Consistency modes</a> in DynamoDB developer guide. </p>
|
|
6509
6616
|
* @public
|
|
6510
6617
|
*/
|
|
6511
6618
|
MultiRegionConsistency?: MultiRegionConsistency | undefined;
|
|
6619
|
+
/**
|
|
6620
|
+
* <p>A list of witness updates for a MRSC global table. A witness provides a cost-effective
|
|
6621
|
+
* alternative to a full replica in a MRSC global table by maintaining replicated change
|
|
6622
|
+
* data written to global table replicas. You cannot perform read or write operations on a
|
|
6623
|
+
* witness. For each witness, you can request one action:</p>
|
|
6624
|
+
* <ul>
|
|
6625
|
+
* <li>
|
|
6626
|
+
* <p>
|
|
6627
|
+
* <code>Create</code> - add a new witness to the global table.</p>
|
|
6628
|
+
* </li>
|
|
6629
|
+
* <li>
|
|
6630
|
+
* <p>
|
|
6631
|
+
* <code>Delete</code> - remove a witness from the global table.</p>
|
|
6632
|
+
* </li>
|
|
6633
|
+
* </ul>
|
|
6634
|
+
* <p>You can create or delete only one witness per <code>UpdateTable</code>
|
|
6635
|
+
* operation.</p>
|
|
6636
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html#V2globaltables_HowItWorks.consistency-modes">Multi-Region strong consistency (MRSC)</a> in the Amazon DynamoDB
|
|
6637
|
+
* Developer Guide</p>
|
|
6638
|
+
* @public
|
|
6639
|
+
*/
|
|
6640
|
+
GlobalTableWitnessUpdates?: GlobalTableWitnessGroupUpdate[] | undefined;
|
|
6512
6641
|
/**
|
|
6513
6642
|
* <p>Updates the maximum number of read and write units for the specified table in
|
|
6514
6643
|
* on-demand capacity mode. If you use this parameter, you must specify
|
|
@@ -7965,11 +8094,10 @@ export interface TransactGetItemsOutput {
|
|
|
7965
8094
|
* <p>There is a user error, such as an invalid data format.</p>
|
|
7966
8095
|
* </li>
|
|
7967
8096
|
* <li>
|
|
7968
|
-
* <p>
|
|
7969
|
-
*
|
|
7970
|
-
*
|
|
7971
|
-
*
|
|
7972
|
-
* </p>
|
|
8097
|
+
* <p> There is an ongoing <code>TransactWriteItems</code> operation that
|
|
8098
|
+
* conflicts with a concurrent <code>TransactWriteItems</code> request. In this
|
|
8099
|
+
* case the <code>TransactWriteItems</code> operation fails with a
|
|
8100
|
+
* <code>TransactionCanceledException</code>. </p>
|
|
7973
8101
|
* </li>
|
|
7974
8102
|
* </ul>
|
|
7975
8103
|
* <p>DynamoDB cancels a <code>TransactGetItems</code> request under the
|
|
@@ -8114,9 +8242,9 @@ export interface TransactGetItemsOutput {
|
|
|
8114
8242
|
* global secondary indexes. DynamoDB is automatically
|
|
8115
8243
|
* scaling your index so please try again shortly.</p>
|
|
8116
8244
|
* <note>
|
|
8117
|
-
* <p>This message is returned when writes get throttled on
|
|
8118
|
-
*
|
|
8119
|
-
*
|
|
8245
|
+
* <p>This message is returned when writes get throttled on an
|
|
8246
|
+
* On-Demand GSI as DynamoDB is automatically scaling
|
|
8247
|
+
* the GSI.</p>
|
|
8120
8248
|
* </note>
|
|
8121
8249
|
* </li>
|
|
8122
8250
|
* </ul>
|