

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Macie リソースにタグを追加する
<a name="tags-add"></a>

**タグは、特定のタイプの Amazon Macie リソースなど AWS リソースを定義して割り当てることができるラベルです。タグを使用すると、目的、所有者、環境、その他の条件など、さまざまな方法でリソースを識別、分類、管理できます。例えば、タグを使用してポリシーを適用したり、コストを割り当てたり、リソースのバージョンを区別したり、特定のコンプライアンス要件やワークフローをサポートするリソースを識別したりできます。

以下のタイプの Macie リソースにタグを追加できます。
+ 許可リスト
+ カスタムデータ識別子
+ 検出結果のフィルタールールと抑制ルール
+ 機密データ検出ジョブ

お客様が組織の Macie 管理者である場合、組織のメンバーアカウントにタグを割り当てることもできます。

リソースには、最大 50 個のタグを含めることができます。各タグは、必要なタグキー**とオプションのタグ値**で設定されています。*タグキー* は、より具体的なタグ値のカテゴリとして動作する一般的なラベルです。*タグ値*は、タグキーの記述子として機能します。タグ付けのオプションおよび要件の詳細は、「[タグ付けの基本](tags-basics.md)」を参照してください。

Macie リソースにタグを追加するには、複数の方法があります。Macie を直接使用できます。 AWS Resource Groups コンソールのタグエディタ、またはタグ付け API の AWS Resource Groups タグ付けオペレーションを使用することもできます。 AWS Resource Groups は、 AWS リソースを個別ではなく 1 つのユニットとしてグループ化および管理できるように設計されています。Macie を使用すると、リソースを作成するとき、リソースにタグを追加できます。また、個々の既存リソースにタグを追加することもできます。を使用すると AWS Resource Groups、Macie AWS のサービスを含む複数の にまたがる複数の既存のリソースにタグを一括で追加できます。

**Macie リソースにタグを追加するには**  
個々の Macie リソースにタグを追加するには、Amazon Macie コンソールまたは Amazon Macie API を使用します。複数の Macie リソースにタグを同時に追加するには、 AWS Resource Groups コンソールまたは AWS Resource Groups Tagging API を使用します。詳細については「[AWS リソースのタグ付けのユーザーガイド](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)」を参照してください。

**重要**  
リソースにタグを追加すると、リソースへのアクセスに影響を与える可能性があります。リソースにタグを追加する前に、タグを使用してリソースへのアクセスを制御する可能性のある AWS Identity and Access Management (IAM) ポリシーを確認してください。詳細については、「*IAM ユーザーガイド*」の「[タグを使用した AWS リソースへのアクセスのコントロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)」を参照してください。

------
#### [ Console ]

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

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

**リソースにタグを追加**

1. Amazon Macie コンソール ([https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)) を開きます。

1. タグを追加するリソースのタイプに応じて、以下のいずれかを実行します。
   + 許可リストについては、ナビゲーションペインで **許可リスト** を選択します。テーブルで、リストのチェックボックスをオンにします。次に、**[アクション]** メニューで **[タグを管理]** を選択します。
   + カスタムデータ識別子の場合は、ナビゲーションペインの **[カスタムデータ識別子]** を選択します。テーブルで、カスタムデータ識別子のチェックボックスをオンにします。次に、**[アクション]** メニューで **[タグを管理]** を選択します。
   + フィルタまたは抑制ルールについては、ナビゲーションペインで **[検出結果]** を選択します。**[保存されたルール]** リストで、ルールの横にある編集アイコン (![\[The edit icon, which is a blue pencil.\]](http://docs.aws.amazon.com/ja_jp/macie/latest/user/images/icon-edit-resource-blue.png)) を選択します。次に、**タグを管理** を選択します。
   + 組織のメンバーアカウントについては、ナビゲーションペインで **[アカウント]** を選択します。テーブルで、アカウントのチェックボックスをオンにします。次に、**[アクション]** メニューで **[タグを管理]** を選択します。
   + 機密データ検出ジョブについては、ナビゲーションペインで **[ジョブ]** を選択します。テーブルで、ジョブのチェックボックスをオンにします。次に、**[アクション]** メニューで **[タグを管理]** を選択します。

   **[タグを管理]** ウィンドウには、現在リソースに割り当てられているタグがすべて一覧表示されます。

1. **[タグを管理]** ウィンドウで **[タグの編集]** を選択します。

1. **タグを追加** を選択します。

1. **[キー]** ボックスに、リソースに追加するタグ用のタグキーを入力します。次に、**[値]** ボックスに、任意でキーのタグ値を入力します。

   タグキーには最大 128 文字を含めることができます。タグ値は最大 256 文字を含めることができます。文字には、文字、数字、スペース、または記号 ( \$1 . : / = \$1 - @) を使用できます。

1. リソースに別のタグを追加するには、**[タグの追加]** を選択し、前のステップを繰り返します。1 つのリソースには、最大 50 個のタグを割り当てることができます。

1. タグの追加を完了したら、**保存** を選択します。

------
#### [ API ]

リソースを作成して 1 つ以上のタグをプログラムで追加するには、作成するリソースのタイプに適した`Create`操作を使用します。
+ **許可リスト** – [CreateAllowList](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists.html) オペレーションを使用します。または、 AWS Command Line Interface (AWS CLI) を使用する場合は、[create-allow-list](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-allow-list.html) コマンドを実行します。
+ **カスタムデータ識別子** – [CreateCustomDataIdentifier](https://docs.aws.amazon.com/macie/latest/APIReference/custom-data-identifiers.html) オペレーションを使用します。または、 を使用している場合は AWS CLI、[create-custom-data-identifier](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-custom-data-identifier.html) コマンドを実行します。
+ **フィルターまたは抑制ルール** – [CreateFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters.html) オペレーションを使用します。または、 AWS CLIを使用する場合は、[create-findings-filter](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-findings-filter.html) コマンドを実行します。
+ **メンバーアカウント** – [CreateMember](https://docs.aws.amazon.com/macie/latest/APIReference/members.html) オペレーションを使用します。または、 を使用している場合は AWS CLI、[create-member](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-member.html) コマンドを実行します。
+ **機密データ検出ジョブ** – [CreateClassificationJob](https://docs.aws.amazon.com/macie/latest/APIReference/jobs.html) オペレーションを使用します。または、 を使用している場合は AWS CLI、[create-classification-job](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-classification-job.html) コマンドを実行します。

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

既存のリソースに 1 つ以上のタグを追加するには、Amazon Macie API の [TagResource](https://docs.aws.amazon.com/macie/latest/APIReference/tags-resourcearn.html) オペレーションを使用するか、 を使用している場合は [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/macie2/tag-resource.html) コマンド AWS CLIを実行します。リクエストでは、タグを追加するリソースの Amazon リソースネーム (ARN) を指定します。`tags` パラメータを使用して、リソースに追加する各タグのタグキー`key`とオプションのタグ値`value`を指定します。`Create` オペレーションやコマンドの場合と同様に、`tags` パラメータはタグキーとそれに関連するタグ値の文字列間マップを指定します。

たとえば、次の 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\"}
```

コードの説明は以下のとおりです。
+ `resource-arn` はタグを追加するジョブの ARN を指定します。
+ `Stack` はジョブに追加するタグのタグキーです。
+ `Production` は指定されたタグキー`Stack`のタグ値です。

次の例では、コマンドはジョブに複数のタグを追加します。

```
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 レスポンスを返します。

------