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

# 標記 Amazon Aurora 全球資料庫資源
<a name="aurora-global-database-tagging"></a>

 使用 Aurora 全球資料庫功能，您可以將 RDS 標籤套用至全球資料庫中不同層級的資源。如果您不熟悉如何將標籤與 AWS 或 Aurora 資源搭配使用，請在全球資料庫中套用標籤之前參閱 [標記 Amazon Aurora 和 Amazon RDS 資源](USER_Tagging.md)。

**注意**  
 由於 AWS 會在成本報告機制中處理標籤資料，因此請勿在標籤名稱或值中包含任何敏感資料或個人身分識別資訊 (PII)。

 您可以將標籤套用至全球資料庫中的下列資源類型：
+  整個全球資料庫的容器物件。此資源稱為全域叢集。

   在主控台中執行**新增 AWS 區域**操作來建立全域叢集之後，您可以使用全域叢集的詳細資訊頁面來新增標籤。在全域叢集詳細資訊頁面的**標籤**索引標籤上，您可以選擇**管理**標籤來新增、移除或修改標籤及其相關聯的值。

   使用 AWS CLI 和 RDS API，您可以同時將標籤新增至全域叢集。您也可以新增、移除或修改現有全域叢集的標籤。
+  主要叢集。您可以在此處使用與獨立 Aurora 叢集相同的標籤程序。您可以在將原始 Aurora 叢集切換為全球資料庫之前設定標籤。您也可以在資料庫叢集詳細資訊頁面的**標籤**索引標籤上選擇**管理標籤**，以新增、移除或修改標籤及其相關聯的值。
+  任何次要叢集。您可以在此處使用與獨立 Aurora 叢集相同的標籤程序。您可以使用主控台中的**新增 AWS 區域**動作，在建立次要 Aurora 叢集的同時設定標籤。您也可以在資料庫叢集詳細資訊頁面的**標籤**索引標籤上選擇**管理標籤**，以新增、移除或修改標籤及其相關聯的值。
+  主要或次要叢集中的個別資料庫執行個體。您可以在此處使用與 Aurora 或 RDS 資料庫執行個體相同的標籤程序。您可以使用主控台中的**新增讀取器**動作，在將新的資料庫執行個體新增至 Aurora 叢集的同時設定標籤。您也可以在資料庫執行個體詳細資訊頁面的標籤索引標籤上選擇**管理標籤**，以新增、移除或修改**標籤**及其相關聯的值。

 以下是您可能在全球資料庫中指派之標籤類型的一些範例：
+  您可以將標籤新增至全域叢集，以記錄應用程式的整體資訊，例如代表組織中擁有者和聯絡人的匿名識別符。您可以使用標籤來表示使用全球資料庫的應用程式屬性。
+  您可以將標籤新增至主要叢集和次要叢集，以在 AWS 區域層級追蹤應用程式的成本。如需該程序的詳細資訊，請參閱 [AWS 帳單如何在 Amazon RDS 中使用標籤](USER_Tagging.md#Tagging.Billing)。
+  您可以使用 Aurora 叢集將標籤新增至特定資料庫執行個體，以指出其特殊用途。例如，在主要叢集中，您可能有一個具有低容錯移轉優先順序的讀取器執行個體，專門用於產生報告。標籤可以區分此特殊用途資料庫執行個體與主要叢集中專用於高可用性的其他執行個體。
+  您可以在全球資料庫資源的所有層級使用標籤，以透過 IAM 政策控制存取。如需詳細資訊，請參閱《*AWS Identity and Access Management 使用者指南*》中的[控制 AWS 資源的存取權](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)。
**提示**  
 在 AWS 管理主控台 中，您可以在建立全域叢集容器之後，作為個別步驟將標籤新增至全域叢集容器。如果您想要避免全域叢集存在而沒有存取控制標籤的任何時間間隔，您可以在 `CreateGlobalCluster` 操作期間透過 AWS CLI、RDS API 或 CloudFormation 範本建立該資源來套用標籤。
+  您可以在叢集層級或全域叢集使用標籤，記錄應用程式品質保證和測試的相關資訊。例如，您可以在資料庫叢集上指定標籤，以記錄您上次執行切換到該叢集的時間。您可以在全域叢集上指定標籤，以記錄整個應用程式上次災難復原演練的時間。

## 全球資料庫的標記 AWS CLI 範例
<a name="aurora-global-database-tagging-cli-examples"></a>

 下列 AWS CLI 範例示範如何指定和檢查全球資料庫中所有類型 Aurora 資源的標籤。

 您可以使用 `create-global-cluster` 命令指定全域叢集容器的標籤。下列範例會建立全域叢集，並為其指派兩個標籤。標籤具有索引鍵 `tag1` 和 `tag2`。

```
$  aws rds create-global-cluster --global-cluster-identifier my_global_cluster_id \
  --engine aurora-mysql --tags Key=tag1,Value=val1 Key=tag2,Value=val2
```

 您可以使用 `describe-global-clusters` 命令列出全域叢集容器上的標籤。使用標籤時，您通常會先執行此命令，以擷取全域叢集的 Amazon Resource Name (ARN)。您可以在後續命令中使用 ARN 作為參數，以搭配使用標籤。下列命令會在 `TagList` 屬性中顯示標籤資訊。它也會顯示在稍後範例中用作參數的 ARN。

```
$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            "GlobalClusterArn": "my_global_cluster_arn",
            ...
            "TagList": [
                {
                    "Value": "val1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                }
            ]
        }
    ]
}
```

 您可以使用 `add-tags-to-resource` 命令新增標籤。使用此命令，您可以指定全域叢集的 Amazon Resource Name (ARN)，而不是其識別符。新增與現有標籤具有相同名稱的標籤，將會覆寫該標籤的值。如果您在標籤值中包含空格或特殊字元，請根據您的作業系統或命令 shell 引用適當的值。下列範例會修改先前範例中全域叢集的標籤。最初，叢集具有包含索引鍵 `tag1` 和 `tag2` 的標籤。命令完成後，全域叢集具有包含索引鍵 `tag3` 的新標籤，而包含索引鍵 `tag1` 的標籤具有不同的值。

```
$  aws rds add-tags-to-resource --resource-name my_global_cluster_arn \
  --tags Key=tag1,Value="new value for tag1" Key=tag3,Value="entirely new tag"

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                },
                {
                    "Value": "entirely new tag",
                    "Key": "tag3"
                }
            ]
        }
    ]
}
```

 您可以使用 `remove-tags-from-resource` 命令從全域叢集刪除標籤。使用此命令，您只需指定一組標籤索引鍵，不需要任何標籤值。下列範例會修改先前範例中全域叢集的標籤。最初，叢集具有包含索引鍵 `tag1`、`tag2` 和 `tag3` 的標籤。命令完成後，只會保留具有索引鍵 `tag1` 的標籤。

```
$  aws rds remove-tags-from-resource --resource-name my_global_cluster_arn --tag-keys tag2 tag3

$  aws rds describe-global-clusters --global-cluster-identifier my_global_cluster_id
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                }
            ]
        }
    ]
}
```