@datafire/amazonaws_dynamodb v5.0.0
@datafire/amazonaws_dynamodb
Client library for Amazon DynamoDB
Installation and Usage
npm install --save @datafire/amazonaws_dynamodb
let amazonaws_dynamodb = require('@datafire/amazonaws_dynamodb').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
amazonaws_dynamodb.BatchGetItem({
"RequestItems": []
}).then(data => {
console.log(data);
});
Description
Amazon DynamoDB Amazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability. DynamoDB lets you offload the administrative burdens of operating and scaling a distributed database, so that you don't have to worry about hardware provisioning, setup and configuration, replication, software patching, or cluster scaling. With DynamoDB, you can create database tables that can store and retrieve any amount of data, and serve any level of request traffic. You can scale up or scale down your tables' throughput capacity without downtime or performance degradation, and use the AWS Management Console to monitor resource utilization and performance metrics. DynamoDB automatically spreads the data and traffic for your tables over a sufficient number of servers to handle your throughput and storage requirements, while maintaining consistent and fast performance. All of your data is stored on solid state disks (SSDs) and automatically replicated across multiple Availability Zones in an AWS region, providing built-in high availability and data durability.
Actions
BatchGetItem
amazonaws_dynamodb.BatchGetItem({
"RequestItems": []
}, context)
Input
- input
object
- RequestItems
string
- RequestItems required BatchGetRequestMap
- ReturnConsumedCapacity ReturnConsumedCapacity
- RequestItems
Output
- output BatchGetItemOutput
BatchWriteItem
amazonaws_dynamodb.BatchWriteItem({
"RequestItems": []
}, context)
Input
- input
object
- RequestItems required BatchWriteItemRequestMap
- ReturnConsumedCapacity ReturnConsumedCapacity
- ReturnItemCollectionMetrics ReturnItemCollectionMetrics
Output
- output BatchWriteItemOutput
CreateBackup
amazonaws_dynamodb.CreateBackup({
"TableName": "",
"BackupName": ""
}, context)
Input
- input
object
- BackupName required BackupName
- TableName required TableName
Output
- output CreateBackupOutput
CreateGlobalTable
amazonaws_dynamodb.CreateGlobalTable({
"GlobalTableName": "",
"ReplicationGroup": []
}, context)
Input
- input
object
- GlobalTableName required TableName
- ReplicationGroup required ReplicaList
Output
- output CreateGlobalTableOutput
CreateTable
amazonaws_dynamodb.CreateTable({
"AttributeDefinitions": [],
"TableName": "",
"KeySchema": [],
"ProvisionedThroughput": {
"ReadCapacityUnits": 0,
"WriteCapacityUnits": 0
}
}, context)
Input
- input
object
- AttributeDefinitions required AttributeDefinitions
- GlobalSecondaryIndexes GlobalSecondaryIndexList
- KeySchema required KeySchema
- LocalSecondaryIndexes LocalSecondaryIndexList
- ProvisionedThroughput required ProvisionedThroughput
- SSESpecification SSESpecification
- StreamSpecification StreamSpecification
- TableName required TableName
Output
- output CreateTableOutput
DeleteBackup
amazonaws_dynamodb.DeleteBackup({
"BackupArn": ""
}, context)
Input
- input
object
- BackupArn required BackupArn
Output
- output DeleteBackupOutput
DeleteItem
amazonaws_dynamodb.DeleteItem({
"TableName": "",
"Key": []
}, context)
Input
- input
object
- ConditionExpression ConditionExpression
- ConditionalOperator ConditionalOperator
- Expected ExpectedAttributeMap
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- Key required Key
- ReturnConsumedCapacity ReturnConsumedCapacity
- ReturnItemCollectionMetrics ReturnItemCollectionMetrics
- ReturnValues ReturnValue
- TableName required TableName
Output
- output DeleteItemOutput
DeleteTable
amazonaws_dynamodb.DeleteTable({
"TableName": ""
}, context)
Input
- input
object
- TableName required TableName
Output
- output DeleteTableOutput
DescribeBackup
amazonaws_dynamodb.DescribeBackup({
"BackupArn": ""
}, context)
Input
- input
object
- BackupArn required BackupArn
Output
- output DescribeBackupOutput
DescribeContinuousBackups
amazonaws_dynamodb.DescribeContinuousBackups({
"TableName": ""
}, context)
Input
- input
object
- TableName required TableName
Output
DescribeGlobalTable
amazonaws_dynamodb.DescribeGlobalTable({
"GlobalTableName": ""
}, context)
Input
- input
object
- GlobalTableName required TableName
Output
- output DescribeGlobalTableOutput
DescribeLimits
amazonaws_dynamodb.DescribeLimits({}, context)
Input
- input
object
Output
- output DescribeLimitsOutput
DescribeTable
amazonaws_dynamodb.DescribeTable({
"TableName": ""
}, context)
Input
- input
object
- TableName required TableName
Output
- output DescribeTableOutput
DescribeTimeToLive
amazonaws_dynamodb.DescribeTimeToLive({
"TableName": ""
}, context)
Input
- input
object
- TableName required TableName
Output
- output DescribeTimeToLiveOutput
GetItem
amazonaws_dynamodb.GetItem({
"TableName": "",
"Key": []
}, context)
Input
- input
object
- AttributesToGet AttributeNameList
- ConsistentRead ConsistentRead
- ExpressionAttributeNames ExpressionAttributeNameMap
- Key required Key
- ProjectionExpression ProjectionExpression
- ReturnConsumedCapacity ReturnConsumedCapacity
- TableName required TableName
Output
- output GetItemOutput
ListBackups
amazonaws_dynamodb.ListBackups({}, context)
Input
- input
object
- ExclusiveStartBackupArn BackupArn
- Limit BackupsInputLimit
- TableName TableName
- TimeRangeLowerBound TimeRangeLowerBound
- TimeRangeUpperBound TimeRangeUpperBound
Output
- output ListBackupsOutput
ListGlobalTables
amazonaws_dynamodb.ListGlobalTables({}, context)
Input
- input
object
- ExclusiveStartGlobalTableName TableName
- Limit PositiveIntegerObject
- RegionName RegionName
Output
- output ListGlobalTablesOutput
ListTables
amazonaws_dynamodb.ListTables({}, context)
Input
- input
object
- Limit
string
- ExclusiveStartTableName
string
- ExclusiveStartTableName TableName
- Limit ListTablesInputLimit
- Limit
Output
- output ListTablesOutput
ListTagsOfResource
amazonaws_dynamodb.ListTagsOfResource({
"ResourceArn": ""
}, context)
Input
- input
object
- NextToken NextTokenString
- ResourceArn required ResourceArnString
Output
- output ListTagsOfResourceOutput
PutItem
amazonaws_dynamodb.PutItem({
"TableName": "",
"Item": []
}, context)
Input
- input
object
- ConditionExpression ConditionExpression
- ConditionalOperator ConditionalOperator
- Expected ExpectedAttributeMap
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- Item required PutItemInputAttributeMap
- ReturnConsumedCapacity ReturnConsumedCapacity
- ReturnItemCollectionMetrics ReturnItemCollectionMetrics
- ReturnValues ReturnValue
- TableName required TableName
Output
- output PutItemOutput
Query
amazonaws_dynamodb.Query({
"TableName": ""
}, context)
Input
- input
object
- Limit
string
- ExclusiveStartKey
string
- AttributesToGet AttributeNameList
- ConditionalOperator ConditionalOperator
- ConsistentRead ConsistentRead
- ExclusiveStartKey Key
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- FilterExpression ConditionExpression
- IndexName IndexName
- KeyConditionExpression KeyExpression
- KeyConditions KeyConditions
- Limit PositiveIntegerObject
- ProjectionExpression ProjectionExpression
- QueryFilter FilterConditionMap
- ReturnConsumedCapacity ReturnConsumedCapacity
- ScanIndexForward BooleanObject
- Select Select
- TableName required TableName
- Limit
Output
- output QueryOutput
RestoreTableFromBackup
amazonaws_dynamodb.RestoreTableFromBackup({
"TargetTableName": "",
"BackupArn": ""
}, context)
Input
Output
- output RestoreTableFromBackupOutput
Scan
amazonaws_dynamodb.Scan({
"TableName": ""
}, context)
Input
- input
object
- Limit
string
- ExclusiveStartKey
string
- AttributesToGet AttributeNameList
- ConditionalOperator ConditionalOperator
- ConsistentRead ConsistentRead
- ExclusiveStartKey Key
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- FilterExpression ConditionExpression
- IndexName IndexName
- Limit PositiveIntegerObject
- ProjectionExpression ProjectionExpression
- ReturnConsumedCapacity ReturnConsumedCapacity
- ScanFilter FilterConditionMap
- Segment ScanSegment
- Select Select
- TableName required TableName
- TotalSegments ScanTotalSegments
- Limit
Output
- output ScanOutput
TagResource
amazonaws_dynamodb.TagResource({
"ResourceArn": "",
"Tags": []
}, context)
Input
- input
object
- ResourceArn required ResourceArnString
- Tags required TagList
Output
Output schema unknown
UntagResource
amazonaws_dynamodb.UntagResource({
"ResourceArn": "",
"TagKeys": []
}, context)
Input
- input
object
- ResourceArn required ResourceArnString
- TagKeys required TagKeyList
Output
Output schema unknown
UpdateGlobalTable
amazonaws_dynamodb.UpdateGlobalTable({
"GlobalTableName": "",
"ReplicaUpdates": []
}, context)
Input
- input
object
- GlobalTableName required TableName
- ReplicaUpdates required ReplicaUpdateList
Output
- output UpdateGlobalTableOutput
UpdateItem
amazonaws_dynamodb.UpdateItem({
"TableName": "",
"Key": []
}, context)
Input
- input
object
- AttributeUpdates AttributeUpdates
- ConditionExpression ConditionExpression
- ConditionalOperator ConditionalOperator
- Expected ExpectedAttributeMap
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- Key required Key
- ReturnConsumedCapacity ReturnConsumedCapacity
- ReturnItemCollectionMetrics ReturnItemCollectionMetrics
- ReturnValues ReturnValue
- TableName required TableName
- UpdateExpression UpdateExpression
Output
- output UpdateItemOutput
UpdateTable
amazonaws_dynamodb.UpdateTable({
"TableName": ""
}, context)
Input
- input
object
- AttributeDefinitions AttributeDefinitions
- GlobalSecondaryIndexUpdates GlobalSecondaryIndexUpdateList
- ProvisionedThroughput ProvisionedThroughput
- StreamSpecification StreamSpecification
- TableName required TableName
Output
- output UpdateTableOutput
UpdateTimeToLive
amazonaws_dynamodb.UpdateTimeToLive({
"TableName": "",
"TimeToLiveSpecification": {
"Enabled": true,
"AttributeName": ""
}
}, context)
Input
- input
object
- TableName required TableName
- TimeToLiveSpecification required TimeToLiveSpecification
Output
- output UpdateTimeToLiveOutput
Definitions
AttributeAction
- AttributeAction
string
(values: ADD, PUT, DELETE)
AttributeDefinition
- AttributeDefinition
object
: Represents an attribute for describing the key schema for the table and indexes.- AttributeName required KeySchemaAttributeName
- AttributeType required ScalarAttributeType
AttributeDefinitions
- AttributeDefinitions
array
- items AttributeDefinition
AttributeMap
- AttributeMap
array
- items
object
- key AttributeName
- value AttributeValue
- items
AttributeName
- AttributeName
string
AttributeNameList
- AttributeNameList
array
- items AttributeName
AttributeUpdates
- AttributeUpdates
array
- items
object
- key AttributeName
- value AttributeValueUpdate
- items
AttributeValue
- AttributeValue
object
: Represents the data for an attribute. Each attribute value is described as a name-value pair. The name is the data type, and the value is the data itself. For more information, see Data Types in the Amazon DynamoDB Developer Guide.
AttributeValueList
- AttributeValueList
array
- items AttributeValue
AttributeValueUpdate
- AttributeValueUpdate
object
: For the UpdateItem operation, represents the attributes to be modified, the action to perform on each, and the new value for each. You cannot use UpdateItem to update any primary key attributes. Instead, you will need to delete the item, and then use PutItem to create a new item with new attributes. Attribute values cannot be null; string and binary type attributes must have lengths greater than zero; and set type attributes must not be empty. Requests with empty values will be rejected with a ValidationException exception.- Action AttributeAction
- Value AttributeValue
Backfilling
- Backfilling
boolean
BackupArn
- BackupArn
string
BackupCreationDateTime
- BackupCreationDateTime
string
BackupDescription
- BackupDescription
object
: Contains the description of the backup created for the table.- BackupDetails BackupDetails
- SourceTableDetails SourceTableDetails
- SourceTableFeatureDetails SourceTableFeatureDetails
BackupDetails
- BackupDetails
object
: Contains the details of the backup created for the table.- BackupArn required BackupArn
- BackupCreationDateTime required BackupCreationDateTime
- BackupName required BackupName
- BackupSizeBytes BackupSizeBytes
- BackupStatus required BackupStatus
BackupInUseException
- BackupInUseException
object
: There is another ongoing conflicting backup control plane operation on the table. The backups is either being created, deleted or restored to a table.- message ErrorMessage
BackupName
- BackupName
string
BackupNotFoundException
- BackupNotFoundException
object
: Backup not found for the given BackupARN.- message ErrorMessage
BackupSizeBytes
- BackupSizeBytes
integer
BackupStatus
- BackupStatus
string
(values: CREATING, DELETED, AVAILABLE)
BackupSummaries
- BackupSummaries
array
- items BackupSummary
BackupSummary
- BackupSummary
object
: Contains details for the backup.- BackupArn BackupArn
- BackupCreationDateTime BackupCreationDateTime
- BackupName BackupName
- BackupSizeBytes BackupSizeBytes
- BackupStatus BackupStatus
- TableArn TableArn
- TableId TableId
- TableName TableName
BackupsInputLimit
- BackupsInputLimit
integer
BatchGetItemInput
- BatchGetItemInput
object
: Represents the input of a BatchGetItem operation.- RequestItems required BatchGetRequestMap
- ReturnConsumedCapacity ReturnConsumedCapacity
BatchGetItemOutput
- BatchGetItemOutput
object
: Represents the output of a BatchGetItem operation.- ConsumedCapacity ConsumedCapacityMultiple
- Responses BatchGetResponseMap
- UnprocessedKeys BatchGetRequestMap
BatchGetRequestMap
- BatchGetRequestMap
array
- items
object
- key TableName
- value KeysAndAttributes
- items
BatchGetResponseMap
BatchWriteItemInput
- BatchWriteItemInput
object
: Represents the input of a BatchWriteItem operation.- RequestItems required BatchWriteItemRequestMap
- ReturnConsumedCapacity ReturnConsumedCapacity
- ReturnItemCollectionMetrics ReturnItemCollectionMetrics
BatchWriteItemOutput
- BatchWriteItemOutput
object
: Represents the output of a BatchWriteItem operation.- ConsumedCapacity ConsumedCapacityMultiple
- ItemCollectionMetrics ItemCollectionMetricsPerTable
- UnprocessedItems BatchWriteItemRequestMap
BatchWriteItemRequestMap
- BatchWriteItemRequestMap
array
- items
object
- key TableName
- value WriteRequests
- items
BinaryAttributeValue
- BinaryAttributeValue
string
BinarySetAttributeValue
- BinarySetAttributeValue
array
- items BinaryAttributeValue
BooleanAttributeValue
- BooleanAttributeValue
boolean
BooleanObject
- BooleanObject
boolean
Capacity
- Capacity
object
: Represents the amount of provisioned throughput capacity consumed on a table or an index.- CapacityUnits ConsumedCapacityUnits
ComparisonOperator
- ComparisonOperator
string
(values: EQ, NE, IN, LE, LT, GE, GT, BETWEEN, NOT_NULL, NULL, CONTAINS, NOT_CONTAINS, BEGINS_WITH)
Condition
- Condition
object
: Represents the selection criteria for a Query or Scan operation: For a Query operation, Condition is used for specifying the KeyConditions to use when querying a table or an index. For KeyConditions, only the following comparison operators are supported: EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN Condition is also used in a QueryFilter, which evaluates the query results and returns only the desired values. For a Scan operation, Condition is used in a ScanFilter, which evaluates the scan results and returns only the desired values.- AttributeValueList AttributeValueList
- ComparisonOperator required ComparisonOperator
ConditionExpression
- ConditionExpression
string
ConditionalCheckFailedException
- ConditionalCheckFailedException
object
: A condition specified in the operation could not be evaluated.- message ErrorMessage
ConditionalOperator
- ConditionalOperator
string
(values: AND, OR)
ConsistentRead
- ConsistentRead
boolean
ConsumedCapacity
- ConsumedCapacity
object
: The capacity units consumed by an operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity is only returned if the request asked for it. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.- CapacityUnits ConsumedCapacityUnits
- GlobalSecondaryIndexes SecondaryIndexesCapacityMap
- LocalSecondaryIndexes SecondaryIndexesCapacityMap
- Table Capacity
- TableName TableName
ConsumedCapacityMultiple
- ConsumedCapacityMultiple
array
- items ConsumedCapacity
ConsumedCapacityUnits
- ConsumedCapacityUnits
number
ContinuousBackupsDescription
- ContinuousBackupsDescription
object
: Represents the backup and restore settings on the table when the backup was created.- ContinuousBackupsStatus required ContinuousBackupsStatus
ContinuousBackupsStatus
- ContinuousBackupsStatus
string
(values: ENABLED, DISABLED)
ContinuousBackupsUnavailableException
- ContinuousBackupsUnavailableException
object
: Backups have not yet been enabled for this table.- message ErrorMessage
CreateBackupInput
- CreateBackupInput
object
- BackupName required BackupName
- TableName required TableName
CreateBackupOutput
- CreateBackupOutput
object
- BackupDetails BackupDetails
CreateGlobalSecondaryIndexAction
- CreateGlobalSecondaryIndexAction
object
: Represents a new global secondary index to be added to an existing table.- IndexName required IndexName
- KeySchema required KeySchema
- Projection required Projection
- ProvisionedThroughput required ProvisionedThroughput
CreateGlobalTableInput
- CreateGlobalTableInput
object
- GlobalTableName required TableName
- ReplicationGroup required ReplicaList
CreateGlobalTableOutput
- CreateGlobalTableOutput
object
- GlobalTableDescription GlobalTableDescription
CreateReplicaAction
- CreateReplicaAction
object
: Represents a replica to be added.- RegionName required RegionName
CreateTableInput
- CreateTableInput
object
: Represents the input of a CreateTable operation.- AttributeDefinitions required AttributeDefinitions
- GlobalSecondaryIndexes GlobalSecondaryIndexList
- KeySchema required KeySchema
- LocalSecondaryIndexes LocalSecondaryIndexList
- ProvisionedThroughput required ProvisionedThroughput
- SSESpecification SSESpecification
- StreamSpecification StreamSpecification
- TableName required TableName
CreateTableOutput
- CreateTableOutput
object
: Represents the output of a CreateTable operation.- TableDescription TableDescription
Date
- Date
string
DeleteBackupInput
- DeleteBackupInput
object
- BackupArn required BackupArn
DeleteBackupOutput
- DeleteBackupOutput
object
- BackupDescription BackupDescription
DeleteGlobalSecondaryIndexAction
- DeleteGlobalSecondaryIndexAction
object
: Represents a global secondary index to be deleted from an existing table.- IndexName required IndexName
DeleteItemInput
- DeleteItemInput
object
: Represents the input of a DeleteItem operation.- ConditionExpression ConditionExpression
- ConditionalOperator ConditionalOperator
- Expected ExpectedAttributeMap
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- Key required Key
- ReturnConsumedCapacity ReturnConsumedCapacity
- ReturnItemCollectionMetrics ReturnItemCollectionMetrics
- ReturnValues ReturnValue
- TableName required TableName
DeleteItemOutput
- DeleteItemOutput
object
: Represents the output of a DeleteItem operation.- Attributes AttributeMap
- ConsumedCapacity ConsumedCapacity
- ItemCollectionMetrics ItemCollectionMetrics
DeleteReplicaAction
- DeleteReplicaAction
object
: Represents a replica to be removed.- RegionName required RegionName
DeleteRequest
- DeleteRequest
object
: Represents a request to perform a DeleteItem operation on an item.- Key required Key
DeleteTableInput
- DeleteTableInput
object
: Represents the input of a DeleteTable operation.- TableName required TableName
DeleteTableOutput
- DeleteTableOutput
object
: Represents the output of a DeleteTable operation.- TableDescription TableDescription
DescribeBackupInput
- DescribeBackupInput
object
- BackupArn required BackupArn
DescribeBackupOutput
- DescribeBackupOutput
object
- BackupDescription BackupDescription
DescribeContinuousBackupsInput
- DescribeContinuousBackupsInput
object
- TableName required TableName
DescribeContinuousBackupsOutput
- DescribeContinuousBackupsOutput
object
- ContinuousBackupsDescription ContinuousBackupsDescription
DescribeGlobalTableInput
- DescribeGlobalTableInput
object
- GlobalTableName required TableName
DescribeGlobalTableOutput
- DescribeGlobalTableOutput
object
- GlobalTableDescription GlobalTableDescription
DescribeLimitsInput
- DescribeLimitsInput
object
: Represents the input of a DescribeLimits operation. Has no content.
DescribeLimitsOutput
- DescribeLimitsOutput
object
: Represents the output of a DescribeLimits operation.- AccountMaxReadCapacityUnits PositiveLongObject
- AccountMaxWriteCapacityUnits PositiveLongObject
- TableMaxReadCapacityUnits PositiveLongObject
- TableMaxWriteCapacityUnits PositiveLongObject
DescribeTableInput
- DescribeTableInput
object
: Represents the input of a DescribeTable operation.- TableName required TableName
DescribeTableOutput
- DescribeTableOutput
object
: Represents the output of a DescribeTable operation.- Table TableDescription
DescribeTimeToLiveInput
- DescribeTimeToLiveInput
object
- TableName required TableName
DescribeTimeToLiveOutput
- DescribeTimeToLiveOutput
object
- TimeToLiveDescription TimeToLiveDescription
ErrorMessage
- ErrorMessage
string
ExpectedAttributeMap
- ExpectedAttributeMap
array
- items
object
- key AttributeName
- value ExpectedAttributeValue
- items
ExpectedAttributeValue
- ExpectedAttributeValue
object
: Represents a condition to be compared with an attribute value. This condition can be used with DeleteItem, PutItem or UpdateItem operations; if the comparison evaluates to true, the operation succeeds; if not, the operation fails. You can use ExpectedAttributeValue in one of two different ways: Use AttributeValueList to specify one or more values to compare against an attribute. Use ComparisonOperator to specify how you want to perform the comparison. If the comparison evaluates to true, then the conditional operation succeeds. Use Value to specify a value that DynamoDB will compare against an attribute. If the values match, then ExpectedAttributeValue evaluates to true and the conditional operation succeeds. Optionally, you can also set Exists to false, indicating that you do not expect to find the attribute value in the table. In this case, the conditional operation succeeds only if the comparison evaluates to false. Value and Exists are incompatible with AttributeValueList and ComparisonOperator. Note that if you use both sets of parameters at once, DynamoDB will return a ValidationException exception.- AttributeValueList AttributeValueList
- ComparisonOperator ComparisonOperator
- Exists BooleanObject
- Value AttributeValue
ExpressionAttributeNameMap
- ExpressionAttributeNameMap
array
- items
object
- items
ExpressionAttributeNameVariable
- ExpressionAttributeNameVariable
string
ExpressionAttributeValueMap
- ExpressionAttributeValueMap
array
- items
object
- items
ExpressionAttributeValueVariable
- ExpressionAttributeValueVariable
string
FilterConditionMap
- FilterConditionMap
array
- items
object
- key AttributeName
- value Condition
- items
GetItemInput
- GetItemInput
object
: Represents the input of a GetItem operation.- AttributesToGet AttributeNameList
- ConsistentRead ConsistentRead
- ExpressionAttributeNames ExpressionAttributeNameMap
- Key required Key
- ProjectionExpression ProjectionExpression
- ReturnConsumedCapacity ReturnConsumedCapacity
- TableName required TableName
GetItemOutput
- GetItemOutput
object
: Represents the output of a GetItem operation.- ConsumedCapacity ConsumedCapacity
- Item AttributeMap
GlobalSecondaryIndex
- GlobalSecondaryIndex
object
: Represents the properties of a global secondary index.- IndexName required IndexName
- KeySchema required KeySchema
- Projection required Projection
- ProvisionedThroughput required ProvisionedThroughput
GlobalSecondaryIndexDescription
- GlobalSecondaryIndexDescription
object
: Represents the properties of a global secondary index.- Backfilling Backfilling
- IndexArn String
- IndexName IndexName
- IndexSizeBytes Long
- IndexStatus IndexStatus
- ItemCount Long
- KeySchema KeySchema
- Projection Projection
- ProvisionedThroughput ProvisionedThroughputDescription
GlobalSecondaryIndexDescriptionList
- GlobalSecondaryIndexDescriptionList
array
GlobalSecondaryIndexInfo
- GlobalSecondaryIndexInfo
object
: Represents the properties of a global secondary index for the table when the backup was created.- IndexName IndexName
- KeySchema KeySchema
- Projection Projection
- ProvisionedThroughput ProvisionedThroughput
GlobalSecondaryIndexList
- GlobalSecondaryIndexList
array
- items GlobalSecondaryIndex
GlobalSecondaryIndexUpdate
- GlobalSecondaryIndexUpdate
object
: Represents one of the following: A new global secondary index to be added to an existing table. New provisioned throughput parameters for an existing global secondary index. An existing global secondary index to be removed from an existing table.
GlobalSecondaryIndexUpdateList
- GlobalSecondaryIndexUpdateList
array
GlobalSecondaryIndexes
- GlobalSecondaryIndexes
array
- items GlobalSecondaryIndexInfo
GlobalTable
- GlobalTable
object
: Represents the properties of a global table.- GlobalTableName TableName
- ReplicationGroup ReplicaList
GlobalTableAlreadyExistsException
- GlobalTableAlreadyExistsException
object
: The specified global table already exists.- message ErrorMessage
GlobalTableArnString
- GlobalTableArnString
string
GlobalTableDescription
- GlobalTableDescription
object
: Contains details about the global table.- CreationDateTime Date
- GlobalTableArn GlobalTableArnString
- GlobalTableName TableName
- GlobalTableStatus GlobalTableStatus
- ReplicationGroup ReplicaDescriptionList
GlobalTableList
- GlobalTableList
array
- items GlobalTable
GlobalTableNotFoundException
- GlobalTableNotFoundException
object
: The specified global table does not exist.- message ErrorMessage
GlobalTableStatus
- GlobalTableStatus
string
(values: CREATING, ACTIVE, DELETING, UPDATING)
IndexName
- IndexName
string
IndexStatus
- IndexStatus
string
(values: CREATING, UPDATING, DELETING, ACTIVE)
Integer
- Integer
integer
InternalServerError
- InternalServerError
object
: An error occurred on the server side.- message ErrorMessage
ItemCollectionKeyAttributeMap
- ItemCollectionKeyAttributeMap
array
- items
object
- key AttributeName
- value AttributeValue
- items
ItemCollectionMetrics
- ItemCollectionMetrics
object
: Information about item collections, if any, that were affected by the operation. ItemCollectionMetrics is only returned if the request asked for it. If the table does not have any local secondary indexes, this information is not returned in the response.- ItemCollectionKey ItemCollectionKeyAttributeMap
- SizeEstimateRangeGB ItemCollectionSizeEstimateRange
ItemCollectionMetricsMultiple
- ItemCollectionMetricsMultiple
array
- items ItemCollectionMetrics
ItemCollectionMetricsPerTable
- ItemCollectionMetricsPerTable
array
- items
object
- key TableName
- value ItemCollectionMetricsMultiple
- items
ItemCollectionSizeEstimateBound
- ItemCollectionSizeEstimateBound
number
ItemCollectionSizeEstimateRange
- ItemCollectionSizeEstimateRange
array
ItemCollectionSizeLimitExceededException
- ItemCollectionSizeLimitExceededException
object
: An item collection is too large. This exception is only returned for tables that have one or more local secondary indexes.- message ErrorMessage
ItemCount
- ItemCount
integer
ItemList
- ItemList
array
- items AttributeMap
Key
- Key
array
- items
object
- key AttributeName
- value AttributeValue
- items
KeyConditions
- KeyConditions
array
- items
object
- key AttributeName
- value Condition
- items
KeyExpression
- KeyExpression
string
KeyList
- KeyList
array
- items Key
KeySchema
- KeySchema
array
- items KeySchemaElement
KeySchemaAttributeName
- KeySchemaAttributeName
string
KeySchemaElement
- KeySchemaElement
object
: Represents a single element of a key schema. A key schema specifies the attributes that make up the primary key of a table, or the key attributes of an index. A KeySchemaElement represents exactly one attribute of the primary key. For example, a simple primary key would be represented by one KeySchemaElement (for the partition key). A composite primary key would require one KeySchemaElement for the partition key, and another KeySchemaElement for the sort key. A KeySchemaElement must be a scalar, top-level attribute (not a nested attribute). The data type must be one of String, Number, or Binary. The attribute cannot be nested within a List or a Map.- AttributeName required KeySchemaAttributeName
- KeyType required KeyType
KeyType
- KeyType
string
(values: HASH, RANGE)
KeysAndAttributes
- KeysAndAttributes
object
: Represents a set of primary keys and, for each key, the attributes to retrieve from the table. For each primary key, you must provide all of the key attributes. For example, with a simple primary key, you only need to provide the partition key. For a composite primary key, you must provide both the partition key and the sort key.- AttributesToGet AttributeNameList
- ConsistentRead ConsistentRead
- ExpressionAttributeNames ExpressionAttributeNameMap
- Keys required KeyList
- ProjectionExpression ProjectionExpression
LimitExceededException
- LimitExceededException
object
: Up to 50 CreateBackup operations are allowed per second, per account. There is no limit to the number of daily on-demand backups that can be taken. Up to 10 simultaneous table operations are allowed per account. These operations include CreateTable, UpdateTable, DeleteTable,UpdateTimeToLive, and RestoreTableFromBackup. For tables with secondary indexes, only one of those tables can be in the CREATING state at any point in time. Do not attempt to create more than one such table simultaneously. The total limit of tables in the ACTIVE state is 250. For tables with secondary indexes, only one of those tables can be in the CREATING state at any point in time. Do not attempt to create more than one such table simultaneously. The total limit of tables in the ACTIVE state is 250.- message ErrorMessage
ListAttributeValue
- ListAttributeValue
array
- items AttributeValue
ListBackupsInput
- ListBackupsInput
object
- ExclusiveStartBackupArn BackupArn
- Limit BackupsInputLimit
- TableName TableName
- TimeRangeLowerBound TimeRangeLowerBound
- TimeRangeUpperBound TimeRangeUpperBound
ListBackupsOutput
- ListBackupsOutput
object
- BackupSummaries BackupSummaries
- LastEvaluatedBackupArn BackupArn
ListGlobalTablesInput
- ListGlobalTablesInput
object
- ExclusiveStartGlobalTableName TableName
- Limit PositiveIntegerObject
- RegionName RegionName
ListGlobalTablesOutput
- ListGlobalTablesOutput
object
- GlobalTables GlobalTableList
- LastEvaluatedGlobalTableName TableName
ListTablesInput
- ListTablesInput
object
: Represents the input of a ListTables operation.- ExclusiveStartTableName TableName
- Limit ListTablesInputLimit
ListTablesInputLimit
- ListTablesInputLimit
integer
ListTablesOutput
- ListTablesOutput
object
: Represents the output of a ListTables operation.- LastEvaluatedTableName TableName
- TableNames TableNameList
ListTagsOfResourceInput
- ListTagsOfResourceInput
object
- NextToken NextTokenString
- ResourceArn required ResourceArnString
ListTagsOfResourceOutput
- ListTagsOfResourceOutput
object
- NextToken NextTokenString
- Tags TagList
LocalSecondaryIndex
- LocalSecondaryIndex
object
: Represents the properties of a local secondary index.- IndexName required IndexName
- KeySchema required KeySchema
- Projection required Projection
LocalSecondaryIndexDescription
- LocalSecondaryIndexDescription
object
: Represents the properties of a local secondary index.
LocalSecondaryIndexDescriptionList
- LocalSecondaryIndexDescriptionList
array
LocalSecondaryIndexInfo
- LocalSecondaryIndexInfo
object
: Represents the properties of a local secondary index for the table when the backup was created.- IndexName IndexName
- KeySchema KeySchema
- Projection Projection
LocalSecondaryIndexList
- LocalSecondaryIndexList
array
- items LocalSecondaryIndex
LocalSecondaryIndexes
- LocalSecondaryIndexes
array
- items LocalSecondaryIndexInfo
Long
- Long
integer
MapAttributeValue
- MapAttributeValue
array
- items
object
- key AttributeName
- value AttributeValue
- items
NextTokenString
- NextTokenString
string
NonKeyAttributeName
- NonKeyAttributeName
string
NonKeyAttributeNameList
- NonKeyAttributeNameList
array
- items NonKeyAttributeName
NullAttributeValue
- NullAttributeValue
boolean
NumberAttributeValue
- NumberAttributeValue
string
NumberSetAttributeValue
- NumberSetAttributeValue
array
- items NumberAttributeValue
PositiveIntegerObject
- PositiveIntegerObject
integer
PositiveLongObject
- PositiveLongObject
integer
Projection
- Projection
object
: Represents attributes that are copied (projected) from the table into an index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.- NonKeyAttributes NonKeyAttributeNameList
- ProjectionType ProjectionType
ProjectionExpression
- ProjectionExpression
string
ProjectionType
- ProjectionType
string
(values: ALL, KEYS_ONLY, INCLUDE)
ProvisionedThroughput
- ProvisionedThroughput
object
: Represents the provisioned throughput settings for a specified table or index. The settings can be modified using the UpdateTable operation. For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.- ReadCapacityUnits required PositiveLongObject
- WriteCapacityUnits required PositiveLongObject
ProvisionedThroughputDescription
- ProvisionedThroughputDescription
object
: Represents the provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.- LastDecreaseDateTime Date
- LastIncreaseDateTime Date
- NumberOfDecreasesToday PositiveLongObject
- ReadCapacityUnits PositiveLongObject
- WriteCapacityUnits PositiveLongObject
ProvisionedThroughputExceededException
- ProvisionedThroughputExceededException
object
: Your request rate is too high. The AWS SDKs for DynamoDB automatically retry requests that receive this exception. Your request is eventually successful, unless your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff. For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.- message ErrorMessage
PutItemInput
- PutItemInput
object
: Represents the input of a PutItem operation.- ConditionExpression ConditionExpression
- ConditionalOperator ConditionalOperator
- Expected ExpectedAttributeMap
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- Item required PutItemInputAttributeMap
- ReturnConsumedCapacity ReturnConsumedCapacity
- ReturnItemCollectionMetrics ReturnItemCollectionMetrics
- ReturnValues ReturnValue
- TableName required TableName
PutItemInputAttributeMap
- PutItemInputAttributeMap
array
- items
object
- key AttributeName
- value AttributeValue
- items
PutItemOutput
- PutItemOutput
object
: Represents the output of a PutItem operation.- Attributes AttributeMap
- ConsumedCapacity ConsumedCapacity
- ItemCollectionMetrics ItemCollectionMetrics
PutRequest
- PutRequest
object
: Represents a request to perform a PutItem operation on an item.- Item required PutItemInputAttributeMap
QueryInput
- QueryInput
object
: Represents the input of a Query operation.- AttributesToGet AttributeNameList
- ConditionalOperator ConditionalOperator
- ConsistentRead ConsistentRead
- ExclusiveStartKey Key
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- FilterExpression ConditionExpression
- IndexName IndexName
- KeyConditionExpression KeyExpression
- KeyConditions KeyConditions
- Limit PositiveIntegerObject
- ProjectionExpression ProjectionExpression
- QueryFilter FilterConditionMap
- ReturnConsumedCapacity ReturnConsumedCapacity
- ScanIndexForward BooleanObject
- Select Select
- TableName required TableName
QueryOutput
- QueryOutput
object
: Represents the output of a Query operation.- ConsumedCapacity ConsumedCapacity
- Count Integer
- Items ItemList
- LastEvaluatedKey Key
- ScannedCount Integer
RegionName
- RegionName
string
Replica
- Replica
object
: Represents the properties of a replica.- RegionName RegionName
ReplicaAlreadyExistsException
- ReplicaAlreadyExistsException
object
: The specified replica is already part of the global table.- message ErrorMessage
ReplicaDescription
- ReplicaDescription
object
: Contains the details of the replica.- RegionName RegionName
ReplicaDescriptionList
- ReplicaDescriptionList
array
- items ReplicaDescription
ReplicaList
- ReplicaList
array
- items Replica
ReplicaNotFoundException
- ReplicaNotFoundException
object
: The specified replica is no longer part of the global table.- message ErrorMessage
ReplicaUpdate
- ReplicaUpdate
object
: Represents one of the following: A new replica to be added to an existing global table. New parameters for an existing replica. An existing replica to be removed from an existing global table.- Create CreateReplicaAction
- Delete DeleteReplicaAction
ReplicaUpdateList
- ReplicaUpdateList
array
- items ReplicaUpdate
ResourceArnString
- ResourceArnString
string
ResourceInUseException
- ResourceInUseException
object
: The operation conflicts with the resource's availability. For example, you attempted to recreate an existing table, or tried to delete a table currently in the CREATING state.- message ErrorMessage
ResourceNotFoundException
- ResourceNotFoundException
object
: The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its status might not be ACTIVE.- message ErrorMessage
RestoreDateTime
- RestoreDateTime
string
RestoreInProgress
- RestoreInProgress
boolean
RestoreSummary
- RestoreSummary
object
: Contains details for the restore.- RestoreDateTime required RestoreDateTime
- RestoreInProgress required RestoreInProgress
- SourceBackupArn BackupArn
- SourceTableArn TableArn
RestoreTableFromBackupInput
RestoreTableFromBackupOutput
- RestoreTableFromBackupOutput
object
- TableDescription TableDescription
ReturnConsumedCapacity
- ReturnConsumedCapacity
string
(values: INDEXES, TOTAL, NONE): Determines the level of detail about provisioned throughput consumption that is returned in the response: INDEXES - The response includes the aggregate ConsumedCapacity for the operation, together with ConsumedCapacity for each table and secondary index that was accessed. Note that some operations, such as GetItem and BatchGetItem, do not access any indexes at all. In these cases, specifying INDEXES will only return ConsumedCapacity information for table(s). TOTAL - The response includes only the aggregate ConsumedCapacity for the operation. NONE - No ConsumedCapacity details are included in the response.
ReturnItemCollectionMetrics
- ReturnItemCollectionMetrics
string
(values: SIZE, NONE)
ReturnValue
- ReturnValue
string
(values: NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW)
SSEDescription
- SSEDescription
object
: The description of the server-side encryption status on the specified table.- Status SSEStatus
SSEEnabled
- SSEEnabled
boolean
SSESpecification
- SSESpecification
object
: Represents the settings used to enable server-side encryption.- Enabled required SSEEnabled
SSEStatus
- SSEStatus
string
(values: ENABLING, ENABLED, DISABLING, DISABLED)
ScalarAttributeType
- ScalarAttributeType
string
(values: S, N, B)
ScanInput
- ScanInput
object
: Represents the input of a Scan operation.- AttributesToGet AttributeNameList
- ConditionalOperator ConditionalOperator
- ConsistentRead ConsistentRead
- ExclusiveStartKey Key
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues ExpressionAttributeValueMap
- FilterExpression ConditionExpression
- IndexName IndexName
- Limit PositiveIntegerObject
- ProjectionExpression ProjectionExpression
- ReturnConsumedCapacity ReturnConsumedCapacity
- ScanFilter FilterConditionMap
- Segment ScanSegment
- Select Select
- TableName required TableName
- TotalSegments ScanTotalSegments
ScanOutput
- ScanOutput
object
: Represents the output of a Scan operation.- ConsumedCapacity ConsumedCapacity
- Count Integer
- Items ItemList
- LastEvaluatedKey Key
- ScannedCount Integer
ScanSegment
- ScanSegment
integer
ScanTotalSegments
- ScanTotalSegments
integer
SecondaryIndexesCapacityMap
Select
- Select
string
(values: ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT)
SourceTableDetails
- SourceTableDetails
object
: Contains the details of the table when the backup was created.- ItemCount ItemCount
- KeySchema required KeySchema
- ProvisionedThroughput required ProvisionedThroughput
- TableArn TableArn
- TableCreationDateTime required TableCreationDateTime
- TableId required TableId
- TableName required TableName
- TableSizeBytes Long
SourceTableFeatureDetails
- SourceTableFeatureDetails
object
: Contains the details of the features enabled on the table when the backup was created. For example, LSIs, GSIs, streams, TTL.- GlobalSecondaryIndexes GlobalSecondaryIndexes
- LocalSecondaryIndexes LocalSecondaryIndexes
- SSEDescription SSEDescription
- StreamDescription StreamSpecification
- TimeToLiveDescription TimeToLiveDescription
StreamArn
- StreamArn
string
StreamEnabled
- StreamEnabled
boolean
StreamSpecification
- StreamSpecification
object
: Represents the DynamoDB Streams configuration for a table in DynamoDB.- StreamEnabled StreamEnabled
- StreamViewType StreamViewType
StreamViewType
- StreamViewType
string
(values: NEW_IMAGE, OLD_IMAGE, NEW_AND_OLD_IMAGES, KEYS_ONLY)
String
- String
string
StringAttributeValue
- StringAttributeValue
string
StringSetAttributeValue
- StringSetAttributeValue
array
- items StringAttributeValue
TableAlreadyExistsException
- TableAlreadyExistsException
object
: A table with the name already exists.- message ErrorMessage
TableArn
- TableArn
string
TableCreationDateTime
- TableCreationDateTime
string
TableDescription
- TableDescription
object
: Represents the properties of a table.- AttributeDefinitions AttributeDefinitions
- CreationDateTime Date
- GlobalSecondaryIndexes GlobalSecondaryIndexDescriptionList
- ItemCount Long
- KeySchema KeySchema
- LatestStreamArn StreamArn
- LatestStreamLabel String
- LocalSecondaryIndexes LocalSecondaryIndexDescriptionList
- ProvisionedThroughput ProvisionedThroughputDescription
- RestoreSummary RestoreSummary
- SSEDescription SSEDescription
- StreamSpecification StreamSpecification
- TableArn String
- TableId TableId
- TableName TableName
- TableSizeBytes Long
- TableStatus TableStatus
TableId
- TableId
string
TableInUseException
- TableInUseException
object
: A table by that name is either being created or deleted.- message ErrorMessage
TableName
- TableName
string
TableNameList
- TableNameList
array
- items TableName
TableNotFoundException
- TableNotFoundException
object
: A table with the name TableName does not currently exist within the subscriber's account.- message ErrorMessage
TableStatus
- TableStatus
string
(values: CREATING, UPDATING, DELETING, ACTIVE)
Tag
- Tag
object
: Describes a tag. A tag is a key-value pair. You can add up to 50 tags to a single DynamoDB table. AWS-assigned tag names and values are automatically assigned the aws: prefix, which the user cannot assign. AWS-assigned tag names do not count towards the tag limit of 50. User-assigned tag names have the prefix user: in the Cost Allocation Report. You cannot backdate the application of a tag. For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.- Key required TagKeyString
- Value required TagValueString
TagKeyList
- TagKeyList
array
- items TagKeyString
TagKeyString
- TagKeyString
string
TagList
- TagList
array
- items Tag
TagResourceInput
- TagResourceInput
object
- ResourceArn required ResourceArnString
- Tags required TagList
TagValueString
- TagValueString
string
TimeRangeLowerBound
- TimeRangeLowerBound
string
TimeRangeUpperBound
- TimeRangeUpperBound
string
TimeToLiveAttributeName
- TimeToLiveAttributeName
string
TimeToLiveDescription
- TimeToLiveDescription
object
: The description of the Time to Live (TTL) status on the specified table.- AttributeName TimeToLiveAttributeName
- TimeToLiveStatus TimeToLiveStatus
TimeToLiveEnabled
- TimeToLiveEnabled
boolean
TimeToLiveSpecification
- TimeToLiveSpecification
object
: Represents the settings used to enable or disable Time to Live for the specified table.- AttributeName required TimeToLiveAttributeName
- Enabled required TimeToLiveEnabled
TimeToLiveStatus
- TimeToLiveStatus
string
(values: ENABLING, DISABLING, ENABLED, DISABLED)
UntagResourceInput
- UntagResourceInput
object
- ResourceArn required ResourceArnString
- TagKeys required TagKeyList
UpdateExpression
- UpdateExpression
string
UpdateGlobalSecondaryIndexAction
- UpdateGlobalSecondaryIndexAction
object
: Represents the new provisioned throughput settings to be applied to a global secondary index.- IndexName required IndexName
- ProvisionedThroughput required ProvisionedThroughput
UpdateGlobalTableInput
- UpdateGlobalTableInput
object
- GlobalTableName required TableName
- ReplicaUpdates required ReplicaUpdateList
UpdateGlobalTableOutput
- UpdateGlobalTableOutput
object
- GlobalTableDescription GlobalTableDescription
UpdateItemInput
- UpdateItemInput
object
: Represents the input of an UpdateItem operation.- AttributeUpdates AttributeUpdates
- ConditionExpression ConditionExpression
- ConditionalOperator ConditionalOperator
- Expected ExpectedAttributeMap
- ExpressionAttributeNames ExpressionAttributeNameMap
- ExpressionAttributeValues [ExpressionAttri