# DynamoDB Table

## Resource Type

`AWS.DynamoDB.Table`

## Resource ID Format

For DynamoDB Tables, the resource ID is the ARN.

`arn:aws:dynamodb:us-east-2:123456789012:table/example-table`

## Background

This resource represents a snapshot of an AWS DynamoDB Table.

## Fields

<table data-header-hidden><thead><tr><th width="300.37282229965155">Field</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td><code>AttributeDefinitions</code></td><td><code>List</code></td><td>Attributes that describe the key schema for the table and indexes.</td></tr><tr><td><code>BillingModeSummary</code></td><td><code>Map</code></td><td>The details for the read/write capacity mode.</td></tr><tr><td><code>GlobalSecondaryIndexes</code></td><td><code>List</code></td><td>The global secondary indexes.</td></tr><tr><td><code>ItemCount</code></td><td><code>Integer</code></td><td>The number of items in the specified table.</td></tr><tr><td><code>KeySchema</code></td><td><code>List</code></td><td>The primary key structure for the table.</td></tr><tr><td><code>LatestStreamArn</code></td><td><code>String</code></td><td>The ARN that uniquely identifies the latest stream for this table.</td></tr><tr><td><code>LatestStreamLabel</code></td><td><code>String</code></td><td>A timestamp, in ISO 8601 format, for this stream.</td></tr><tr><td><code>LocalSecondaryIndexes</code></td><td><code>List</code></td><td>One or more local secondary indexes on the table.</td></tr><tr><td><code>ProvisionedThroughput</code></td><td><code>Map</code></td><td>The provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.</td></tr><tr><td><code>RestoreSummary</code></td><td><code>Map</code></td><td>Details for the restore.</td></tr><tr><td><code>SSEDescription</code></td><td><code>Map</code></td><td>The description of the server-side encryption status on the specified table.</td></tr><tr><td><code>StreamSpecification</code></td><td><code>Map</code></td><td>The current DynamoDB Streams configuration for the table.</td></tr><tr><td><code>TableSizeBytes</code></td><td><code>Integer</code></td><td>The total size of the specified table, in bytes.</td></tr><tr><td><code>TableStatus</code></td><td><code>String</code></td><td>The current state of the table</td></tr><tr><td><code>AutoScalingDescriptions</code></td><td><code>List</code></td><td>Details on how dynamically adjusting provisioned throughput capacity in response to traffic patterns is configured</td></tr><tr><td><code>TimeToLiveDescription</code></td><td><code>Map</code></td><td>The description of the Time to Live (TTL) status on the specified table.</td></tr></tbody></table>

## Example

```javascript
{
    "AccountId": "123456789012",
    "Arn": "arn:aws:dynamodb:us-east-2:123456789012:table/example-table",
    "AttributeDefinitions": [
        {
            "AttributeName": "Attribute1",
            "AttributeType": "S"
        }
    ],
    "AutoScalingDescriptions": [
        {
            "CreationTime": "2019-01-01T00:00:00Z",
            "MaxCapacity": 40000,
            "MinCapacity": 5,
            "ResourceId": "table/example-table",
            "RoleARN": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable",
            "ScalableDimension": "dynamodb:table:ReadCapacityUnits",
            "ServiceNamespace": "dynamodb",
            "SuspendedState": {
                "DynamicScalingInSuspended": false,
                "DynamicScalingOutSuspended": false,
                "ScheduledScalingSuspended": false
            }
        },
        {
            "CreationTime": "2019-01-01T00:00:00Z",
            "MaxCapacity": 40000,
            "MinCapacity": 5,
            "ResourceId": "table/example-table",
            "RoleARN": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable",
            "ScalableDimension": "dynamodb:table:WriteCapacityUnits",
            "ServiceNamespace": "dynamodb",
            "SuspendedState": {
                "DynamicScalingInSuspended": false,
                "DynamicScalingOutSuspended": false,
                "ScheduledScalingSuspended": false
            }
        }
    ],
    "BillingModeSummary": null,
    "GlobalSecondaryIndexes": null,
    "Id": "1111-2222",
    "ItemCount": 0,
    "KeySchema": [
        {
            "AttributeName": "Attribute1",
            "KeyType": "HASH"
        }
    ],
    "LatestStreamArn": "arn:aws:dynamodb:us-east-2:123456789012:table/example-table/stream/2019-01-01T00:00:00.000",
    "LatestStreamLabel": "2019-01-01T00:00:00.000",
    "LocalSecondaryIndexes": null,
    "Name": "example-table",
    "ProvisionedThroughput": {
        "LastDecreaseDateTime": null,
        "LastIncreaseDateTime": null,
        "NumberOfDecreasesToday": 0,
        "ReadCapacityUnits": 5,
        "WriteCapacityUnits": 5
    },
    "Region": "us-east-2",
    "ResourceId": "arn:aws:dynamodb:us-east-2:123456789012:table/example-table",
    "ResourceType": "AWS.DynamoDB.Table",
    "RestoreSummary": null,
    "SSEDescription": null,
    "StreamSpecification": {
        "StreamEnabled": true,
        "StreamViewType": "NEW_AND_OLD_IMAGES"
    },
    "TableSizeBytes": 0,
    "TableStatus": "ACTIVE",
    "Tags": null,
    "TimeCreated": "2019-01-01T00:00:00.000Z",
    "TimeToLiveDescription": {
        "AttributeName": null,
        "TimeToLiveStatus": "DISABLED"
    }
}
```