AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Update-DDBTable-TableName <String>-AttributeDefinition <AttributeDefinition[]>-BillingMode <BillingMode>-SSESpecification_Enabled <Boolean>-GlobalSecondaryIndexUpdate <GlobalSecondaryIndexUpdate[]>-SSESpecification_KMSMasterKeyId <String>-ReadCapacity <Int64>-ReplicaUpdate <ReplicationGroupUpdate[]>-SSESpecification_SSEType <SSEType>-StreamSpecification_StreamEnabled <Boolean>-StreamSpecification_StreamViewType <StreamViewType>-TableClass <TableClass>-WriteCapacity <Int64>-Select <String>-PassThru <SwitchParameter>-Force <SwitchParameter>-ClientConfig <AmazonDynamoDBConfig>
UpdateTable
to perform other operations. UpdateTable
is an asynchronous operation; while it is executing, the table status changes from ACTIVE
to UPDATING
. While it is UPDATING
, you cannot issue another UpdateTable
request. When the table returns to the ACTIVE
state, the UpdateTable
operation is complete. AttributeDefinitions
must include the key element(s) of the new index. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | AttributeDefinitions |
PROVISIONED
- We recommend using PROVISIONED
for predictable workloads. PROVISIONED
sets the billing mode to Provisioned Mode.PAY_PER_REQUEST
- We recommend using PAY_PER_REQUEST
for unpredictable workloads. PAY_PER_REQUEST
sets the billing mode to On-Demand Mode. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Create
- add a new global secondary index to the table.Update
- modify the provisioned throughput settings of an existing global secondary index.Delete
- remove a global secondary index from the table.UpdateTable
operation.For more information, see Managing Global Secondary Indexes in the Amazon DynamoDB Developer Guide. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | GlobalSecondaryIndexUpdates |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide.If read/write capacity mode is PAY_PER_REQUEST
the value is set to 0. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | ProvisionedThroughput_ReadCapacityUnits |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | ReplicaUpdates |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
KMS
and an Amazon Web Services managed key is used (KMS charges apply). If disabled (false) or not specified, server-side encryption is set to Amazon Web Services owned key. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
alias/aws/dynamodb
. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
KMS
- Server-side encryption that uses Key Management Service. The key is stored in your account and is managed by KMS (KMS charges apply).Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
StreamViewType
determines what information is written to the stream for this table. Valid values for StreamViewType
are:KEYS_ONLY
- Only the key attributes of the modified item are written to the stream.NEW_IMAGE
- The entire item, as it appears after it was modified, is written to the stream.OLD_IMAGE
- The entire item, as it appeared before it was modified, is written to the stream.NEW_AND_OLD_IMAGES
- Both the new and the old item images of the item are written to the stream.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
STANDARD
and STANDARD_INFREQUENT_ACCESS
. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | True |
Position? | 1 |
Accept pipeline input? | True (ByValue, ByPropertyName) |
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide.If read/write capacity mode is PAY_PER_REQUEST
the value is set to 0. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | ProvisionedThroughput_WriteCapacityUnits |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | AK |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | AWSProfilesLocation, ProfilesLocation |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | StoredCredentials, AWSProfileName |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | RegionToCall |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | SK, SecretAccessKey |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | ST |
Update-DDBTable -TableName "myTable" -ReadCapacity 10 -WriteCapacity 5Updates the provisioned throughput for the given table.
AWS Tools for PowerShell: 2.x.y.z