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

# 許可リストの変更
<a name="allow-lists-change"></a>

許可リストを作成したら、Amazon Macie のリスト設定のほとんどを変更できます。例えば、リストの名前と説明を変更できます。リストのタグを追加および編集することもできます。変更できない設定はリストのタイプだけです。例えば、既存のリストで正規表現 (*regex*) が指定されている場合、そのタイプを事前定義済みのテキストに変更することはできません。

許可リストに定義済みのテキストが指定されている場合は、リスト内のエントリを変更することもできます。これを行うには、エントリが含まれているファイルを更新します。次に、新しいバージョンのファイルを Amazon Simple Storage Service (Amazon S3) にアップロードします。Macie が次にリストを使用する準備をするときに、Macie は Amazon S3 からファイルの最新バージョンを取得します。新しいファイルをアップロードするときは、必ず同じ S3 バケットとオブジェクトに保存してください。または、バケットまたはオブジェクトの名前を変更した場合は、必ず Macie のリストの設定を更新してください。

**許可リストの設定を変更するには**  
Amazon Macie コンソールまたは Amazon Macie API を使用して、許可リストの設定を変更できます。



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

Amazon Macie コンソールを使用して許可リストの設定を変更するには、次のステップに従います。

**コンソールを使用して許可リストの設定を変更するには**

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

1. ナビゲーションペインで **設定** の **リスト** を選択します。

1. **[許可リスト]** ページで、変更する許可リストの名前を選択します。許可リストページが開き、リストの現在の設定が表示されます。

1. 許可リストのタグを割り当てまたは編集するには、**[タグ]** セクションで、**[タグを管理]** を選択します。次に、必要に応じてタグを変更します。終了したら、**保存** を選択します。

1. 許可リストの他の設定を変更するには、**[リスト設定]**セクションで **[編集]**を選択します。次に、必要に応じて設定を変更してください。
   + **名前** — リストの新しい名前を入力します。名前には最大 128 文字を含めることができます。
   + **説明** — リストの新しい説明を入力します。説明には最大 512 文字を含めることができます。
   + 許可リストに定義済みのテキストが指定されている場合:
     + **S3 バケット名** – リストを保存するバケットの名前を入力します。

       Amazon S3 では、この値はバケットのプロパティの **[名前]** フィールドにあります。この値では、大文字と小文字が区別されます。また、ワイルドカード文字を使用したり、名前に部分的な値を指定したりしないでください。
     + **S3 オブジェクト名** – リストを保存する S3 オブジェクトの名前を入力します。

       Amazon S3 では、この値はオブジェクトのプロパティの **[キー]**フィールドにあります。名前にパスが含まれる場合は、名前を入力するときにたとえば **allowlists/macie/mylist.txt** のように、完全なパスを含めます。この値では、大文字と小文字が区別されます。また、ワイルドカード文字を使用したり、名前に部分的な値を指定したりしないでください。
   + 許可リストに正規表現(*正規表現*)が指定されている場合は、**[正規表現]** ボックスに新しい正規表現を入力します。正規表現には最大 512 文字を含めることができます。

     新しい regex を入力したら、必要に応じてテストします。これを行うには、最大 1,000 文字のテキストを **サンプルデータ** ボックスに入力し、次に **送信** を選択します。Macie はサンプルデータを評価し、検出基準に一致するテキストの出現回数をレポートします。正規表現を調整して最適化してから変更を保存するために、このステップを何回でも繰り返すことができます。

1. 完了したら、**保存** を選択します。

Macie はリストの設定をテストします。定義済みのテキストのリストについては、Macie は Amazon S3 からリストを取得してリストの内容を解析できるかどうかも確認します。regex の場合、Macie は表現をコンパイルできるかどうかも確認します。エラーが発生した場合は、エラーを説明するメッセージ。エラーのトラブルシューティングに役立つ詳細情報は[許可リストの設定オプションと要件](allow-lists-options.md)を参照してください。エラーを解決したら、変更を保存できます。

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

許可リストの設定をプログラムで変更するには、Amazon Macie API の [UpdateAllowList](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists-id.html) オペレーションを使用します。または、 を使用している場合は AWS CLI、[update-allow-list](https://docs.aws.amazon.com/cli/latest/reference/macie2/update-allow-list.html) コマンドを実行します。リクエストでは、サポートされているパラメータを使用して、変更する設定ごとに新しい値を指定します。`criteria`、`id`、および `name` パラメータが必要なことに注意してください。必須パラメータの値を変更したくない場合は、パラメータの現在の値を指定します。

たとえば、次のコマンドでは、既存の許可リストの名前と説明を変更します。この例は Microsoft Windows 用にフォーマットされており、読みやすさを向上させるためにキャレット (^) の行連結文字を使用します。

```
C:\> aws macie2 update-allow-list ^
--id {{km2d4y22hp6rv05example}} ^
--name {{my_allow_list-email}} ^
--criteria={\"regex\":\"{{[a-z]@example.com}}\"} ^
--description "{{Ignores all email addresses for the example.com domain}}"
```

コードの説明は以下のとおりです。
+ {{km2d4y22hp6rv05example}} はリストの一意の識別子です。
+ {{my\_allow\_list-email}} はリストの新しい名前です。
+ {{a-z@example .com}} はリストの基準、正規表現です。
+ リストの新しい説明である {{example.com ドメインのメールアドレスをすべて無視します}}。

リクエストを送信すると、Macie はリストの設定をテストします。リストに定義済みのテキスト (`s3WordsList`) が指定されている場合、これには Macie が Amazon S3 からリストを取得し、リストのコンテンツを解析できるかどうかの検証も含まれます。リストに regex (`regex`) が指定されている場合は、Macie が表現をコンパイルできるかどうかの検証も含まれます。

Macie が設定をテストしたときにエラーが発生した場合、リクエストは失敗し、Macie はエラーを説明するメッセージを返します。エラーのトラブルシューティングに役立つ詳細情報は[許可リストの設定オプションと要件](allow-lists-options.md)を参照してください。別の理由でリクエストが失敗した場合、Macie は HTTP 4xx またはオペレーションが失敗した理由を示す 500 レスポンスを返します。

リクエストが成功すると、Macie はリストの設定を更新し、次のような出力を受け取ります。

```
{
    "arn": "arn:aws:macie2:us-west-2:123456789012:allow-list/km2d4y22hp6rv05example",
    "id": "km2d4y22hp6rv05example"
}
```

ここで、`arn` は、更新された許可リストの Amazon リソースネーム (ARN)で、`id` は、リストの一意の識別子です

------