標記麥西資源

當您建立允許清單、自訂資料識別碼或敏感資料探索任務時，Amazon Macie 主控台會提供將標籤新增至資源的選項。在建立資源時，請遵循主控台上的指示，將標籤新增至這些類型的資源。若要將標籤新增至篩選器或抑制規則或組織中的成員帳號，您必須先建立資源，才能將標籤新增至該資源。

若要使用 Amazon Macie 主控台將一或多個標籤新增至現有資源，請按照下列步驟操作。

若要建立資源並以程式設計方式為其新增一或多個標籤，請針對您要建立的資源類型使用適當的Create作業：

在您的請求中，使用tags參數來為每個要新增至資源的標籤指定標籤鍵 (keyvalue) 和可選標籤值 ()。該tags參數指定string-to-string 標籤鍵及其相關標籤值的映射。

若要將一或多個標籤新增至現有資源，請使用 Amazon Macie 的TagResource作業，API或者，如果您使用的是 AWS CLI，請執行標籤資源命令。在您的請求中，指定要新增標籤的資源的 Amazon 資源名稱 (ARN)。使用tags參數可為每個要新增至資源的標籤指定標籤鍵 (keyvalue) 和選擇性標籤值 ()。與Create操作和命令的情況一樣，該tags參數指定標籤鍵及其關聯標籤值的 string-to-string 映射。

例如，下列 AWS CLI 命令會將含有Stack標籤值的Production標籤鍵加入至指定的工作。此範例針對 Microsoft Windows 進行格式化，並使用脫字符號 (^) 行接續字元來提高可讀性。

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\"}

其中：

在下列範例中，指令會將數個標籤新增至工作：

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\",\"CostCenter\":\"12345\",\"Owner\":\"jane-doe\"}

對於tags地圖中的每個標籤，key和參value數都是必需的。不過，value引數的值可以是空字串。如果您不想將標籤值與標籤鍵建立關聯，請不要指定value引數的值。例如，下列 AWS CLI 命令會加入沒有關聯Owner標籤值的標籤鍵：

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Owner\":\"\"}

如果標記作業成功，Macie 會傳回空的 HTTP 204 回應。否則，Macie 會傳回 HTTP 4 xx 或 500 回應，指出作業失敗的原因。

請依照下列步驟使用 Amazon Macie 主控台檢閱資源的標籤。

若要以程式設計方式擷取和檢閱現有資源的標籤，您可以針對要檢閱標籤的資源類型使用適當的Get或Describe作業。例如，如果您使用GetCustomDataIdentifier作業或從 AWS Command Line Interface (AWS CLI) 執行get-custom-data-identifier命令，則回應會包含一個tags物件。物件會列出目前指派給資源的所有標籤 (包括標籤鍵和標籤值)。

您也可以使用 Amazon Macie API 的ListTagsForResource操作。在您的請求中，使用resourceArn參數來指定資源的 Amazon 資源名稱 (ARN)。如果您使用的是 AWS CLI，請執行list-tags-for-resource命令並使用resource-arn參數來指定資源ARN的。例如：

C:\> aws macie2 list-tags-for-resource --resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample

在前面的例子中,arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample 是現有敏感資料探索工作ARN的。

如果作業成功，Macie 會傳回一個tags物件，列出目前指定給資源的所有標籤 (包括標籤鍵和標籤值)。例如：

{
    "tags": {
        "Stack": "Production",
        "CostCenter": "12345",
        "Owner": ""
    }
}

其中StackCostCenter、和Owner是指派給資源的標籤鍵。 Production是與標籤鍵相關聯的標Stack籤值。 12345是與標籤鍵相關聯的標CostCenter籤值。標Owner籤鍵沒有關聯的標籤值。

若要擷取具有標籤的所有 Macie 資源清單，以及指派給這些資源的所有標籤，請使用「標 AWS Resource Groups 記API」GetResources作業。在您的請求中，將ResourceTypeFilters參數的值設定為macie2。若要使用執行此操作 AWS CLI，請執行 get-resources 命令，並將resource-type-filters參數的值設定為。macie2例如：

C:\> aws resourcegroupstaggingapi get-resources --resource-type-filters "macie2"

如果作業成功，Resource Groups 會傳回一個ResourceTagMappingList陣列，其中包含具有標籤的所有 Macie 資源，以及指派給這些資源的標籤鍵和值。ARNs

請依照下列步驟使用 Amazon Macie 主控台編輯資源的標籤。

當您以程式設計方式編輯資源的標籤時，您可以使用新值覆寫現有標籤。因此，編輯標籤的最佳方式取決於您要編輯標籤鍵、標籤值還是兩者。若要編輯標籤關鍵字，請移除目前的標籤並新增標籤。

若只要編輯或移除與標籤金鑰關聯的標籤值，請使用 Amazon Macie 的TagResource作業覆寫現有值，API或者，如果您使用的是 AWS Command Line Interface (AWS CLI)，則執行標籤資源命令。在您的請求中，指定要編輯或移除其標籤值的資源的 Amazon 資源名稱 (ARN)。

若要編輯標籤關鍵字的標籤值，請使用tags參數指定要變更其標籤值的標籤鍵，並指定鍵的新標籤值。例如，下列命令會Production將指派給指定敏感資料探索工作的Stack標籤索引鍵的標籤值從變更Staging為。此範例針對 Microsoft Windows 進行格式化，並使用脫字符號 (^) 行接續字元來提高可讀性。

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Staging\"}

其中：

若要從標籤鍵移除標籤值，請勿在參數中指定value引tags數的值。例如：

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"\"}

如果操作成功，馬西返回一個空的 HTTP 204 響應。否則，Macie 會傳回 HTTP 4 xx 或 500 回應，指出作業失敗的原因。

請依照下列步驟使用 Amazon Macie 主控台從資源移除一或多個標籤。

若要以程式設計方式從資源中移除一或多個標籤，請使用 Amazon Macie API 的UntagResource操作。在您的請求中，使用resourceArn參數指定要從中移除標籤的資源的 Amazon 資源名稱 (ARN)。使用tagKeys參數指定要移除之標籤的標籤鍵。若只要從資源中移除特定標籤值 (而非標籤鍵)，請編輯標籤，而不要移除標籤。

如果您使用的是 AWS Command Line Interface (AWS CLI)，請執行 untag-resource 命令，並使用resource-arn參數指定要從中移除標籤ARN的資源。使用tag-keys參數指定要移除之標籤的標籤鍵。例如，下列命令會從指定的敏感資料探索工作中移除標Stack籤 (標籤索引鍵和標籤值)：

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack

其中resource-arn指定ARN要從中刪除標籤的作業，並且Stack是要刪除的標籤的標籤鍵。

要從資源中刪除多個標籤，請添加每個額外的標籤鍵作為tag-keys參數的引數。例如：

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack Owner

其中resource-arn指定要從中刪除標籤ARN的作業，Stack並且Owner是要刪除的標籤的標籤鍵。

如果操作成功，馬西返回一個空的 HTTP 204 響應。否則，Macie 會傳回 HTTP 4 xx 或 500 回應，指出作業失敗的原因。