# Managing encrypted tables in DynamoDB
You can use the Amazon Web Services Management Console or the Amazon Command Line Interface (Amazon CLI) to specify the encryption key on new tables and update the encryption keys on existing tables in Amazon DynamoDB.
**Topics**
+ [Specifying the encryption key for a new table](#encryption.tutorial-creating)
+ [Updating an encryption key](#encryption.tutorial-update)
## Specifying the encryption key for a new table
Follow these steps to specify the encryption key on a new table using the Amazon DynamoDB console or the Amazon CLI.
### Creating an encrypted table (console)
1. Sign in to the Amazon Web Services Management Console and open the DynamoDB console at [https://console.amazonaws.cn/dynamodb/](https://console.amazonaws.cn/dynamodb/).
1. In the navigation pane on the left side of the console, choose **Tables**.
1. Choose **Create Table**. For the **Table name**, enter **Music**. For the primary key, enter **Artist**, and for the sort key, enter **SongTitle**, both as strings.
1. In **Settings**, make sure that **Customize settings** is selected.
**Note**
If **Use default settings** is selected, tables are encrypted at rest with the Amazon owned key at no additional cost.
1. Under **Encryption at rest**, choose an encryption type - Amazon owned key, Amazon managed key, or customer managed key.
+ **Owned by Amazon DynamoDB.** Amazon owned key, specifically owned and managed by DynamoDB. You are not charged an additional fee for using this key.
+ **Amazon managed key**. Key alias: `aws/dynamodb`. The key is stored in your account and is managed by Amazon Key Management Service (Amazon KMS). Amazon KMS charges apply.
+ **Stored in your account, and owned and managed by you.** Customer managed key. The key is stored in your account and is managed by Amazon Key Management Service (Amazon KMS). Amazon KMS charges apply.
**Note**
If you select to own and manage your own key, make sure the KMS Key Policy is appropriately set. For more information including examples, see [ Key policy for a customer managed key](https://docs.amazonaws.cn/kms/latest/developerguide/concepts.html#customer-cmk).
1. Choose **Create table** to create the encrypted table. To confirm the encryption type, select the table details on the **Overview** tab and review the **Additional details** section.
### Creating an encrypted table (Amazon CLI)
Use the Amazon CLI to create a table with the default Amazon owned key, the Amazon managed key, or a customer managed key for Amazon DynamoDB.
**To create an encrypted table with the default Amazon owned key**
+ Create the encrypted `Music` table as follows.
```
aws dynamodb create-table \
--table-name Music \
--attribute-definitions \
AttributeName=Artist,AttributeType=S \
AttributeName=SongTitle,AttributeType=S \
--key-schema \
AttributeName=Artist,KeyType=HASH \
AttributeName=SongTitle,KeyType=RANGE \
--provisioned-throughput \
ReadCapacityUnits=10,WriteCapacityUnits=5
```
**Note**
This table is now encrypted using the default Amazon owned key in the DynamoDB service account.
**To create an encrypted table with the Amazon managed key for DynamoDB**
+ Create the encrypted `Music` table as follows.
```
aws dynamodb create-table \
--table-name Music \
--attribute-definitions \
AttributeName=Artist,AttributeType=S \
AttributeName=SongTitle,AttributeType=S \
--key-schema \
AttributeName=Artist,KeyType=HASH \
AttributeName=SongTitle,KeyType=RANGE \
--provisioned-throughput \
ReadCapacityUnits=10,WriteCapacityUnits=5 \
--sse-specification Enabled=true,SSEType=KMS
```
The `SSEDescription` status of the table description is set to `ENABLED` and the `SSEType` is `KMS`.
```
"SSEDescription": {
"SSEType": "KMS",
"Status": "ENABLED",
"KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234",
}
```
**To create an encrypted table with a customer managed key for DynamoDB**
+ Create the encrypted `Music` table as follows.
```
aws dynamodb create-table \
--table-name Music \
--attribute-definitions \
AttributeName=Artist,AttributeType=S \
AttributeName=SongTitle,AttributeType=S \
--key-schema \
AttributeName=Artist,KeyType=HASH \
AttributeName=SongTitle,KeyType=RANGE \
--provisioned-throughput \
ReadCapacityUnits=10,WriteCapacityUnits=5 \
--sse-specification Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234
```
**Note**
For the `KMSMasterKeyId`, you can use a key ID, key ARN, or key alias. If you use a key alias (for example, `alias/my-key`), DynamoDB resolves the alias and associates the underlying Amazon KMS key with the table. In the table description, the `KMSMasterKeyArn` will always show the key ARN of the resolved key, not the alias. For more information about key identifiers, see [Key identifiers (KeyId)](https://docs.amazonaws.cn/kms/latest/developerguide/concepts.html#key-id) in the *Amazon Key Management Service Developer Guide*.
The `SSEDescription` status of the table description is set to `ENABLED` and the `SSEType` is `KMS`.
```
"SSEDescription": {
"SSEType": "KMS",
"Status": "ENABLED",
"KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234",
}
```
## Updating an encryption key
You can also use the DynamoDB console or the Amazon CLI to update the encryption keys of an existing table between an Amazon owned key, Amazon managed key, and customer managed key at any time.
### Updating an encryption key (console)
1. Sign in to the Amazon Web Services Management Console and open the DynamoDB console at [https://console.amazonaws.cn/dynamodb/](https://console.amazonaws.cn/dynamodb/).
1. In the navigation pane on the left side of the console, choose **Tables**.
1. Choose the table that you want to update.
1. Select the **Actions** dropdown, and then select the **Update settings** option.
1. Go to the **Additional settings** tab.
1. Under **Encryption**, choose **Manage encryption**.
1. Choose an encryption type:
+ **Owned by Amazon DynamoDB.** The Amazon KMS key is owned and managed by DynamoDB. You are not charged an additional fee for using this key.
+ **Amazon managed key** Key alias: `aws/dynamodb`. The key is stored in your account and is managed by Amazon Key Management Service. (Amazon KMS). Amazon KMS charges apply.
+ **Stored in your account, and owned and managed by you.** The key is stored in your account and is managed by Amazon Key Management Service. (Amazon KMS). Amazon KMS charges apply.
**Note**
If you select to own and manage your own key, make sure the KMS Key Policy is appropriately set. For more information see [ Key policy for a customer managed key](https://docs.amazonaws.cn/kms/latest/developerguide/concepts.html#customer-cmk).
Then choose **Save** to update the encrypted table. To confirm the encryption type, check the table details under the **Overview** tab.
### Updating an encryption key (Amazon CLI)
The following examples show how to update an encrypted table using the Amazon CLI.
**To update an encrypted table with the default Amazon owned key**
+ Update the encrypted `Music` table, as in the following example.
```
aws dynamodb update-table \
--table-name Music \
--sse-specification Enabled=false
```
**Note**
This table is now encrypted using the default Amazon owned key in the DynamoDB service account.
**To update an encrypted table with the Amazon managed key for DynamoDB**
+ Update the encrypted `Music` table, as in the following example.
```
aws dynamodb update-table \
--table-name Music \
--sse-specification Enabled=true
```
The `SSEDescription` status of the table description is set to `ENABLED` and the `SSEType` is `KMS`.
```
"SSEDescription": {
"SSEType": "KMS",
"Status": "ENABLED",
"KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234",
}
```
**To update an encrypted table with a customer managed key for DynamoDB**
+ Update the encrypted `Music` table, as in the following example.
```
aws dynamodb update-table \
--table-name Music \
--sse-specification Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234
```
**Note**
For the `KMSMasterKeyId`, you can use a key ID, key ARN, or key alias. If you use a key alias (for example, `alias/my-key`), DynamoDB resolves the alias and associates the underlying Amazon KMS key with the table. In the table description, the `KMSMasterKeyArn` will always show the key ARN of the resolved key, not the alias.
The `SSEDescription` status of the table description is set to `ENABLED` and the `SSEType` is `KMS`.
```
"SSEDescription": {
"SSEType": "KMS",
"Status": "ENABLED",
"KMSMasterKeyArn": "arn:aws:kms:us-east-1:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234",
}
```