本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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 政策連接至使用者，以便存取這些操作。

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 管理主控台)
<a name="Tagging.Operations.using-console"></a>

您可以使用 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)
<a name="Tagging.Operations.using-cli"></a>

下列範例示範如何在建立資料表和索引時，使用 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
  ```