aws dynamodb57 CLI commands available for Amazon DynamoDB.
| Command | API Operation | Sample |
|---|---|---|
batch-execute-statementThis operation allows you to perform batch reads or writes on data stored in DynamoDB, using PartiQL. Each read statement in a BatchExecuteStatement must specify an equality condition on all key attributes. This enforces that each SELECT statement in a batch returns at most a single item. For more i | BatchExecuteStatement | |
batch-get-itemThe BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items. BatchGetItem returns a partial result if the response size limit i | BatchGetItem | |
batch-write-itemThe BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can transmit up to 16MB of data over the network, consisting of up to 25 item put or delete operations. While individual items can be up to 400 KB once stored, it's important to note th | BatchWriteItem | |
create-backupCreates a backup for an existing table. Each time you create an on-demand backup, the entire table data is backed up. There is no limit to the number of on-demand backups that can be taken. When you create an on-demand backup, a time marker of the request is cataloged, and the backup is created a | CreateBackup | |
create-global-tableCreates a global table from an existing table. A global table creates a replication relationship between two or more DynamoDB tables with the same table name in the provided Regions. This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tabl | CreateGlobalTable | |
create-tableThe CreateTable operation adds a new table to your account. In an Amazon Web Services account, table names must be unique within each Region. That is, you can have two tables with same name if you create the tables in different Regions. CreateTable is an asynchronous operation. Upon receiving a Cre | CreateTable | |
delete-backupDeletes an existing backup of a table. You can call DeleteBackup at a maximum rate of 10 times per second. | DeleteBackup | |
delete-itemDeletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value. In addition to deleting an item, you can also return the item's attribute values in the same operation, using the ReturnValues | DeleteItem | |
delete-resource-policyDeletes the resource-based policy attached to the resource, which can be a table or stream. DeleteResourcePolicy is an idempotent operation; running it multiple times on the same resource doesn't result in an error response, unless you specify an ExpectedRevisionId, which will then return a PolicyN | DeleteResourcePolicy | |
delete-tableThe DeleteTable operation deletes a table and all of its items. After a DeleteTable request, the specified table is in the DELETING state until DynamoDB completes the deletion. If the table is in the ACTIVE state, you can delete it. If a table is in CREATING or UPDATING states, then DynamoDB returns | DeleteTable | |
describe-backupDescribes an existing backup of a table. You can call DescribeBackup at a maximum rate of 10 times per second. | DescribeBackup | |
describe-continuous-backupsChecks the status of continuous backups and point in time recovery on the specified table. Continuous backups are ENABLED on all tables at table creation. If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED. After continuous backups and point in time recovery are | DescribeContinuousBackups | |
describe-contributor-insightsReturns information about contributor insights for a given table or global secondary index. | DescribeContributorInsights | |
describe-endpointsReturns the regional endpoint information. For more information on policy permissions, please see Internetwork traffic privacy. | DescribeEndpoints | |
describe-exportDescribes an existing table export. | DescribeExport | |
describe-global-tableReturns information about the specified global table. This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher | DescribeGlobalTable | |
describe-global-table-settingsDescribes Region-specific settings for a global table. This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, highe | DescribeGlobalTableSettings | |
describe-importRepresents the properties of the import. | DescribeImport | |
describe-kinesis-streaming-destinationReturns information about the status of Kinesis streaming. | DescribeKinesisStreamingDestination | |
describe-limitsReturns the current provisioned-capacity quotas for your Amazon Web Services account in a Region, both for the Region as a whole and for any one DynamoDB table that you create there. When you establish an Amazon Web Services account, the account has initial quotas on the maximum read capacity units | DescribeLimits | |
describe-tableReturns 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. If you issue a DescribeTable request immediately after a CreateTable request, DynamoDB might return a ResourceNotFoundException. This is because | DescribeTable | |
describe-table-replica-auto-scalingDescribes auto scaling settings across replicas of the global table at once. | DescribeTableReplicaAutoScaling | |
describe-time-to-liveGives a description of the Time to Live (TTL) status on the specified table. | DescribeTimeToLive | |
disable-kinesis-streaming-destinationStops replication from the DynamoDB table to the Kinesis data stream. This is done without deleting either of the resources. | DisableKinesisStreamingDestination | |
enable-kinesis-streaming-destinationStarts table data replication to the specified Kinesis data stream at a timestamp chosen during the enable workflow. If this operation doesn't return results immediately, use DescribeKinesisStreamingDestination to check if streaming to the Kinesis data stream is ACTIVE. | EnableKinesisStreamingDestination | |
execute-statementThis operation allows you to perform reads and singleton writes on data stored in DynamoDB, using PartiQL. For PartiQL reads (SELECT statement), if the total number of processed items exceeds the maximum dataset size limit of 1 MB, the read stops and results are returned to the user as a LastEvaluat | ExecuteStatement | |
execute-transactionThis operation allows you to perform transactional reads or writes on data stored in DynamoDB, using PartiQL. The entire transaction must consist of either read statements or write statements, you cannot mix both in one transaction. The EXISTS function is an exception and can be used to check the c | ExecuteTransaction | |
export-table-to-point-in-timeExports table data to an S3 bucket. The table must have point in time recovery enabled, and you can export data from any time within the point in time recovery window. | ExportTableToPointInTime | |
get-itemThe GetItem operation returns a set of attributes for the item with the given primary key. If there is no matching item, GetItem does not return any data and there will be no Item element in the response. GetItem provides an eventually consistent read by default. If your application requires a stro | GetItem | |
get-resource-policyReturns the resource-based policy document attached to the resource, which can be a table or stream, in JSON format. GetResourcePolicy follows an eventually consistent model. The following list describes the outcomes when you issue the GetResourcePolicy request immediately after issuing another r | GetResourcePolicy | |
import-tableImports table data from an S3 bucket. | ImportTable | |
list-backupsList DynamoDB backups that are associated with an Amazon Web Services account and weren't made with Amazon Web Services Backup. To list these backups for a given table, specify TableName. ListBackups returns a paginated list of results with at most 1 MB worth of items in a page. You can also specify | ListBackups | |
list-contributor-insightsReturns a list of ContributorInsightsSummary for a table and all its global secondary indexes. | ListContributorInsights | |
list-exportsLists completed exports within the past 90 days, in reverse alphanumeric order of ExportArn. | ListExports | |
list-global-tablesLists all global tables that have a replica in the specified Region. This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flex | ListGlobalTables | |
list-importsLists completed imports within the past 90 days. | ListImports | |
list-tablesReturns an array of table names associated with the current account and endpoint. The output from ListTables is paginated, with each page returning a maximum of 100 table names. | ListTables | |
list-tags-of-resourceList all tags on an Amazon DynamoDB resource. You can call ListTagsOfResource up to 10 times per second, per account. For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide. | ListTagsOfResource | |
put-itemCreates a new item, or replaces an old item with a new item. If an item that has the same primary key as the new item already exists in the specified table, the new item completely replaces the existing item. You can perform a conditional put operation (add a new item if one with the specified prima | PutItem | |
put-resource-policyAttaches a resource-based policy document to the resource, which can be a table or stream. When you attach a resource-based policy using this API, the policy application is eventually consistent . PutResourcePolicy is an idempotent operation; running it multiple times on the same resource using th | PutResourcePolicy | |
queryYou must provide the name of the partition key attribute and a single value for that attribute. Query returns all items with that partition key value. Optionally, you can provide a sort key attribute and use a comparison operator to refine the search results. Use the KeyConditionExpression parameter | Query | |
restore-table-from-backupCreates a new table from an existing backup. Any number of users can execute up to 50 concurrent restores (any type of restore) in a given account. You can call RestoreTableFromBackup at a maximum rate of 10 times per second. You must manually set up the following on the restored table: Auto scal | RestoreTableFromBackup | |
restore-table-to-point-in-timeRestores the specified table to the specified point in time within EarliestRestorableDateTime and LatestRestorableDateTime. You can restore your table to any point in time in the last 35 days. You can set the recovery period to any value between 1 and 35 days. Any number of users can execute up to 5 | RestoreTableToPointInTime | |
scanThe Scan operation returns one or more items and item attributes by accessing every item in a table or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression operation. If the total size of scanned items exceeds the maximum dataset size limit of 1 MB, the scan com | Scan | |
tag-resourceAssociate a set of tags with an Amazon DynamoDB resource. You can then activate these user-defined tags so that they appear on the Billing and Cost Management console for cost allocation tracking. You can call TagResource up to five times per second, per account. TagResource is an asynchronous o | TagResource | |
transact-get-itemsTransactGetItems is a synchronous operation that atomically retrieves multiple items from one or more tables (but not from indexes) in a single account and Region. A TransactGetItems call can contain up to 100 TransactGetItem objects, each of which contains a Get structure that specifies an item to | TransactGetItems | |
transact-write-itemsTransactWriteItems is a synchronous write operation that groups up to 100 action requests. These actions can target items in different tables, but not in different Amazon Web Services accounts or Regions, and no two actions can target the same item. For example, you cannot both ConditionCheck and U | TransactWriteItems | |
untag-resourceRemoves the association of tags from an Amazon DynamoDB resource. You can call UntagResource up to five times per second, per account. UntagResource is an asynchronous operation. If you issue a ListTagsOfResource request immediately after an UntagResource request, DynamoDB might return your prev | UntagResource | |
update-continuous-backupsUpdateContinuousBackups enables or disables point in time recovery for the specified table. A successful UpdateContinuousBackups call returns the current ContinuousBackupsDescription. Continuous backups are ENABLED on all tables at table creation. If point in time recovery is enabled, PointInTimeRe | UpdateContinuousBackups | |
update-contributor-insightsUpdates the status for contributor insights for a specific table or index. CloudWatch Contributor Insights for DynamoDB graphs display the partition key and (if applicable) sort key of frequently accessed items and frequently throttled items in plaintext. If you require the use of Amazon Web Service | UpdateContributorInsights | |
update-global-tableAdds or removes replicas in the specified global table. The global table must already exist to be able to use this operation. Any replica to be added must be empty, have the same name as the global table, have the same key schema, have DynamoDB Streams enabled, and have the same provisioned and maxi | UpdateGlobalTable | |
update-global-table-settingsUpdates settings for a global table. This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher efficiency, and | UpdateGlobalTableSettings | |
update-itemEdits an existing item's attributes, or adds a new item to the table if it does not already exist. You can put, delete, or add attribute values. You can also perform a conditional update on an existing item (insert a new attribute name-value pair if it doesn't exist, or replace an existing name-valu | UpdateItem | |
update-kinesis-streaming-destinationThe command to update the Kinesis stream destination. | UpdateKinesisStreamingDestination | |
update-tableModifies the provisioned throughput settings, global secondary indexes, or DynamoDB Streams settings for a given table. You can only perform one of the following operations at once: Modify the provisioned throughput settings of the table. Remove a global secondary index from the table. Create | UpdateTable | |
update-table-replica-auto-scalingUpdates auto scaling settings on your global tables at once. | UpdateTableReplicaAutoScaling | |
update-time-to-liveThe UpdateTimeToLive method enables or disables Time to Live (TTL) for the specified table. A successful UpdateTimeToLive call returns the current TimeToLiveSpecification. It can take up to one hour for the change to fully process. Any additional UpdateTimeToLive calls for the same table during this | UpdateTimeToLive |
Everything you need to know about Amazon DynamoDB on one page. HD quality, print-friendly.
Download Free InfographicEverything you need to know about Amazon DynamoDB on one page. HD quality, print-friendly.
Download Free InfographicDynamoDB