Macie リソースのタグ付け

許可リスト、カスタムデータ識別子、または機密データ検出ジョブを作成すると、Amazon Macie コンソールにはリソースにタグを追加するためのオプションが表示されます。リソースを作成するときは、コンソールの指示に従ってこれらのタイプのリソースにタグを追加します。フィルタルール、抑制ルール、または組織のメンバーアカウントにタグを追加するには、タグを追加する前にリソースを作成する必要があります。

Amazon Macie コンソールを使用して既存のリソースに 1 つ以上のタグを追加するには、次のステップに従います。

リソースを作成して 1 つ以上のタグをプログラムで追加するには、作成するリソースのタイプに適したCreate操作を使用します。

リクエストでは、tagsパラメータを使用して、リソースに追加する各タグのタグキー (key) とオプションのタグ値 (value) を指定します。tags パラメータは、タグキーとそれに関連するタグ値のstring-to-string マップを指定します。

既存のリソースに 1 つ以上のタグを追加するには、Amazon Macie の TagResourceオペレーションを使用するAPIか、 を使用している場合は AWS CLI tag-resource コマンドを実行します。リクエストで、タグを追加するリソースの Amazon リソースネーム (ARN) を指定します。tags パラメータを使用して、リソースに追加する各タグのタグキーkeyとオプションのタグ値valueを指定します。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 は空の 204 HTTP レスポンスを返します。それ以外の場合、Macie HTTP はオペレーションが失敗した理由を示す 4xx または 500 レスポンスを返します。

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

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

Amazon Macie の ListTagsForResourceオペレーションを使用することもできますAPI。リクエストでは、 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 タグ付け の GetResourcesオペレーションを使用しますAPI。リクエストでは、ResourceTypeFilters パラメータの値を macie2 に設定します。を使用してこれを行うには AWS CLI、get-resources コマンドを実行し、 resource-type-filtersパラメータの値を に設定しますmacie2。例:

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

オペレーションが成功すると、Resource Groups は、タグを持つすべての Macie リソースARNsの と、それらの各リソースに割り当てられたタグキーと値を含むResourceTagMappingList配列を返します。

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

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

タグキーに関連付けられているタグ値のみを編集または削除するには、Amazon Macie の TagResourceオペレーションを使用するAPIか、 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 は空の 204 HTTP レスポンスを返します。それ以外の場合、Macie HTTP はオペレーションが失敗した理由を示す 4xx または 500 レスポンスを返します。

Amazon Macie コンソールを使用して、リソースから 1 つ以上のタグを削除するには、次のステップに従います。

リソースから 1 つ以上のタグをプログラムで削除するには、Amazon Macie の UntagResourceオペレーションを使用しますAPI。リクエストでは、 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は削除するタグのタグキーです。

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