Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyunting entitas PII dengan pekerjaan asinkron (API)
Untuk menyunting entitas PII dalam teks Anda, Anda memulai pekerjaan batch asinkron. Untuk menjalankan pekerjaan, unggah dokumen Anda ke Amazon S3, dan kirimkan [StartPiiEntitiesDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartPiiEntitiesDetectionJob.html)permintaan.
**Topics**
+ [Sebelum Anda mulai](#redact-pii-before)
+ [Parameter input](#redact-pii-api-inputs)
+ [Format file keluaran](#redact-pii-api-outputs)
+ [Redaksi PII menggunakan AWS Command Line Interface](#redact-pii-api-cli)
## Sebelum Anda mulai
Sebelum Anda mulai, pastikan Anda memiliki:
+ **Bucket input dan output —Identifikasi bucket** Amazon S3 yang ingin Anda gunakan untuk file input dan file output. Bucket harus berada di Wilayah yang sama dengan API yang Anda panggil.
+ **Peran layanan IAM** —Anda harus memiliki peran layanan IAM dengan izin untuk mengakses bucket input dan output Anda. Untuk informasi selengkapnya, lihat [Izin berbasis peran yang diperlukan untuk operasi asinkron](security_iam_id-based-policy-examples.md#auth-role-permissions).
## Parameter input
Dalam permintaan Anda, sertakan parameter yang diperlukan berikut:
+ `InputDataConfig`— Berikan [InputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_InputDataConfig.html)definisi untuk permintaan Anda, yang mencakup properti input untuk pekerjaan itu. Untuk `S3Uri` parameter, tentukan lokasi Amazon S3 dari dokumen input Anda.
+ `OutputDataConfig`— Berikan [OutputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_OutputDataConfig.html)definisi untuk permintaan Anda, yang mencakup properti output untuk pekerjaan tersebut. Untuk `S3Uri` parameter, tentukan lokasi Amazon S3 tempat Amazon Comprehend menulis hasil analisisnya.
+ `DataAccessRoleArn`— Berikan Nama Sumber Daya Amazon (ARN) dari suatu AWS Identity and Access Management peran. Peran ini harus memberikan Amazon Comprehend akses baca ke data input Anda dan akses tulis ke lokasi keluaran Anda di Amazon S3. Untuk informasi selengkapnya, lihat [Izin berbasis peran yang diperlukan untuk operasi asinkron](security_iam_id-based-policy-examples.md#auth-role-permissions).
+ `Mode`— Tetapkan parameter ini ke`ONLY_REDACTION`. Dengan pengaturan ini, Amazon Comprehend menulis salinan dokumen masukan Anda ke lokasi output di Amazon S3. Dalam salinan ini, setiap entitas PII disunting.
+ `RedactionConfig`— Berikan [RedactionConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_RedactionConfig.html)definisi untuk permintaan Anda, yang mencakup parameter konfigurasi untuk redaksi. Tentukan jenis PII yang akan disunting, dan tentukan apakah setiap entitas PII diganti dengan nama tipenya atau karakter pilihan Anda:
+ Tentukan tipe entitas PII yang akan disunting dalam array. `PiiEntityTypes` Untuk menyunting semua tipe entitas, atur nilai array ke`["ALL"]`.
+ Untuk mengganti setiap entitas PII dengan tipenya, atur `MaskMode` parameternya ke`REPLACE_WITH_PII_ENTITY_TYPE`. Misalnya, dengan pengaturan ini, entitas PII “Jane Doe” diganti dengan “[NAME]”.
+ Untuk mengganti karakter di setiap entitas PII dengan karakter pilihan Anda, atur `MaskMode` parameter ke`MASK`, dan atur `MaskCharacter` parameter ke karakter pengganti. Berikan hanya satu karakter. Karakter yang valid adalah\$1 , \$1, \$1,%, &, \$1, dan @. Misalnya, dengan pengaturan ini, entitas PII “Jane Doe” dapat diganti dengan “\$1\$1\$1\$1 \$1\$1\$1”
+ `LanguageCode`— Tetapkan parameter ini ke `en` atau`es`. Amazon Comprehend mendukung deteksi PII dalam teks bahasa Inggris atau Spanyol.
## Format file keluaran
Contoh berikut menunjukkan file input dan output dari pekerjaan analisis yang menyunting PII. Format input adalah satu dokumen per baris.
```
{
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
```
Pekerjaan analisis untuk menyunting file input ini menghasilkan file output berikut.
```
{
Managing Your Accounts Primary Branch ****** ******** Phone Number ************ **********************************
Online Banking ************** Telephone ************** Bank ***************************************
}
```
## Redaksi PII menggunakan AWS Command Line Interface
Contoh berikut menggunakan `StartPiiEntitiesDetectionJob` operasi dengan AWS CLI.
Contoh diformat untuk Unix, Linux, dan macOS. Untuk Windows, ganti karakter kelanjutan backslash (\$1) Unix di akhir setiap baris dengan tanda sisipan (^).
```
aws comprehend start-pii-entities-detection-job \
--region region \
--job-name job name \
--cli-input-json file://path to JSON input file
```
Untuk `cli-input-json` parameter Anda menyediakan path ke file JSON yang berisi data permintaan, seperti yang ditunjukkan pada contoh berikut.
```
{
"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"]
}
}
```
Jika permintaan untuk memulai pekerjaan deteksi peristiwa berhasil, Anda akan menerima respons yang mirip dengan yang berikut ini:
```
{
"JobId": "7c4fbe6e...e5b"
"JobArn": "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/7c4fbe6e...e5b"
"JobStatus": "SUBMITTED",
}
```
Anda dapat menggunakan [DescribeEventsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeEventsDetectionJob.html)operasi untuk mendapatkan status pekerjaan yang ada.
```
aws comprehend describe-pii-entities-detection-job \
--region region \
--job-id job ID
```
Ketika pekerjaan selesai dengan sukses, Anda menerima tanggapan yang mirip dengan yang berikut:
```
{
"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)
}
}
```