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.
# Introducción a Amazon Textract
En esta sección se proporcionan temas para empezar a utilizar Amazon Textract. Si es la primera vez que utiliza Amazon Textract, le recomendamos que consulte primero los conceptos y la terminología en[Funcionamiento de Amazon Textract](how-it-works.md).
Puede probar la API utilizando la demostración de la consola de Amazon Textract Texact. Para obtener más información, consulte[https://console.aws.amazon.com/textract/](https://console.aws.amazon.com/textract/).
**Topics**
+ [Paso 1: Configuración de una cuenta de AWS y creación de un usuario de IAM](setting-up.md)
+ [Paso 2: Configurar laAWS CLIyAWSSDK de](setup-awscli-sdk.md)
+ [Paso 3: Introducción al uso de laAWS CLIyAWSSDK API](get-started-exercise.md)
# Paso 1: Configuración de una cuenta de AWS y creación de un usuario de IAM
Antes de utilizar Amazon Textract por primera vez, realice las siguientes tareas:
1. [Inscripción en AWS](#setting-up-signup).
1. [Creación de un usuario de IAM](#setting-up-iam).
## Inscripción en AWS
Cuando se inscribe en Amazon Web Services (AWS), la cuenta de AWS se registra automáticamente en todos los servicios publicados en AWS. Solo se le cobrará por los servicios que utilice.
Con Amazon Textract, paga solo por los recursos que usa. Para obtener más información acerca de las tarifas de uso de Amazon Textract, consulte[Precios de Amazon Textract](https://aws.amazon.com/textract/pricing/). Si es cliente nuevo de AWS, puede comenzar a utilizar Amazon Textract gratuitamente. Para obtener más información, consulte [Capa gratuita de AWS](https://aws.amazon.com/free/).
Si ya dispone de una cuenta de AWS, pase a la siguiente tarea. Si todavía no dispone de una cuenta de AWS, realice los pasos del siguiente procedimiento para crear una.
**Para crear una cuenta de AWS**
1. Abra [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).
1. Siga las instrucciones en línea.
Parte del procedimiento de inscripción consiste en recibir una llamada telefónica e indicar un código de verificación en el teclado del teléfono.
Anote su ID de cuenta de AWS porque lo necesitará en la siguiente tarea.
## Creación de un usuario de IAM
Para tener acceso a los servicios de AWS, como Amazon Textract, debe proporcionar credenciales. Esto es así para que el servicio puede determinar si usted tiene permisos para obtener acceso a los recursos que son propiedad de tal servicio. La consola requiere que especifique la contraseña. Puede crear claves de acceso para su cuenta de AWS para tener acceso a la AWS CLI o API. Sin embargo, no es recomendable que acceda AWS con las credenciales de su cuenta de AWS. Le recomendamos que utilice en su lugar:
+ UsarAWS Identity and Access Management(IAM) para crear un usuario de IAM.
+ Añada el usuario a un grupo de IAM con permisos administrativos.
A continuación, podrá obtener acceso a AWS mediante una dirección URL especial y esas credenciales de usuario de IAM.
Si se ha inscrito en AWS pero no ha creado un usuario de IAM, puede crear uno mediante la consola de IAM. Siga el procedimiento para crear un usuario de IAM en su cuenta.
**Para crear un usuario de IAM e iniciar sesión en la consola**
1. Cree un usuario de IAM con permisos de administrador en su cuenta de AWS. Para obtener instrucciones, consulte[Creación del primer grupo de usuarios y administradores de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html)en la*IAM User Guide*.
1. Como usuario de IAM, puede iniciar sesión en la Consola de administración de AWS con una URL especial. Para obtener más información, consulte[Cómo inician sesión los usuarios en la cuenta](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_how-users-sign-in.html)en la*IAM User Guide*.
**nota**
Un usuario de IAM con permisos de administrador tiene acceso ilimitado alAWSservicios de tu cuenta. En los ejemplos de código de esta guía se presupone que tiene un usuario con la`AmazonTextractFullAccess`permisos.`AmazonS3ReadOnlyAccess`se requiere para ver ejemplos que tienen acceso a los documentos que se almacenan en un bucket Amazon S3. En función de sus requisitos de seguridad, es posible que desee utilizar un grupo de IAM que se limite a estos permisos. Para obtener más información, consulte[Creación de grupos de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html).
Para obtener más información sobre IAM, consulte lo siguiente:
+ [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/)
+ [Introducción](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)
+ [Guía del usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/)
## Paso siguiente
[Paso 2: Configurar laAWS CLIyAWSSDK de](setup-awscli-sdk.md)
# Paso 2: Configurar laAWS CLIyAWSSDK de
En los pasos siguientes se muestra cómo instalar la AWS Command Line Interface (AWS CLI) y los AWS SDK que utilizan los ejemplos de esta documentación.
Hay una serie de diferentes maneras para autenticar las llamadas al AWS SDK. En los ejemplos que aparecen en esta guía se presupone que utiliza un perfil de credenciales predeterminado para llamar a los comandos de la AWS CLI y las operaciones de API de AWS SDK. Sus credenciales predeterminadas funcionarán en todos los servicios, por lo que si ya ha configurado sus credenciales, no tendrá que volver a hacerlo. Sin embargo, si desea crear otro conjunto de credenciales para este servicio, puede crear un perfil de nombres. Para obtener más información acerca de la creación de perfiles,[consulte Perfiles con nombres.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
Para ver una lista de disponiblesAWSRegiones, consulte[Regiones y puntos de enlace de](https://docs.aws.amazon.com/general/latest/gr/rande.html)en la*Referencia general de Amazon Web Services*.
**Para configurar la AWS CLI y los AWS SDK**
1. Descargue e instale la AWS CLI y los SDK de AWS que desea utilizar. En esta guía se ofrecen ejemplos para laAWS CLI, Java y Python. Para obtener más información sobre otros SDK de AWS, consulte [Herramientas para Amazon Web Services](https://aws.amazon.com/tools/).
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)
+ [AWS SDK para Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
+ [AWS SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)
1. Cree una clave de acceso para el usuario que ha creado en[Creación de un usuario de IAM](setting-up.md#setting-up-iam).
1. Inicie sesión en la Consola de administración de AWS y abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación, seleccione **Users**.
1. Elija el nombre del usuario que ha creado en[Creación de un usuario de IAM](setting-up.md#setting-up-iam).
1. Seleccione la **pestaña de credenciales de** seguridad.
1. Elija **Create access key (Crear clave de acceso)**. A continuación, elija **Download .csv file (Descargar archivo .csv)** para guardar el ID de clave de acceso y la clave de acceso secreta en un archivo CSV de su equipo. Guarde el archivo en un lugar seguro. No podrá obtener acceso de nuevo a la clave de acceso secreta cuando este cuadro de diálogo se cierre. Cuando descargue el archivo CSV, elija**Cerrar**.
1. Configure las credenciales en el archivo de perfil de credenciales de AWS del sistema local, situado en:
+ `~/.aws/credentials`en Linux, macOS o Unix.
+ `C:\Users\USERNAME\.aws\credentials`en Windows.
La`.aws`no existe antes de la primera configuración inicial de la instancia de AWS. La primera vez que configure sus credenciales con la CLI, se creará esta carpeta. Para obtener más información acerca de las credenciales de AWS, consulte[Ajustes de los archivos de configuración y credenciales.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Este archivo debe contener líneas con el siguiente formato:
```
[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
```
Reemplace la ID de clave de acceso y la clave de acceso secreta*your\$1access\$1key\$1id*y*your\$1secret\$1access\$1key*.
1. Defina la región de AWS predeterminada en AWS`config`en el sistema local, situado en:
+ `~/.aws/config`en Linux, macOS o Unix.
+ `C:\Users\USERNAME\.aws\config`en Windows.
La`.aws`no existe antes de la primera configuración inicial de la instancia de AWS. La primera vez que configure sus credenciales con la CLI, se creará esta carpeta. Para obtener más información acerca de las credenciales de AWS, consulte[Ajustes de los archivos de configuración y credenciales.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Este archivo debe contener las líneas siguientes:
```
[default]
region = your_aws_region
```
Reemplace la región de AWS que desee (por ejemplo «us-west-2") por*tu\$1aws\$1region*.
**nota**
Si no elige una región, se usa us-east-1 de forma predeterminada.
## Paso siguiente
[Paso 3: Introducción al uso de laAWS CLIyAWSSDK API](get-started-exercise.md)
# Paso 3: Introducción al uso de laAWS CLIyAWSSDK API
Después de configurar elAWS CLIyAWSLos SDK que desea utilizar, puede compilar aplicaciones que usen Amazon Textract. En los siguientes temas, se muestra cómo comenzar a utilizar Amazon Textract.
+ [Análisis del texto del documento con Amazon Textract](analyzing-document-text.md)
## Formato de los ejemplos de AWS CLI
Los ejemplos de AWS CLI incluidos en esta guía tienen formato para el sistema operativo Linux. Para utilizar los ejemplos con Microsoft Windows, deberá cambiar el formato JSON del parámetro `--document`, así como los saltos de línea de barras diagonales inversas (\$1) por signos de intercalación (^). Para obtener más información sobre el formato JSON, consulte [Especificación de valores de parámetros para la AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html).