Macie リソースのタグを確認して編集する

Amazon Macie コンソールを使用してリソースのタグを確認するには、次のステップに従います。

既存のリソースのタグをプログラムで取得して確認するには、タグを確認するリソースのタイプに適切な Get または Describe オペレーションを使用します。例えば、GetCustomDataIdentifierオペレーションを使用するか、 AWS Command Line Interface AWS CLIからget-custom-data-identifierコマンドを実行する場合、レスポンスには tags オブジェクトが含まれます。このオブジェクトには、現在リソースに割り当てられているすべてのタグ (タグキーとタグ値の両方) が一覧表示されます。

また、Amazon Macie API のListInvitationsオペレーションを使用することもできます。リクエストでは、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": ""
    }
}

ここでStack、CostCenter、Ownerは、リソースに割り当てられるタグキーです。 Productionは、Stackタグキーに関連付けられているタグ値です。 12345は、CostCenterタグキーに関連付けられているタグ値です。Ownerタグキーには、関連するタグ値はありません。

タグを持つすべての Macie リソースと、それらの各リソースに割り当てられたすべてのタグのリストを取得するには、 AWS Resource Groups Tagging API の GetResources オペレーションを使用します。リクエストでは、ResourceTypeFilters パラメータの値を macie2 に設定します。を使用してこれを行うには AWS CLI、get-resources コマンドを実行し、 resource-type-filtersパラメータの値を に設定しますmacie2。以下に例を示します。

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

オペレーションが正常に実行されると、リソースグループは、タグを持つすべての Macie リソースの ARN と、それらの各リソースに割り当てられているタグキーと値を含む ResourceTagMappingList 配列を返します。

Amazon Macie コンソールを使用してリソースのタグを編集するには、次のステップに従います。

リソースのタグをプログラムで編集すると、既存のタグが新しい値に上書きされます。したがって、タグを編集する最適な方法は、タグキー、タグ値、またはその両方を編集するかどうかによって異なります。タグキーを編集するには、現在のタグを削除して[新しいタグを追加]します。

タグキーに関連付けられているタグ値のみを編集または削除するには、Amazon Macie API の TagResource オペレーションを使用して既存の値を上書きします。 AWS Command Line Interface （AWS CLI) を使用している場合は、tag-resource コマンドを実行してこれを行うことができます。リクエストでは、タグ値を編集または削除するリソースの Amazon リソースネーム (ARN) を指定します。

タグキーのタグ値を編集するには、tags パラメータを使用してタグ値を変更するタグキーを指定し、そのキーに新しいタグ値を指定します。例えば、次のコマンドは、特定の機密データ検出ジョブに関連付けられている Production タグキーのタグ値を Staging から Stack に変更します。この例は 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\":\"\"}

オペレーションが正常に実行されると、Macie は空の HTTP 204 レスポンスを返します。それ以外の場合、Macie は HTTP 4xx またはオペレーションが失敗した理由を示す 500 レスポンスを返します。