Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Configuración de Amazon Textract Texact para operaciones asíncronas
<a name="api-async-roles"></a>

En los siguientes procedimientos se muestra cómo configurar Amazon Textract para que lo utilice con un tema de Amazon Simple Notification Service (Amazon SNS) y una cola de Amazon Simple Queue Service (Amazon SQS).

**nota**  
Si está utilizando estas instrucciones para configurar el[Detección o análisis de texto en un documento de varias páginas](async-analyzing-with-sqs.md)ejemplo, no es necesario realizar los pasos 3 a 6. El ejemplo incluye código que permite crear y configurar el tema de Amazon SNS y la cola de Amazon SQS.

**Para configurar Amazon Textract**

1. Configurar unAWScuenta para acceder a Amazon Textract. Para obtener más información, consulte [Paso 1: Configuración de una cuenta de AWS y creación de un usuario de IAM](setting-up.md).

   Asegúrese de que el usuario tiene al menos los permisos siguientes:
   + AmazonTextractFullAccess
   + AmazonS3ReadOnlyAccess
   + AmazonSNSFullAccess
   + AmazonSQSFullAccess

1. Instale y configure el SDK de AWS necesario. Para obtener más información, consulte [Paso 2: Configurar laAWS CLIyAWSSDK de](setup-awscli-sdk.md). 

1. [Cree un tema de Amazon SNS.](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html). Anexa el nombre del tema con*Extracto de Amazon*. Anote el nombre de recurso de Amazon (ARN) del tema. Asegúrese de que el tema de está en la misma región de que elAWSpunto de enlace que está utilizando con su cuenta de AWS.

1. [Cree una cola estándar de Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-create-queue.html)mediante el uso de la[Consola de Amazon SQS](https://console.aws.amazon.com/sqs/). Anote el ARN de la cola.

1. [Suscriba la cola al tema](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-subscribe-queue-sns-topic.html) que creó en el paso 3.

1. [Conceder permiso al tema de Amazon SNS para enviar mensajes a la cola de Amazon SQS](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html).

1. Cree una función de servicio de IAM para dar a Amazon Textract Texact acceso a sus temas de Amazon SNS. Anote el nombre de recurso de Amazon (ARN) del rol de servicio. Para obtener más información, consulte [Conceder acceso a Amazon Textract a su tema de Amazon SNS](#api-async-roles-all-topics).

1. [Añada la siguiente política insertada](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#embed-inline-policy-console)al usuario de IAM que ha creado en el paso 1. 

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

   Asigne un nombre a la política insertada.

1. Ahora puede ejecutar los ejemplos de[Detección o análisis de texto en un documento de varias páginas](async-analyzing-with-sqs.md).

## Conceder acceso a Amazon Textract a su tema de Amazon SNS
<a name="api-async-roles-all-topics"></a>

Amazon Textract Texact necesita permiso para enviar un mensaje al tema de Amazon SNS cuando se haya completado una operación asíncrona. Utilice un rol de servicio de IAM para dar a Amazon Textract Texact acceso al tema de Amazon SNS. 

 Al crear el tema de Amazon SNS, debe añadir el nombre del tema con**AmazonTextract**—por ejemplo,**AmazonTextractMyTopicName**. 

1. Inicie sesión en la consola de IAM ([https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam)).

1. Seleccione **Roles** en el panel de navegación.

1. Elija **Create role**.

1. En **Select type of trusted entity (Seleccionar tipo de entidad de confianza)**, elija **AWS service (Servicio de AWS)**. 

1. Para**Elija el servicio que utilizará este rol**, elige**Textract**.

1. Seleccione **Next (Siguiente): Permisos**.

1. Verifique que la**AmazonTextractServiceRole**se ha incluido en la lista de políticas adjuntas. Para mostrar la política en la lista, escriba parte del nombre de la política en el**Políticas de filtrado**.

1. Seleccione **Next (Siguiente): Tags (Etiquetas)**.

1. No es necesario añadir etiquetas, así que elija**Siguiente: Consulte**.

1. En la sección **Review (Revisar)**, en **Role Name (Nombre de rol)**, escriba un nombre para el rol (por ejemplo, `TextractRole`). En**Descripción del rol**, actualice la descripción de la función y, a continuación, elija**Crear rol**.

1. Elija el rol nuevo para abrir la página de detalles del rol.

1. En **Summary (Resumen)**, copie el valor de **Role ARN (ARN del rol)** y guárdelo.

1. Seleccione **Trust Relationships**.

1. Elegir**Modificar relación de confianza**y garantizar que la política de fideicomiso tenga el siguiente aspecto.

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

1. Elija **Update Trust Policy** (Actualizar política de confianza).