本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 標記 Amazon DocumentDB 資源
您可以使用 Amazon DocumentDB （具有 MongoDB 相容性） 標籤，將中繼資料新增至 Amazon DocumentDB 資源。這些標籤可與 AWS Identity and Access Management (IAM) 政策搭配使用，以管理對 Amazon DocumentDB 資源的存取，並控制哪些動作可以套用至資源。您也可以使用標籤將類似的標記資源分類為群組以追蹤成本。
您可以標記下列 Amazon DocumentDB 資源：
+ 叢集
+ 執行個體
+ 快照
+ 叢集快照
+ 參數群組
+ 叢集參數群組
+ 安全群組
+ 子網路群組
## Amazon DocumentDB 資源標籤概觀
Amazon DocumentDB 標籤是您定義並與 Amazon DocumentDB 資源建立關聯的名稱值對。此名稱叫做*金鑰*。為金鑰提供值是選用的。您可以使用標籤將任意資訊指派給 Amazon DocumentDB 資源。例如，您可以使用標籤金鑰來定義類別，此標籤值可以是該類別中的項目。例如，您可以定義 的標籤索引鍵`project`和 的標籤值`Salix`，表示 Amazon DocumentDB 資源已指派給 Salix 專案。您也可以使用 標籤，使用 `environment=test`或 等金鑰，將 Amazon DocumentDB 資源指定為用於測試或生產`environment=production`。我們建議您使用一組一致的標籤金鑰，以更輕鬆地追蹤與 Amazon DocumentDB 資源相關聯的中繼資料。
您可以使用標籤來整理 AWS 帳單，以反映您自己的成本結構。若要執行此操作，請註冊 以取得包含標籤索引鍵值的 AWS 帳戶 帳單。接著，若要查看合併資源的成本，請根據具有相同標籤鍵值的資源來整理您的帳單資訊。例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊以查看該應用程式跨數項服務的總成本。如需詳細資訊，請參閱《帳單和成本管理使用者指南》中的[使用成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
每個 Amazon DocumentDB 資源都有一個標籤集，其中包含指派給該資源的所有標籤。標籤集最多可以包含 10 個標籤，也可以是空的。如果您將標籤新增至 Amazon DocumentDB 資源，而該資源上的金鑰與現有標籤相同，則新值會覆寫舊值。
AWS 不會將任何語意意義套用至您的標籤；標籤會嚴格解譯為字元字串。Amazon DocumentDB 可以在執行個體或其他 Amazon DocumentDB 資源上設定標籤，取決於您在建立資源時使用的設定。例如，Amazon DocumentDB 可能會新增標籤，指出執行個體用於生產或測試。
您可以將標籤新增至快照，但是您的帳單將不會反映這個分組。
您可以使用 AWS 管理主控台 或 AWS CLI 來新增、列出和刪除 Amazon DocumentDB 資源上的標籤。使用 時 AWS CLI，您必須提供您要使用的資源的 Amazon Resource Name (ARN)。如需 Amazon DocumentDB ARNs的詳細資訊，請參閱 [了解 Amazon DocumentDB Amazon Resource Name (ARNs)](documentdb-arns.md)。
## 標籤限制條件
下列限制條件適用於 Amazon DocumentDB 標籤：
+ 每個資源的標籤數量上限 - 10
+ **Key (索引鍵)** 長度上限 - 128 個 Unicode 字元
+ **Value (值)** 長度上限 - 256 個 Unicode 字元
+ **Key (索引鍵)** 和 **Value (值)** 的有效字元 - UTF-8 字元集中的大小寫字母、數字、空格和以下字元：`_ . : / = + -` 和 `@` (Java regex：`"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`)
+ 標籤鍵與值皆區分大小寫。
+ 不要將 `aws:` 字首用於標籤索引鍵或值；它保留供 AWS使用。
## 在 Amazon DocumentDB 資源上新增和更新標籤
您可以使用 AWS 管理主控台 或 將最多 10 個標籤新增至資源 AWS CLI。
------
#### [ Using the AWS 管理主控台 ]
無論您要將標籤新增至何種資源，將標籤新增至資源的程序都很相似。在此範例中，將標籤新增至叢集。
**若要使用主控台將標籤新增至叢集或更新標籤**
1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)：// 開啟 Amazon DocumentDB 主控台。
1. 從導覽窗格選擇 **clusters (叢集)**。
1. 選擇您要新增標籤至其中的叢集名稱。
1. 向下捲動到 **Tags (標籤)** 區段，然後選擇 **Edit (編輯)**。
1. 對於您要新增至此資源的每個標籤，執行以下操作：
1. 若要新增新標籤，請在 **Key (索引鍵)** 方塊中輸入標籤的名稱。若要變更標籤的值，請在 **Key (索引鍵)** 欄中尋找標籤的名稱。
1. 若要給予標籤新值或更新其值，請在 **Value (值)** 方塊中輸入標籤的值。
1. 如果您想新增更多標籤，請選擇 **Add (新增)**。否則，於完成時選擇 **Save (儲存)**。
------
#### [ Using the AWS CLI ]
無論您要將標籤新增至何種資源，將標籤新增至資源的程序都很相似。在此範例中，將三個標籤新增至叢集。第二個標籤 `key2` 沒有值。
將 AWS CLI 操作`add-tags-to-resource`與這些參數搭配使用。
**參數**
+ **--resource-name**- 您要新增標籤的 Amazon DocumentDB 資源 ARN。
+ **--tags**- 以 格式列出您要新增至此資源的標籤 （鍵/值對）`Key=key-name,Value=tag-value`。
**Example**
若為 Linux、macOS 或 Unix：
```
aws docdb add-tags-to-resource \
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3
```
針對 Windows：
```
aws docdb add-tags-to-resource ^
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3
```
`add-tags-to-resource` 操作不會產生輸出。若要查看操作的結果，請使用 `list-tags-for-resource` 操作。
------
## 列出 Amazon DocumentDB 資源上的標籤
您可以使用 AWS 管理主控台 或 AWS CLI 來取得 Amazon DocumentDB 資源的標籤清單。
------
#### [ Using the AWS 管理主控台 ]
無論您要將標籤新增至何種資源，在資源上列出標籤的程序都很相似。在此範例中，列出叢集的標籤。
**使用主控台列出叢集標籤**
1. 在 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)：// 開啟 Amazon DocumentDB 主控台。
1. 從導覽窗格選擇 **clusters (叢集)**。
1. 選擇您要列出其標籤的叢集名稱。
1. 若要查看此資源上的標籤清單，請向下捲動至 **Tags (標籤)** 區段。
------
#### [ Using the AWS CLI ]
無論您要列出何種資源的標籤，在資源上列出標籤的程序都很相似。在此範例中，列出叢集上的標籤。
將 AWS CLI 操作`list-tags-for-resource`與這些參數搭配使用。
**參數**
+ **--resource-name** - 必要項目。您要列出標籤之 Amazon DocumentDB 資源的 ARN。
**Example**
若為 Linux、macOS 或 Unix：
```
aws docdb list-tags-for-resource \
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster
```
針對 Windows：
```
aws docdb list-tags-for-resource ^
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster
```
此操作的輸出將會如下所示 (JSON 格式)。
```
{
"TagList": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": ""
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
------
## 從 Amazon DocumentDB 資源移除標籤
您可以使用 AWS 管理主控台 或 從 Amazon DocumentDB 資源 AWS CLI 移除標籤。
------
#### [ Using the AWS 管理主控台 ]
無論您要將標籤新增至何種資源，從資源中移除標籤的程序都很相似。在此範例中，從叢集中移除標籤。
**使用主控台將標籤從叢集中移除**
1. 在 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)：// 開啟 Amazon DocumentDB 主控台。
1. 從導覽窗格選擇 **clusters (叢集)**。
1. 選擇您要從中移除標籤的叢集名稱。
1. 向下捲動到 **Tags (標籤)** 區段，然後選擇 **Edit (編輯)**。
1. 如果您要移除此資源的所有標籤，請選擇 **Remove all (全部移除)**。否則，針對您要從此資源中移除的每個標籤，執行以下操作：
1. 在 **Key (索引鍵)** 欄中尋找標籤的名稱。
1. 在標籤索引鍵的同一列上選擇 **Remove (移除)**。
1. 完成時，選擇**儲存**。
------
#### [ Using the AWS CLI ]
無論您要從何種資源中移除標籤，從資源中移除標籤的程序都很相似。在此範例中，從叢集中移除標籤。
將 AWS CLI 操作`remove-tags-from-resource`與這些參數搭配使用。
+ **--resource-name** - 必要項目。您要從中移除標籤的 Amazon DocumentDB 資源 ARN。
+ **--tag-keys** - 必要項目。您要從資源中移除的標籤索引鍵清單。
**Example**
若為 Linux、macOS 或 Unix：
```
aws docdb remove-tags-from-resource \
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tag-keys key1 key3
```
針對 Windows：
```
aws docdb remove-tags-from-resource ^
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tag-keys key1 key3
```
`removed-tags-from-resource` 操作不會產生輸出。若要查看操作的結果，請使用 `list-tags-for-resource` 操作。
------