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

# AWS Database Migration Service 中的標記資源
<a name="CHAP_Tagging"></a>

您可以在 AWS Database Migration Service (AWS DMS) 中使用標籤，將中繼資料新增至資源。此外，您可以使用這些標籤搭配 AWS Identity and Access Management (IAM) 政策來管理對 AWS DMS 資源的存取，以及控制哪些動作可以套用至 AWS DMS 資源。最後，您可以使用這些標籤將類似的標記資源分類為群組以追蹤成本。

所有 AWS DMS 資源都可以標記：
+ 憑證
+ 資料提供者
+ 資料遷移
+ 端點
+ 事件訂閱
+ 執行個體設定檔
+ 遷移專案
+ 複寫執行個體
+ 複寫子網路群組
+ 複寫任務

DMS AWS 標籤是您定義並與 AWS DMS 資源建立關聯的名稱值對。此名稱叫做金鑰。為金鑰提供值是選用的。您可以使用標籤將任意資訊指派給 AWS DMS 資源。例如，您可以使用標籤鍵來定義類別，而標籤值則為該類別中的項目。例如，您可以定義 "project" 的標籤索引鍵和 "Salix" 的標籤值，表示 AWS DMS 資源已指派給 Salix 專案。您也可以使用 environment=test AWS 或 environment =production 等金鑰，使用標籤將 DMS 資源指定為用於測試或生產。我們建議您使用一組一致的標籤金鑰，以更輕鬆地追蹤與 AWS DMS 資源相關聯的中繼資料。

使用標籤來整理 AWS 帳單，以反映您自己的成本結構。若要這樣做，請註冊以取得包含標籤索引鍵值的 AWS 帳戶 帳單。接著，若要查看合併資源的成本，請根據具有相同標籤鍵值的資源來整理您的帳單資訊。例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊以查看該應用程式跨數項服務的總成本。如需詳細資訊，請參閱《AWS Billing 》**使用者指南中的[使用成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。

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

AWS 不會將任何語意意義套用至您的標籤；標籤會嚴格解譯為字元字串。 AWS DMS 可能會在 AWS DMS 資源上設定標籤，取決於您在建立資源時使用的設定。

下列清單說明 DMS AWS 標籤的特性。
+ 標籤金鑰是標籤必要的名稱。字串值長度可以是 1 到 128 個 Unicode 字元，不可在前面加上 "aws:" 或 "dms:"。字串只能包含一組 Unicode 字母、數字、空格、'\$1'、'.'、'/'、'='、'\$1'、'-' (Java regex：`"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`)。
+ 標籤值即為選用的標籤字串值，字串值長度可以是 1 到 256 個 Unicode 字元，不可在前面加上 "aws:" 或 "dms:"。字串只能包含一組 Unicode 字母、數字、空格、'\$1'、'.'、'/'、'='、'\$1'、'-' (Java regex：`"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`)。

  標籤組中的值不必是唯一的，並且可以是 null。例如，在 project/Trinity 及 cost-center/Trinity 標籤集中，均能擁有一個索引鍵/值組。

您可以使用 AWS CLI 或 AWS DMS API 來新增、列出和刪除 AWS DMS 資源上的標籤。使用 AWS CLI 或 AWS DMS API 時，您必須為要使用的 AWS DMS 資源提供 Amazon Resource Name (ARN)。如需建構 ARN 的詳細資訊，請參閱 [建構 的 Amazon Resource Name (ARN) AWS DMS](CHAP_Introduction.AWS.ARN.md)。

請注意，標籤會進行快取，以供授權使用。因此，在 AWS DMS 資源上新增和更新標籤可能需要幾分鐘的時間才能使用。

## API
<a name="CHAP_Tagging.API"></a>

您可以使用 DMS API 新增、列出或移除 AWS AWS DMS 資源的標籤。
+ 若要將標籤新增至 AWS DMS 資源，請使用 [https://docs.aws.amazon.com/dms/latest/APIReference/API_AddTagsToResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_AddTagsToResource.html)操作。
+ 若要列出指派給 DMS 資源的標籤，請使用 AWS [https://docs.aws.amazon.com/dms/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_ListTagsForResource.html)操作。
+ 若要從 AWS DMS 資源移除標籤，請使用 [https://docs.aws.amazon.com/dms/latest/APIReference/API_RemoveTagsFromResource.html](https://docs.aws.amazon.com/dms/latest/APIReference/API_RemoveTagsFromResource.html)操作。

若要進一步了解如何建構必要的 ARN，請參閱[建構 的 Amazon Resource Name (ARN) AWS DMS](CHAP_Introduction.AWS.ARN.md)。

使用 DMS API AWS 使用 XML 時，標籤使用以下結構描述：

```
<Tagging>
  <TagSet>
  	<Tag>
  		<Key>Project</Key>
  		<Value>Trinity</Value>
  	</Tag>
  	<Tag>
  		<Key>User</Key>
  		<Value>Jones</Value>
  	</Tag>
  </TagSet>
</Tagging>
```

下表列出允許的 XML 標籤及其特性。請注意，Key 和 Value 的值皆區分大小寫。例如，project=Trinity 與 PROJECT=Trinity 是兩個不同的標籤。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/dms/latest/userguide/CHAP_Tagging.html)