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à.

# Configurazione di Amazon Textract per operazioni asincrone
<a name="api-async-roles"></a>

Le seguenti procedure mostrano come configurare Amazon Textract da utilizzare con un argomento Amazon Simple Notification Service (Amazon SNS) e una coda Amazon Simple Queue Service (Amazon SQS).

**Nota**  
Se stai utilizzando queste istruzioni per configurare la[Rilevamento o analisi del testo in un documento multipagina](async-analyzing-with-sqs.md)Ad esempio, non è necessario eseguire i passaggi da 3 a 6. L'esempio include il codice per creare e configurare l'argomento Amazon SNS e la coda Amazon SQS.

**Per configurare Amazon Textract**

1. Configurazione di unAWSaccount per accedere ad Amazon Textract. Per ulteriori informazioni, consultare [Fase 1: Impostazione di un account AWS e creazione di un utente IAM](setting-up.md).

   Assicurati che l'utente disponga almeno delle seguenti autorizzazioni:
   + AmazonTextractFullAccess
   + AmazonS3ReadOnlyAccess
   + AmazonSNSFullAccess
   + AmazonSQSFullAccess

1. Installare e configurare l'SDK AWS richiesto. Per ulteriori informazioni, consultare [Fase 2: Configurazione diAWS CLIeAWSSDK](setup-awscli-sdk.md). 

1. [Creare un argomento Amazon SNS.](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html). Aggiungi al nome dell'argomento il prefisso*AmazonTexttract*. Prendi nota dell'Amazon Resource Name (ARN) dell'argomento. Assicurati che l'argomento si trovi nella stessa regione dellaAWSendpoint che stai utilizzando con il tuo account AWS.

1. [Creazione di una coda standard Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-create-queue.html)utilizzando il[Console Amazon SQS](https://console.aws.amazon.com/sqs/). Prendere nota dell'ARN della coda.

1. [Sottoscrivi la coda all'argomento](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-subscribe-queue-sns-topic.html) creato nella fase 3.

1. [Concedi l'autorizzazione all'argomento Amazon SNS per inviare messaggi alla coda Amazon SQS](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html).

1. Crea un ruolo di servizio IAM per consentire ad Amazon Textract l'accesso ai tuoi argomenti Amazon SNS. Prendere nota del valore Amazon Resource Name (ARN) del ruolo del servizio, Per ulteriori informazioni, consultare [Fornire ad Amazon Textract l'accesso al tuo argomento Amazon SNS](#api-async-roles-all-topics).

1. [Aggiungere la seguente policy inline](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#embed-inline-policy-console)all'utente IAM creato nel passaggio 1. 

   ```
   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "MySid",
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": "Service role ARN from step 7"
           }
       ]
   }
   ```

   Assegnare un nome alla policy inline.

1. È ora possibile eseguire gli esempi in[Rilevamento o analisi del testo in un documento multipagina](async-analyzing-with-sqs.md).

## Fornire ad Amazon Textract l'accesso al tuo argomento Amazon SNS
<a name="api-async-roles-all-topics"></a>

Amazon Textract ha bisogno dell'autorizzazione per inviare un messaggio al tuo argomento Amazon SNS al termine di un'operazione asincrona. Puoi utilizzare un ruolo di servizio IAM per consentire ad Amazon Textract l'accesso all'argomento Amazon SNS. 

 Quando crei l'argomento Amazon SNS, devi anticipare il nome dell'argomento con**AmazonTextract**—ad esempio,**AmazonTextractMyTopicName**. 

1. Accedere alla console IAM ([https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam)).

1. Nel pannello di navigazione, seleziona **Roles** (Ruoli).

1. Selezionare **Create role (Crea ruolo)**.

1. Per **Select type of trusted entity (Seleziona tipo di entità attendibile)**, seleziona **AWS service (Servizio AWS)**. 

1. Per**Scegli il servizio che utilizzerà questo ruolo**, scegli**Textract**.

1. Seleziona **Successivo: Autorizzazioni**.

1. Verificare che il**Ruolo AmazonTextractServiceRole**la policy è stata inclusa nell'elenco delle politiche allegate. Per visualizzare la policy nell'elenco, immettere parte del nome della policy nella**Policy di filtro**.

1. Seleziona **Successivo: Tag**.

1. Non è necessario aggiungere tag, quindi scegliere**Successivo: Verifica**.

1. Nella sezione **Review (Rivedi)**, per **Role name (Nome ruolo)**, immettere un nome per il ruolo (ad esempio, `TextractRole`). Nello stato**Descrizione del ruolo**, aggiorna la descrizione del ruolo e quindi scegli**Creazione di ruolo**.

1. Scegliere il nuovo ruolo per aprire la relativa pagina dei dettagli.

1. In **Summary (Riepilogo)**, copiare il valore **Role ARN (ARN del ruolo)** e salvarlo.

1. Scegli **Trust relationships (Relazioni di trust)**.

1. Scegliere**Modifica della relazione di trust**e garantire che la politica di fiducia sia la seguente.

   ```
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "textract.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

1. Scegli **Update Trust Policy (Aggiorna policy di trust)**.