Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Oscurazione delle entità PII con processi asincroni (API)
Per oscurare le entità PII nel testo, si avvia un processo batch asincrono. Per eseguire il lavoro, carica i tuoi documenti su Amazon S3 e invia una [StartPiiEntitiesDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartPiiEntitiesDetectionJob.html)richiesta.
**Topics**
+ [Prima di iniziare](#redact-pii-before)
+ [Parametri di input](#redact-pii-api-inputs)
+ [Formato del file di output](#redact-pii-api-outputs)
+ [Redazione delle PII utilizzando il AWS Command Line Interface](#redact-pii-api-cli)
## Prima di iniziare
Prima di iniziare, assicurati di avere:
+ **Bucket di input e output**: identifica i bucket Amazon S3 che desideri utilizzare per file di input e file di output. I bucket devono trovarsi nella stessa regione dell'API che stai chiamando.
+ **Ruolo di servizio IAM**: è necessario disporre di un ruolo di servizio IAM con l'autorizzazione ad accedere ai bucket di input e output. Per ulteriori informazioni, consulta [Role-based autorizzazioni necessarie per le operazioni asincrone](security_iam_id-based-policy-examples.md#auth-role-permissions).
## Parametri di input
Nella richiesta, includi i seguenti parametri obbligatori:
+ `InputDataConfig`— Fornite una [InputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_InputDataConfig.html)definizione per la richiesta, che include le proprietà di input per il lavoro. Per il `S3Uri` parametro, specifica la posizione in Amazon S3 dei documenti di input.
+ `OutputDataConfig`— Fornisci una [OutputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_OutputDataConfig.html)definizione per la tua richiesta, che include le proprietà di output per il lavoro. Per il `S3Uri` parametro, specifica la posizione Amazon S3 in cui Amazon Comprehend scrive i risultati della sua analisi.
+ `DataAccessRoleArn`— Fornisci l'Amazon Resource Name (ARN) di un AWS Identity and Access Management ruolo. Questo ruolo deve concedere ad Amazon Comprehend l'accesso in lettura ai dati di input e scrittura alla posizione di output in Amazon S3. Per ulteriori informazioni, consulta [Role-based autorizzazioni necessarie per le operazioni asincrone](security_iam_id-based-policy-examples.md#auth-role-permissions).
+ `Mode`— Imposta questo parametro su. `ONLY_REDACTION` Con questa impostazione, Amazon Comprehend scrive una copia dei documenti di input nella posizione di output in Amazon S3. In questa copia, ogni entità PII viene redatta.
+ `RedactionConfig`— Fornisci una [RedactionConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_RedactionConfig.html)definizione per la tua richiesta, che include i parametri di configurazione per la redazione. Specificate i tipi di PII da oscurare e specificate se ogni entità PII viene sostituita con il nome del relativo tipo o con un carattere a scelta:
+ Specificate i tipi di entità PII da oscurare nell'array. `PiiEntityTypes` Per oscurare tutti i tipi di entità, imposta il valore dell'array su. `["ALL"]`
+ Per sostituire ogni entità PII con il relativo tipo, imposta il `MaskMode` parametro su. `REPLACE_WITH_PII_ENTITY_TYPE` Ad esempio, con questa impostazione, l'entità PII «Jane Doe» viene sostituita da «[NAME]».
+ Per sostituire i caratteri in ogni entità PII con un carattere a tua scelta, imposta il `MaskMode` parametro su e imposta il `MaskCharacter` parametro sul carattere sostitutivo. `MASK` Fornisci un solo carattere. I caratteri validi sono\! , \#, $,%, &, \* e @. Ad esempio, con questa impostazione, l'entità PII «Jane Doe» può essere sostituita con «\*\*\*\* \*\*\*»
+ `LanguageCode`— Impostate questo parametro su o. `en` `es` Amazon Comprehend supporta il rilevamento delle informazioni PII in testo in inglese o spagnolo.
## Formato del file di output
L'esempio seguente mostra i file di input e output di un processo di analisi che redige le PII. Il formato dell'input è un documento per riga.
```
{
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
```
Il lavoro di analisi per redigere questo file di input produce il seguente file di output.
```
{
Managing Your Accounts Primary Branch ****** ******** Phone Number ************ **********************************
Online Banking ************** Telephone ************** Bank ***************************************
}
```
## Redazione delle PII utilizzando il AWS Command Line Interface
L'esempio seguente utilizza l'`StartPiiEntitiesDetectionJob`operazione con. AWS CLI
L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\\) al termine di ogni riga con un accento circonflesso (^).
```
aws comprehend start-pii-entities-detection-job \
--region {{region}} \
--job-name {{job name}} \
--cli-input-json file://{{path to JSON input file}}
```
Per il `cli-input-json` parametro si fornisce il percorso di un file JSON che contiene i dati della richiesta, come illustrato nell'esempio seguente.
```
{
"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"]
}
}
```
Se la richiesta di avvio del processo di rilevamento degli eventi ha avuto esito positivo, riceverai una risposta simile alla seguente:
```
{
"JobId": "7c4fbe6e...e5b"
"JobArn": "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/7c4fbe6e...e5b"
"JobStatus": "SUBMITTED",
}
```
È possibile utilizzare l'[DescribeEventsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeEventsDetectionJob.html)operazione per ottenere lo stato di un lavoro esistente.
```
aws comprehend describe-pii-entities-detection-job \
--region {{region}} \
--job-id {{job ID}}
```
Quando il processo viene completato correttamente, si riceve una risposta simile alla seguente:
```
{
"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)
}
}
```