標記 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 專案。您也可以使用標籤，透過使用金鑰 (例如或)，將 Amazon DocumentDB 資源指定為environment=test用於測試或生產。environment=production我們建議您使用一組一致的標籤金鑰，以便更輕鬆地追蹤與 Amazon DocumentDB 資源相關聯的中繼資料。

您可以使用標籤來組織帳 AWS 單，以反映自己的成本結構。要做到這一點，註冊以獲取包含標籤鍵值的 AWS 帳戶 帳單。接著，若要查看合併資源的成本，請根據具有相同標籤鍵值的資源來整理您的帳單資訊。例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊以查看該應用程式跨數項服務的總成本。如需詳細資訊，請參閱《帳單和成本管理使用者指南》中的使用成本分配標籤。

每個 Amazon DocumentDB 資源都有一個標籤集，其中包含指派給該資源的所有標籤。標籤集最多可以包含 10 個標籤，也可以是空的。如果您將標籤新增至 Amazon DocumentDB 資源，該資源的金鑰與資源上的現有標籤具有相同的金鑰，則新值會覆寫舊值。

AWS 不會將任何語義意義應用於您的標籤; 標籤嚴格解釋為字符串。Amazon DocumentDB 可以根據您在建立資源時使用的設定，在執行個體或其他 Amazon DocumentDB 資源上設定標籤。例如，Amazon DocumentDB 可能會新增一個標籤，指出執行個體用於生產或進行測試。

您可以將標籤新增至快照，但是您的帳單將不會反映這個分組。

您可以使用 AWS Management Console 或 AWS CLI 來新增、列出和刪除 Amazon DocumentDB 資源上的標籤。使用時 AWS CLI，您必須為您要使用的資源提供 Amazon 資源名稱 (ARN)。如需有關亞馬遜文件資料庫的詳細資訊ARNs，請參閱。了解 Amazon DocumentDB Amazon 資源名稱（）ARNs

標籤約束

下列限制適用於 Amazon DocumentDB 標籤：

• 每個資源的標籤數上限-10

• Key (索引鍵) 長度上限 - 128 個 Unicode 字元

• Value (值) 長度上限 - 256 個 Unicode 字元

• 鍵和值的有效字符-UTF -8 個字符集中的大寫和小寫字母，數字，空格以及以下字符：_ . : / = + -和@（Java 正則表達式："^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"）

• 標籤鍵與值皆區分大小寫。

• 不要將 aws: 字首用於標籤索引鍵或值；它保留供 AWS使用。

在 Amazon DocumentDB 資源上添加和更新標籤

您最多可以使用 AWS Management Console 或將 10 個標籤新增至資源 AWS CLI。

Using the AWS Management Console

無論您要將標籤新增至何種資源，將標籤新增至資源的程序都很相似。在此範例中，將標籤新增至叢集。

若要使用主控台將標籤新增至叢集或更新標籤

1. 登入 AWS Management Console，然後在 https://console.aws.amazon.com/docdb 開啟 Amazon DocumentDB 主控台。

2. 從導覽窗格選擇 clusters (叢集)。

3. 選擇您要新增標籤至其中的叢集名稱。

4. 向下捲動到 Tags (標籤) 區段，然後選擇 Edit (編輯)。

5. 對於您要新增至此資源的每個標籤，執行以下操作：

   1. 若要新增新標籤，請在 Key (索引鍵) 方塊中輸入標籤的名稱。若要變更標籤的值，請在 Key (索引鍵) 欄中尋找標籤的名稱。

   2. 若要給予標籤新值或更新其值，請在 Value (值) 方塊中輸入標籤的值。

   3. 如果您想新增更多標籤，請選擇 Add (新增)。否則，於完成時選擇 Save (儲存)。

Using the AWS CLI

無論您要將標籤新增至何種資源，將標籤新增至資源的程序都很相似。在此範例中，將三個標籤新增至叢集。第二個標籤 key2 沒有值。

add-tags-to-resource搭配這些參數使用此 AWS CLI 作業。

參數

• --resource-name您要新增標籤ARN的亞馬遜文件資料庫資源的。

• --tags— 以格Key=key-name,Value=tag-value式列出要新增至此資源的標籤 (鍵值配對)。

若為 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 Management Console 或 AWS CLI 來取得標籤的清單 Amazon DocumentDB 資源。

Using the AWS Management Console

無論您要將標籤新增至何種資源，在資源上列出標籤的程序都很相似。在此範例中，列出叢集的標籤。

使用主控台列出叢集標籤

1. 打開 Amazon DocumentDB 控制台 https://console.aws.amazon.com/docdb。

2. 從導覽窗格選擇 clusters (叢集)。

3. 選擇您要列出其標籤的叢集名稱。

4. 若要查看此資源上的標籤清單，請向下捲動至 Tags (標籤) 區段。

Using the AWS CLI

無論您要列出何種資源的標籤，在資源上列出標籤的程序都很相似。在此範例中，列出叢集上的標籤。

list-tags-for-resource搭配這些參數使用此 AWS CLI 作業。

參數

• --resource-name - 必要項目。要列出標籤ARN的 Amazon DocumentDB 資源的。

若為 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 Management Console 或從 Amazon DocumentDB 資源中刪除標籤。 AWS CLI

Using the AWS Management Console

無論您要將標籤新增至何種資源，從資源中移除標籤的程序都很相似。在此範例中，從叢集中移除標籤。

使用主控台將標籤從叢集中移除

1. 打開 Amazon DocumentDB 控制台 https://console.aws.amazon.com/docdb。

2. 從導覽窗格選擇 clusters (叢集)。

3. 選擇您要從中移除標籤的叢集名稱。

4. 向下捲動到 Tags (標籤) 區段，然後選擇 Edit (編輯)。

5. 如果您要移除此資源的所有標籤，請選擇 Remove all (全部移除)。否則，針對您要從此資源中移除的每個標籤，執行以下操作：

   1. 在 Key (索引鍵) 欄中尋找標籤的名稱。

   2. 在標籤索引鍵的同一列上選擇 Remove (移除)。

   3. 完成時，選擇儲存。

Using the AWS CLI

無論您要從何種資源中移除標籤，從資源中移除標籤的程序都很相似。在此範例中，從叢集中移除標籤。

remove-tags-from-resource搭配這些參數使用此 AWS CLI 作業。

• --resource-name - 必要項目。要從ARN中刪除標籤的 Amazon DocumentDB 資源。

• --tag-keys - 必要項目。您要從資源中移除的標籤索引鍵清單。

若為 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 操作。