檢閱和編輯 Macie 資源的標籤

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

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

您也可以使用 Amazon Macie API 的 ListTagsForResource 操作。在您的請求中，使用 resourceArn 參數來指定資源的 Amazon Resource Name (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": ""
    }
}

其中 Stack、 CostCenter和 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"

如果操作成功，資源群組會傳回ResourceTagMappingList陣列，其中包含具有標籤的所有 Macie 資源的 ARNs，以及指派給每個資源的標籤索引鍵和值。

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

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

若要編輯或移除與標籤金鑰相關聯的標籤值，請使用 Amazon Macie API 的 TagResource 操作覆寫現有的值。如果您使用的是 AWS Command Line Interface (AWS CLI)，您可以執行 tag-resource 命令來執行此操作。在您的請求中，指定您要編輯或移除其標籤值之資源的 Amazon Resource Name (ARN)。

若要編輯標籤索引鍵的標籤值，請使用 tags 參數來指定您要變更其標籤值的標籤索引鍵，並指定索引鍵的新標籤值。例如，下列命令ProductionStaging會將指派給指定敏感資料探索任務的標籤金鑰的Stack標籤值從 變更為 。此範例已針對 Microsoft Windows 進行格式化，並使用 caret (^) line-contination 字元來改善可讀性。

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

其中：

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

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

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