Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Mise en route avec Amazon Textract
Cette section inclut des rubriques vous permettant de commencer à utiliser Amazon Textract. Si vous découvrez Amazon Textract, nous vous recommandons dans un premier temps de passer en revue les concepts et la terminologie de[Fonctionnement d'Amazon Textract](how-it-works.md).
Vous pouvez essayer l'API à l'aide de la démonstration dans la console Amazon Textract. Pour de plus amples informations, veuillez consulter[https://console.aws.amazon.com/textract/](https://console.aws.amazon.com/textract/).
**Topics**
+ [Étape 1 : Configuration d'un compte AWS et création d'un utilisateur IAM](setting-up.md)
+ [Étape 2 : Configuration de l'AWS CLIetAWSKits SDK](setup-awscli-sdk.md)
+ [Étape 3 : Premiers pas avec l'AWS CLIetAWSAPI SDK](get-started-exercise.md)
# Étape 1 : Configuration d'un compte AWS et création d'un utilisateur IAM
Avant d'utiliser Amazon Textract pour la première fois, exécutez les tâches suivantes :
1. [Inscrivez-vous à AWS](#setting-up-signup).
1. [Créer un utilisateur IAM](#setting-up-iam).
## Inscrivez-vous à AWS
Lorsque vous vous inscrivez à Amazon Web Services (AWS), votre compte AWS est automatiquement inscrit à tous les services publiés dans AWS. Seuls les services que vous utilisez vous sont facturés.
Avec Amazon Textract, vous ne payez que les ressources que vous utilisez. Pour de plus amples informations sur les taux d'utilisation d'Amazon Textract, consultez[Tarification Amazon Textract](https://aws.amazon.com/textract/pricing/). Si vous êtes un nouveau client AWS, vous pouvez démarrer gratuitement avec Amazon Textract. Pour plus d'informations, consultez la page [Niveau d'offre gratuite d'AWS](https://aws.amazon.com/free/).
Si vous possédez déjà un compte AWS, passez à l'étape suivante. Si ce vous ne disposez pas d'un compte AWS, effectuez les étapes de la procédure suivante pour en créer un.
**Pour créer un compte AWS**
1. Ouvrez [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).
1. Suivez les instructions en ligne.
Dans le cadre de la procédure d'inscription, vous recevrez un appel téléphonique et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Notez votre ID de compte AWS, car vous en aurez besoin lors de la prochaine tâche.
## Créer un utilisateur IAM
Les services d'AWS, comme Amazon Textract, nécessitent que vous fournissiez vos informations d'identification lors de l'accès. Cela permet au service de déterminer si vous avez les autorisations nécessaires pour accéder aux ressources détenues par ce service. La console exige votre mot de passe. Vous pouvez créer des clés d'accès pour votre compte AWS afin d'accéder à l'AWS CLI ou à l'API. Cependant, nous vous déconseillons d'accéder à AWS en utilisant les informations d'identification de votre compte AWS. A la place, nous vous recommandons de procéder comme suit :
+ UtiliserGestion des identités et des accès AWS(IAM) pour créer un utilisateur IAM.
+ Ajoutez l'utilisateur à un groupe IAM avec des autorisations administratives.
Vous pouvez alors accéder à AWS à l'aide d'une URL spéciale et des informations d'identification de cet utilisateur IAM.
Si vous êtes inscrit à AWS, mais que vous n'avez pas créé d'utilisateur IAM pour vous-même, vous pouvez le faire avec la console IAM. Suivez la procédure permettant de créer un utilisateur IAM dans votre compte.
**Pour créer un utilisateur IAM et vous connecter à la console**
1. Créez un utilisateur IAM avec des autorisations d'administrateur dans votre compte AWS. Pour obtenir des instructions, veuillez consulter [Création de votre premier groupe d'utilisateurs et d'administrateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) dans le *Guide de l'utilisateur IAM*.
1. En tant qu'utilisateur IAM, connectez-vous à AWS Management Console en utilisant une URL spéciale. Pour de plus amples informations, veuillez consulter[Comment les utilisateurs se connectent à votre compte](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_how-users-sign-in.html)dans le*IAM User Guide*.
**Note**
Un utilisateur IAM disposant d'autorisations d'administrateur dispose d'un accès illimité auAWSservices dans votre compte. Les exemples de code présentés dans ce guide supposent que l'un de vos utilisateurs dispose de`AmazonTextractFullAccess`Autorisations.`AmazonS3ReadOnlyAccess`est nécessaire pour les exemples qui accèdent à des documents stockés dans un compartiment Amazon S3. Selon vos exigences de sécurité, vous pouvez utiliser un groupe IAM qui se limite à ces autorisations. Pour de plus amples informations, veuillez consulter[Création de groupes IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html).
Pour plus d'informations sur IAM, consultez les ressources suivantes :
+ [Gestion des identités et des accès AWS (IAM)](https://aws.amazon.com/iam/)
+ [Prise en main](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)
+ [Guide de l'utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/)
## Étape suivante
[Étape 2 : Configuration de l'AWS CLIetAWSKits SDK](setup-awscli-sdk.md)
# Étape 2 : Configuration de l'AWS CLIetAWSKits SDK
Les étapes suivantes vous montrent comment installer l'AWS Command Line Interface (AWS CLI) et les kits SDK AWS utilisés dans les exemples de cette documentation.
Il existe plusieurs façons d'authentifier les appels des kits SDK AWS. Les exemples présentés dans ce guide supposent que vous utilisez un profil d'informations d'identification par défaut pour appeler les commandes de l'AWS CLI et les opérations d'API des kits SDK AWS. Vos informations d'identification par défaut fonctionneront sur tous les services. Par conséquent, si vous avez déjà configuré vos informations d'identification, vous n'avez pas besoin de le refaire. Toutefois, si vous souhaitez créer un autre ensemble d'informations d'identification pour ce service, vous pouvez créer un profil de nom. Pour plus d'informations sur la création de profils, consultez :[Consultez Profils nommés.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
Pour obtenir la liste des disponiblesAWSRégions, voir[Régions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html)dans le*Référence générale Amazon Web Services*.
**Pour configurer l'AWS CLI et les kits SDK AWS**
1. Téléchargez et installez l'AWS CLI et les kits SDK AWS que vous souhaitez utiliser. Ce guide fournit des exemples pour laAWS CLI, Java et Python. Pour en savoir plus sur les autres kits SDK AWS, consultez [Outils pour 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 pour Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
+ [AWS SDK pour Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)
1. Créez une clé d'accès pour l'utilisateur que vous avez créé dans[Créer un utilisateur IAM](setting-up.md#setting-up-iam).
1. Connectez-vous à la AWS Management Console et ouvrez la console IAM à l'adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le panneau de navigation, sélectionnez **Users** (Utilisateurs).
1. Choisissez le nom de l'utilisateur que vous avez créé dans[Créer un utilisateur IAM](setting-up.md#setting-up-iam).
1. Choisissez l'onglet **Informations d'identification de sécurité.**
1. Choisissez **Create access key (Créer une clé d'accès)**. Choisissez ensuite **Download .csv file (Télécharger un fichier .csv)** pour enregistrer l'ID de clé d'accès et la clé d'accès secrète dans un fichier CSV sur votre ordinateur. Stockez le fichier dans un emplacement sûr. Vous ne pourrez pas accéder à la clé d'accès secrète à nouveau une fois que cette boîte de dialogue se sera fermée. Après avoir téléchargé le fichier CSV, choisissez**Fermer**.
1. Définissez des informations d'identification dans le fichier de profils d'informations d'identification AWS situé dans :
+ `~/.aws/credentials`sous Linux, macOS ou Unix.
+ `C:\Users\USERNAME\.aws\credentials`sous Windows.
Le`.aws`n'existe pas avant la première configuration initiale de votre instance AWS. La première fois que vous configurez vos informations d'identification avec l'interface de ligne de commande, ce dossier sera créé. Pour de plus amples informations sur les informations d'identification AWS, consultez[Paramètres des fichiers de configuration et d'informations d'identification.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Ce fichier doit contenir des lignes au format suivant :
```
[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
```
Remplacez votre ID de clé d'accès et votre clé d'accès secrète*votre\$1access\$1key\$1id*et*votre\$1secret\$1access\$1key*.
1. Définissez la région AWS par défaut dans AWS`config`sur votre système local, situé dans :
+ `~/.aws/config`sous Linux, macOS ou Unix.
+ `C:\Users\USERNAME\.aws\config`sous Windows.
Le`.aws`n'existe pas avant la première configuration initiale de votre instance AWS. La première fois que vous configurez vos informations d'identification avec l'interface de ligne de commande, ce dossier sera créé. Pour de plus amples informations sur les informations d'identification AWS, consultez[Paramètres des fichiers de configuration et d'informations d'identification.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Ce fichier doit contenir des lignes suivantes :
```
[default]
region = your_aws_region
```
Remplacez la région AWS que vous souhaitez (par exemple, « us-west-2 ») par*votre\$1aws\$1region*.
**Note**
Si vous ne choisissez pas une région, us-east-1 est utilisé par défaut.
## Étape suivante
[Étape 3 : Premiers pas avec l'AWS CLIetAWSAPI SDK](get-started-exercise.md)
# Étape 3 : Premiers pas avec l'AWS CLIetAWSAPI SDK
Une fois que vous avez configuré leAWS CLIetAWSLes kits SDK que vous souhaitez utiliser, vous pouvez créer des applications qui utilisent Amazon Textract. Les rubriques suivantes vous montrent comment démarrer à l'aide d'Amazon Textract.
+ [Analyse du texte du document avec Amazon Textract](analyzing-document-text.md)
## Mise en forme des exemples de l'AWS CLI
Les exemples de l'AWS CLI présentés dans ce manuel sont formatés pour le système d'exploitation Linux. Pour utiliser les exemples avec Microsoft Windows, vous devez modifier le format JSON du paramètre `--document` et remplacer les barres obliques inverses (\$1) de saut de ligne par des accents circonflexes (^). Pour plus d'informations sur le format JSON, consultez [Spécification des valeurs des paramètres pour l'interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html).