AWS Database Migration Service 中的標記資源 - AWS 資料庫遷移服務
API

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

AWS Database Migration Service 中的標記資源

您可以使用 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 或 environment =production 等金鑰，使用標籤將 AWS DMS 資源指定為用於測試或生產。我們建議您使用一組一致的標籤金鑰，以更輕鬆地追蹤與 AWS DMS 資源相關聯的中繼資料。

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

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

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

下列清單說明 DMS AWS 標籤的特性。

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

  • 標籤值即為選用的標籤字串值，字串值長度可以是 1 到 256 個 Unicode 字元，不可在前面加上 "aws:" 或 "dms:"。字串只能包含一組 Unicode 字母、數字、空格、'_'、'.'、'/'、'='、'+'、'-' (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。

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

API

您可以使用 AWS DMS API 新增、列出或移除 AWS DMS 資源的標籤。

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

使用 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 是兩個不同的標籤。

標記元素 描述
TagSet 標籤集是一個容器，其中存放指派給 Amazon RDS 資源的所有標籤。每個資源只能有一個標籤集。您只能透過 DMS API AWS 使用 TagSet。
標籤 標籤是使用者定義的鍵值組。標籤集內可以有 1 到 10 個標籤。
金錀

鍵是標籤的必要名稱。字串值長度可以是 1 到 128 個 Unicode 字元，不可在前面加上 "dms:" 或 "aws:"。字串只能包含一組 Unicode 字母、數字、空格、'_'、'.'、'/'、'='、'+'、'-' (Java regex："^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。

鍵在標籤集內必須是唯一的。舉例來說，標籤集不能擁有索引鍵相同，但值不同的索引鍵組，例如：project/Trinity 和 project/Xanadu。
Value

值是標籤的選用值。字串值長度可以是 1 到 256 個 Unicode 字元，不可在前面加上 "dms:" 或 "aws:"。字串只能包含一組 Unicode 字母、數字、空格、'_'、'.'、'/'、'='、'+'、'-' (Java regex："^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")。

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