# 在 DynamoDB 中为资源添加标签
<a name="Tagging.Operations"></a>

您可以使用 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)

## 设置按标签筛选的权限
<a name="Tagging.Operations.permissions"></a>

要在 DynamoDB 控制台中使用标签筛选表列表，请确保用户的策略包括对以下操作的访问权限：
+ `tag:GetTagKeys`
+ `tag:GetTagValues`

您可以通过按照以下步骤，向您的用户附加新的 IAM policy 来访问这些操作。

1. 以管理员用户身份登录 [IAM 控制台](https://console.aws.amazon.com/iam/)。

1. 在左侧导航菜单中，选择“策略”。

1. 选择“创建策略”。

1. 将以下策略粘贴到 JSON 编辑器中。

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "tag:GetTagKeys",
                   "tag:GetTagValues"
               ],
               "Resource": "*"
           }
       ]
   }
   ```

------

1. 完成向导并为策略指定名称（例如，`TagKeysAndValuesReadAccess`）。

1. 在左侧导航菜单中，选择“用户”。

1. 从该列表中选择您通常用于访问 DynamoDB 控制台的用户。

1. 选择“添加权限”。

1. 选择“直接附加现有策略”。

1. 从列表中选择您之前创建的策略。

1. 完成向导。

## 将标签添加到新的或现有的表 (AWS 管理控制台)
<a name="Tagging.Operations.using-console"></a>

您可以使用 DynamoDB 控制台在创建新表时在表中添加标签，或添加、编辑或删除现有表的标签。

**在创建时标记资源（控制台）**

1. 登录 AWS 管理控制台，打开 DynamoDB 控制台：[https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)。

1. 在导航窗格中，选择 **Tables (表)**，然后选择 **Create table (创建表)**。

1. 在 **Create DynamoDB table (创建 DynamoDB 表)** 页面上，提供名称和主键。在 **Tags (标签)** 部分，选择 **Add new tag (添加新标签)**，然后输入要使用的标签。

   有关标签结构的信息，请参阅 [DynamoDB 中的标签限制](Tagging.md#TaggingRestrictions)。

   有关创建表的更多信息，请参阅 [针对 DynamoDB 表的基本操作](WorkingWithTables.Basics.md)。

**标记现有资源（控制台）**

打开 DynamoDB 控制台：[https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)。

1. 在导航窗格中，选择**表**。

1. 选择列表中的表，然后选择 **Additional settings (其他设置)** 选项卡。在页面底部的 **Tags(标签)** 部分中，可以添加、编辑或删除标签。

## 将标签添加到新的或现有的表 (AWS CLI)
<a name="Tagging.Operations.using-cli"></a>

以下示例说明了如何在创建表和索引时使用 AWS CLI 指定标签以及标记现有的资源。

**在创建时标记资源 (AWS CLI)**
+ 以下示例创建一个新的 `Movies` 表，并添加具有 `Owner` 值的 `blueTeam` 标签：

  ```
  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)**
+ 以下示例为 `Owner` 表添加具有 `blueTeam` 值的 `Movies` 标签：

  ```
  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
  ```