As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurando o Amazon Textract para operações assíncronas
<a name="api-async-roles"></a>

Os procedimentos a seguir mostram como configurar o Amazon Textract para usar com um tópico do Amazon Simple Notification Service (Amazon SNS) e em uma fila do Amazon Simple Queue Service (Amazon SQS).

**nota**  
Se você estiver usando essas instruções para configurar o[Detectando ou analisando texto em um documento de várias páginas](async-analyzing-with-sqs.md)Por exemplo, você não precisa executar as etapas 3 — 6. O exemplo inclui código para criar e configurar o tópico do Amazon SNS e a fila do Amazon SQS.

**Para configurar o Amazon Textract**

1. Configurar umAWSconta para acessar o Amazon Textract. Para obter mais informações, consulte [Etapa 1: Configurar uma conta da AWS e criar um usuário do IAM](setting-up.md).

   Certifique-se de que o usuário tenha pelo menos as seguintes permissões:
   + AmazonTextractFullAccess
   + AmazonS3ReadOnlyAccess
   + AmazonSNSFullAccess
   + AmazonSQSFullAccess

1. Instale e configure o SDK da AWS necessário. Para obter mais informações, consulte [Etapa 2: Configurar aAWS CLIeAWSSDKs da](setup-awscli-sdk.md). 

1. [Criar um tópico do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html). Anteca o nome do tópico com*AmazonTextact*. Anote o nome de recurso da Amazon (ARN) do tópico. Verifique se o tópico do está na mesma região do que oAWSO endpoint do que você está usando com sua conta da AWS.

1. [Criar uma fila padrão do Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-create-queue.html)usando o[Console do Amazon SQS](https://console.aws.amazon.com/sqs/). Anotar o ARN da fila.

1. [Inscreva a fila no tópico](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-subscribe-queue-sns-topic.html) criado na etapa 3.

1. [Conceda permissão ao tópico do Amazon SNS para enviar mensagens à fila do Amazon SQS](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html).

1. Crie uma função de serviço do IAM para dar ao Amazon Textract acesso aos tópicos do Amazon SNS. Observe o nome de recurso da Amazon (ARN) da função de serviço. Para obter mais informações, consulte [Dando acesso ao Amazon Textract ao seu tópico do Amazon SNS](#api-async-roles-all-topics).

1. [Adicione a seguinte política em linha](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#embed-inline-policy-console)Para o usuário do IAM que você criou na etapa 1. 

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

   Dê um nome à política em linha.

1. Agora, você pode executar os exemplos no[Detectando ou analisando texto em um documento de várias páginas](async-analyzing-with-sqs.md).

## Dando acesso ao Amazon Textract ao seu tópico do Amazon SNS
<a name="api-async-roles-all-topics"></a>

Amazon Textract precisa de permissão para enviar uma mensagem ao tópico do Amazon SNS quando uma operação assíncrona for concluída. Use uma função de serviço do IAM para dar ao Amazon Textract acesso ao tópico do Amazon SNS. 

 Ao criar o tópico do Amazon SNS, você deve anexar o nome do tópico com**AmazonTextract**—por exemplo,**AmazonTextractMyTopicName**. 

1. Faça login no console do IAM ([https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam)).

1. No painel de navegação, selecione **Roles**.

1. Selecione **Create role**.

1. Em **Select type of trusted entity (Selecionar tipo de entidade confiável)**, escolha **AWS service (Serviço da AWS)**. 

1. para o**Escolha o serviço que usará esta função**, escolha**Textract**.

1. Selecione **Next** (Próximo): **Permissions**

1. Verificar se o**AmazonTextractServiceRole**a política foi incluída na lista de políticas anexadas. Para exibir a política na lista, insira parte do nome da política no**Políticas de filtros**.

1. Selecione **Next** (Próximo): **Tags**.

1. Você não precisa adicionar tags, então selecione**Próximo: Análise**.

1. Na seção **Review (Revisar)**, em **Role Name (Nome da função)**, insira um nome para a função (por exemplo, `TextractRole`). Dentro**Descrição de função**, atualize a descrição da função e, em seguida, escolha**Criar função do**.

1. Escolha a nova função para abrir a página de detalhes da função.

1. Em **Summary (Resumo)**, copie o valor do **Role ARN (ARN da função)** e salve-o.

1. Escolha **Trust relationships (Relações de confiança)**.

1. Selecione**Editar relação de confiança**e garanta que a política de confiança seja a seguinte.

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

1. Escolha **Update Trust Policy**.