在 AWS Database Migration Service 中標記資源 - AWS Database Migration Service
API

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

在 AWS Database Migration Service 中標記資源

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

所有 AWS DMS 資源皆可加上標籤：

  • 憑證

  • 資料提供者

  • 資料遷移

  • 端點

  • 事件訂閱

  • 執行個體設定檔

  • 遷移專案

  • 複寫執行個體

  • 複寫子網路群組

  • 複寫任務

AWS DMS 標籤是由您定義的名稱/值組，且其與 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 不會將任何語意套用至您的標籤；標籤將嚴格解釋為字元字串。AWSDMS 可在 AWS DMS 資源上設定標籤，具體取決於您建立資源時所使用的設定。

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

  • 標籤金鑰是標籤必要的名稱。字串值長度可以是 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 資源名稱（ARN） AWS DMS。

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

API

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

若要進一步了解如何建構必要的 ARN，請參閱構建 Amazon 資源名稱（ARN） AWS DMS。

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

<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 資源的所有標籤。每個資源只能有一個標籤集。此外，您僅能透過 AWS DMS API 來使用 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 標籤集中，均能擁有一個索引鍵/值組。