Configurando o Amazon Textract para operações assíncronas

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 oDetectando ou analisando texto em um documento de várias páginasPor 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.

   Certifique-se de que o usuário tenha pelo menos as seguintes permissões:

   • AmazonTextractFullAccess

   • AmazonS3ReadOnlyAccess

   • AmazonSNSFullAccess

   • AmazonSQSFullAccess

2. Instale e configure o SDK da AWS necessário. Para obter mais informações, consulte Etapa 2: Configurar aAWS CLIeAWSSDKs da.

3. Criar um tópico do Amazon SNS. Anteca o nome do tópico comAmazonTextact. 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.

4. Criar uma fila padrão do Amazon SQSusando oConsole do Amazon SQS. Anotar o ARN da fila.

5. Inscreva a fila no tópico criado na etapa 3.

6. Conceda permissão ao tópico do Amazon SNS para enviar mensagens à fila do Amazon SQS.

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

8. Adicione a seguinte política em linhaPara 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.

9. Agora, você pode executar os exemplos noDetectando ou analisando texto em um documento de várias páginas.

Dando acesso ao Amazon Textract ao seu tópico do Amazon SNS

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 comAmazonTextract—por exemplo,AmazonTextractMyTopicName.

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

2. No painel de navegação, selecione Roles.

3. Selecione Create role.

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

5. para oEscolha o serviço que usará esta função, escolhaTextract.

6. Selecione Next (Próximo): Permissions

7. Verificar se oAmazonTextractServiceRolea 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 noPolíticas de filtros.

8. Selecione Next (Próximo): Tags.

9. Você não precisa adicionar tags, então selecionePróximo: Análise.

10. Na seção Review (Revisar), em Role Name (Nome da função), insira um nome para a função (por exemplo, TextractRole). DentroDescrição de função, atualize a descrição da função e, em seguida, escolhaCriar função do.

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

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

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

14. SelecioneEditar relação de confiançae 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"
        }
      ]
    }

15. Escolha Update Trust Policy.