本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 將標籤新增至 DynamoDB 中的資源
您可以使用 *tags* 來標示 Amazon DynamoDB 資源。標籤可讓您以不同的方式分類您的資源，例如依據目的、所有者、環境或其他條件。標籤可協助您執行以下作業：
+ 根據您指派給資源的標籤來快速識別資源。
+ 請參閱依標籤細分的 AWS 帳單。
**注意**
任何與標記資料表相關的本機次要索引 (LSI) 和全域次要索引 (GSI) 都會自動標上相同的標籤。目前無法標記 DynamoDB Streams 使用量。
Amazon EC2、Amazon S3、DynamoDB 等 AWS 服務支援標記。有效標記可讓您跨帶有特定標籤的服務來建立報告，以提供成本深入資訊。
若要開始使用標記，請執行以下操作：
1. 了解 [DynamoDB 中的標記限制](#TaggingRestrictions)。
1. 使用 [在 DynamoDB 中標記資源](Tagging.Operations.md) 建立標籤。
1. 使用 [使用 DynamoDB 標籤建立成本分配報告](#CostAllocationReports) 追蹤每個作用中標籤 AWS 的成本。
最後，最好遵循最佳標記策略。如需相關資訊，請參閱 [AWS 標記策略](https://d0.awsstatic.com/aws-answers/AWS_Tagging_Strategies.pdf)。
## DynamoDB 中的標記限制
每個標記皆包含由您定義的索引鍵和值。適用以下限制：
+ 每個 DynamoDB 資料表都只能有一個具有相同索引鍵的標籤。若您嘗試新增現有的標籤 (相同索引鍵)，現有標籤的值會更新為新的值。
+ 標籤鍵與值皆區分大小寫。
+ 鍵長度上限為 128 個 Unicode 字元。
+ 值長度上限為 256 個 Unicode 字元。
+ 允許的字元為字母、空格和數字，以及下列特殊字元：`+ - = . _ : /`
+ 每一資源標籤數最多為 50。
+ 資料表中所有標籤支援的大小上限為 10 KB。
+ AWS指派的標籤名稱和值會自動指派您無法指派的`aws:`字首。 AWS指派的標籤名稱不會計入標籤限制 50 或 10 KB 的大小上限。使用者指派的標籤名稱在成本分配報告中具有字首 `user:`。
+ 標籤的套用不可回溯。
# 在 DynamoDB 中標記資源
您可以使用 Amazon DynamoDB 主控台或 AWS Command Line Interface (AWS CLI) 來新增、列出、編輯或刪除標籤。然後，您可以啟動這些使用者定義的標籤，讓它們出現在 AWS 帳單與成本管理 主控台中，以便追蹤成本配置。如需詳細資訊，請參閱[使用 DynamoDB 標籤建立成本分配報告](Tagging.md#CostAllocationReports)。
您也可以使用 AWS 管理主控台上的標籤編輯器進行大量編輯。如需詳細資訊，請參閱[使用標籤編輯器](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html)。
若要改用 DynamoDB API，請參閱《[Amazon DynamoDB API 參考](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/)》中的下列操作：
+ [TagResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UntagResource.html)
+ [ListTagsOfResource](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListTagsOfResource.html)
**Topics**
+ [設定依標籤篩選的許可](#Tagging.Operations.permissions)
+ [將標籤新增至新的或現有資料表 (AWS 管理主控台)](#Tagging.Operations.using-console)
+ [將標籤新增至新的或現有資料表 (AWS CLI)](#Tagging.Operations.using-cli)
## 設定依標籤篩選的許可
若要使用標籤篩選 DynamoDB 主控台中的資料表清單，請確定使用者的政策包含對下列操作的存取權：
+ `tag:GetTagKeys`
+ `tag:GetTagValues`
您可以依照下列步驟，將新的 IAM 政策連接至使用者，以便存取這些操作。
1. 使用管理員使用者前往 [IAM 主控台](https://console.aws.amazon.com/iam/)。
1. 在左導覽選單中，選取 Policies (政策)。
1. 選取 Create Policy (建立政策)。
1. 將下列政策貼入至 JSON 編輯器。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"tag:GetTagKeys",
"tag:GetTagValues"
],
"Resource": "*"
}
]
}
```
------
1. 完成協助程式並指派政策的名稱 (例如 `TagKeysAndValuesReadAccess`)。
1. 在左側導覽選單中，選擇 Users (使用者)。
1. 從清單中選取您通常用於存取 DynamoDB 主控台的使用者。
1. 選取 Add permissions (新增許可)。
1. 選取 Attach existing policies directly (直接連接現有政策)。
1. 從清單中選取您先前建立的政策。
1. 完成協助程式。
## 將標籤新增至新的或現有資料表 (AWS 管理主控台)
您可以使用 DynamoDB 主控台，在建立新資料表時在其中新增標籤，或為現有的資料表新增、編輯或刪除標籤。
**在建立時為資源加上標籤 (主控台)**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/) 開啟 DynamoDB 主控台。
1. 在導覽窗格中，選擇 **Tables** (資料表)，然後選擇 **Create table** (建立資料表)。
1. 在 **Create DynamoDB table** (建立 DynamoDB 資料表) 頁面上，提供名稱和主索引鍵。在 **Tags** (標籤) 區段中，選擇 **Add new tag** (新增標籤)，然後輸入您要使用的標籤。
如需標籤結構的相關資訊，請參閱 [DynamoDB 中的標記限制](Tagging.md#TaggingRestrictions)。
如需建立資料表的詳細資訊，請參閱 [DynamoDB 資料表上的基本操作](WorkingWithTables.Basics.md)。
**為現有的資源加上標籤 (主控台)**
請在 [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/) 開啟 DynamoDB 主控台。
1. 在導覽窗格中，選擇 **Tables** (資料表)。
1. 在清單中選擇資料表，然後選擇 **Additional settings** (其他設定) 索引標籤。您可以新增、編輯或刪除 **Tags** (標籤) 頁面底部的區段。
## 將標籤新增至新的或現有資料表 (AWS CLI)
下列範例示範如何在建立資料表和索引時，使用 AWS CLI 指定標籤，以及標記現有資源。
**在建立時為資源加上標籤 (AWS CLI)**
+ 以下範例會建立新 `Movies` 資料表並使用 `blueTeam` 值來新增 `Owner` 標籤：
```
aws dynamodb create-table \
--table-name Movies \
--attribute-definitions AttributeName=Title,AttributeType=S \
--key-schema AttributeName=Title,KeyType=HASH \
--provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
--tags Key=Owner,Value=blueTeam
```
**為現有的資源加上標籤 (AWS CLI)**
+ 以下範例會為 `Movies` 資料表新增 `blueTeam` 值的 `Owner` 標籤：
```
aws dynamodb tag-resource \
--resource-arn arn:aws:dynamodb:us-east-1:123456789012:table/Movies \
--tags Key=Owner,Value=blueTeam
```
**列出資料表的所有標籤 (AWS CLI)**
+ 以下範例列出與 `Movies` 資料表相關聯的所有標籤：
```
aws dynamodb list-tags-of-resource \
--resource-arn arn:aws:dynamodb:us-east-1:123456789012:table/Movies
```
## 使用 DynamoDB 標籤建立成本分配報告
AWS 使用標籤來整理成本分配報告中的資源成本。 AWS 提供兩種類型的成本分配標籤：
+ AWS產生的 tag. AWS defines、建立和套用此標籤。
+ 使用者定義的標籤。您可以定義、建立和套用這些標籤。
您必須分別啟用這兩種標籤，它們才會顯示在 Cost Explorer 或成本分配報告中。
若要啟用 AWS產生的標籤：
1. 登入 AWS 管理主控台 並開啟 Billing and Cost Management 主控台，網址為 [https：//https://console.aws.amazon.com/billing/home\$1/。](https://console.aws.amazon.com/billing/home#/.)
1. 在導覽窗格中，選擇 **Cost Allocation Tags** (成本分配標籤)。
1. 在 **AWS-Generated Cost Allocation Tags** (AWS產生的成本分配標籤) 下，選擇 **Activate** (啟用)。
若要啟用使用者定義的標籤：
1. 登入 AWS 管理主控台 並開啟 Billing and Cost Management 主控台，網址為 [https：//https://console.aws.amazon.com/billing/home\$1/。](https://console.aws.amazon.com/billing/home#/.)
1. 在導覽窗格中，選擇 **Cost Allocation Tags** (成本分配標籤)。
1. 在 **User-Defined Cost Allocation Tags** (使用者定義的成本分配標籤) 下，選擇 **Activate** (啟用)。
在您建立和啟用標籤後， AWS 會產生成本分配報告，其中包含依作用中標籤分組的用量和成本。成本分配報告包含每個帳單期間的所有 AWS 成本。該報告同時包含有標籤和沒標籤的資源，以便您可清楚地整理資源的費用。
**注意**
目前，從 DynamoDB 傳出的任何資料都不會在成本分配報告上依標籤細分。
如需詳細資訊，請參閱[使用成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。