翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 非同期ジョブによる PII エンティティの編集 (API)
テキスト内の PII エンティティを編集するには、非同期バッチジョブを開始します。ジョブを実行するには、Amazon S3 に文書をアップロードし、[StartPIIEntitiesDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartPiiEntitiesDetectionJob.html) リクエストを送信します。
**Topics**
+ [開始する前に](#redact-pii-before)
+ [入力パラメータ](#redact-pii-api-inputs)
+ [出力ファイル形式](#redact-pii-api-outputs)
+ [を使用した PII 秘匿化 AWS Command Line Interface](#redact-pii-api-cli)
## 開始する前に
始める前に、次の有無を確認します。
+ **入出力バケット** — 入力ファイルと出力ファイルに使用する Amazon S3 バケットを識別します。バケットは、呼び出す API と同じリージョンに存在している必要があります。
+ **IAM サービスロール** — 入出力バケットにアクセス許可を持つ IAM サービスロールが必要です。詳細については、「[バッチ操作に必要なロールベースのアクセス許可](security_iam_id-based-policy-examples.md#auth-role-permissions)」を参照してください。
## 入力パラメータ
リクエストには次のパラメータを含めます。
+ `InputDataConfig` — リクエストにジョブの入力プロパティを含む [InputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_InputDataConfig.html) 定義を示します。`S3Uri` パラメータには、入力文書の Amazon S3 の場所を指定します。
+ `OutputDataConfig` — リクエストにジョブの入力プロパティを含む [OutputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_OutputDataConfig.html) 定義を示します。`S3Uri`パラメータには、Amazon Comprehend が分析結果を書き込む Amazon S3 の場所を指定します。
+ `DataAccessRoleArn` - AWS Identity and Access Management ロールの Amazon リソースネーム (ARN) を示します。このロールは、Amazon Comprehend S3 内の入力データに対する読み取りアクセス権と出力場所への書き込みアクセス権を付与します。詳細については、「[バッチ操作に必要なロールベースのアクセス許可](security_iam_id-based-policy-examples.md#auth-role-permissions)」を参照してください。
+ `Mode` — このパラメータを `ONLY_REDACTION` に設定します。この設定では、Amazon Comprehend は入力文書のコピーを Amazon S3 の出力場所に書き込みます。このコピーでは、各 PII エンティティが編集されます。
+ `RedactionConfig` — 編集用の設定パラメータを含む、リクエスト用の [RedActionConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_RedactionConfig.html) 定義を指定します。編集する PII タイプを指定し、各 PII エンティティをその種類の名前と任意の文字に置き換えるかどうかを指定します。
+ 編集する PII エンティティタイプを `PiiEntityTypes` 配列に指定します。すべてのエンティティタイプを編集するには、配列の値を `["ALL"]` に設定します。
+ 各 PII エンティティをそのタイプに置き換えるには、`MaskMode`パラメータを `REPLACE_WITH_PII_ENTITY_TYPE` に設定します。たとえば、この設定では、PII エンティティ「Jane Doe」が「[NAME]」に置き換えられます。
+ 各 PII エンティティの文字を任意の文字に置き換えるには、`MaskMode` パラメータを `MASK` に設定し、`MaskCharacter` パラメータを置換文字に設定します。1 文字のみ指定してください。有効な文字は \!、\#、$、%、&、\*、@ です。たとえば、この設定では、PII エンティティ「Jane Doe」が「\*\*\*\* \*\*\*」に置き換えられます。
+ `LanguageCode` – このパラメータを `en`または に設定します`es`。Amazon Comprehend は、英語またはスペイン語のテキストでの PII 検出をサポートしています。
## 出力ファイル形式
次の例は、PII を編集する分析ジョブの入力ファイルと出力ファイルを示しています。入力の形式は、行ごとにドキュメント 1 つです。
```
{
Managing Your Accounts Primary Branch Canton John Doe Phone Number 443-573-4800 123 Main StreetBaltimore, MD 21224
Online Banking HowardBank.com Telephone 1-877-527-2703 Bank 3301 Boston Street, Baltimore, MD 21224
```
この入力ファイルを編集する分析ジョブは、次の出力ファイルを生成します。
```
{
Managing Your Accounts Primary Branch ****** ******** Phone Number ************ **********************************
Online Banking ************** Telephone ************** Bank ***************************************
}
```
## を使用した PII 秘匿化 AWS Command Line Interface
次の例では、 AWS CLIで `StartPiiEntitiesDetectionJob` 演算機能を使用します。
例は、Unix、Linux、および macOS 用にフォーマットされています。Windows の場合は、各行末のバックスラッシュ (\\) Unix 連結文字をキャレット (^) に置き換えてください。
```
aws comprehend start-pii-entities-detection-job \
--region {{region}} \
--job-name {{job name}} \
--cli-input-json file://{{path to JSON input file}}
```
次の例に示すように、`cli-input-json` パラメータには、リクエストデータを含む JSON ファイルへのパスを指定します。
```
{
"InputDataConfig": {
"S3Uri": "s3://{{input bucket}}/{{input path}}",
"InputFormat": "ONE_DOC_PER_LINE"
},
"OutputDataConfig": {
"S3Uri": "s3://{{output bucket}}/{{output path}}"
},
"DataAccessRoleArn": "arn:aws:iam::{{account ID}}:role/{{data access role}}"
"LanguageCode": "en",
"Mode": "ONLY_REDACTION"
"RedactionConfig": {
"MaskCharacter": "*",
"MaskMode": "MASK",
"PiiEntityTypes": ["ALL"]
}
}
```
イベント検出ジョブの開始リクエストが成功すると、以下のような応答が表示されます。
```
{
"JobId": "7c4fbe6e...e5b"
"JobArn": "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/7c4fbe6e...e5b"
"JobStatus": "SUBMITTED",
}
```
[DescribeEventsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeEventsDetectionJob.html) 演算を使用して、既存のジョブのステータスを取得できます。
```
aws comprehend describe-pii-entities-detection-job \
--region {{region}} \
--job-id {{job ID}}
```
ジョブが正常に終了すると、以下のような応答が表示されます。
```
{
"PiiEntitiesDetectionJobProperties": {
"JobId": "7c4fbe6e...e5b"
"JobArn": "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/7c4fbe6e...e5b"
"JobName": "piiCLIredtest1",
"JobStatus": "COMPLETED",
"SubmitTime": "2022-05-05T14:54:06.169000-07:00",
"EndTime": "2022-05-05T15:00:17.007000-07:00",
"InputDataConfig": {
(identical to the input data that you provided with the request)
}
}
```