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.
# Démarrage avec Amazon Transcribe
Avant de pouvoir créer des transcriptions, vous devez remplir quelques conditions préalables :
+ [S’inscrire à un Compte AWS](#getting-started-api)
+ [Installez les SDK AWS CLI et](#getting-started-api) (si vous utilisez le AWS Management Console pour vos transcriptions, vous pouvez ignorer cette étape)
+ [Configurer des informations d’identification IAM](#getting-started-s3)
+ [Configurer un compartiment Amazon S3](#getting-started-s3)
+ [Créer une stratégie IAM](#getting-started-policy)
Une fois que vous avez rempli ces prérequis, vous êtes prêt pour la transcription. Sélectionnez votre méthode de transcription préférée dans la liste suivante pour commencer.
+ [AWS CLI](getting-started-cli.md)
+ [AWS Management Console](getting-started-console.md)
+ [AWS Kit SDK](getting-started-sdk.md)
+ [HTTP](getting-started-http-websocket.md)
+ [WebSockets](getting-started-http-websocket.md)
**Astuce**
Si vous découvrez Amazon Transcribe ou souhaitez découvrir nos fonctionnalités, nous vous recommandons d'utiliser le [AWS Management Console](https://console.aws.amazon.com/transcribe). C’est également l’option la plus simple si vous souhaitez démarrer un flux à l’aide du microphone de votre ordinateur.
Le streaming utilisant HTTP/2 et WebSockets étant plus compliqué que les autres méthodes de transcription, nous vous recommandons de consulter la [Configuration d’une transcription en streaming](streaming-setting-up.md) section avant de commencer à utiliser ces méthodes. **Notez que nous vous recommandons vivement d’utiliser un kit SDK pour les transcriptions en streaming.**
## Inscrivez-vous pour un Compte AWS
Pour commencer AWS, vous avez besoin d'un Compte AWS. Pour plus d'informations sur la création d'un Compte AWS, voir [Getting started with an Compte AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) dans le *Guide de Gestion de compte AWS référence*.
## Installation de la AWS CLI et SDK
Pour utiliser l' Amazon Transcribe API, vous devez d'abord installer le AWS CLI. La version actuelle de l’ AWS CLI est 2. Vous trouverez les instructions d’installation pour [Linux](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-linux.html), [Mac](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-mac.html), [Windows](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-windows.html) et [Docker](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-docker.html) dans le [https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
Une fois que vous l'avez AWS CLI installé, vous devez le [configurer](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) pour vos informations d'identification de sécurité et Région AWS.
Si vous souhaitez l'utiliser Amazon Transcribe avec un SDK, sélectionnez votre langue préférée pour les instructions d'installation :
+ [.NET](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/quick-start.html)
+ [C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started.html)
+ [Go](https://aws.github.io/aws-sdk-go-v2/docs/)
+ [Java V2](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup.html)
+ [JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/getting-started.html)
+ [PHP V3](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/getting-started_installation.html)
+ [AWS SDK pour Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) (transcriptions par lots)
+ [Python](https://github.com/awslabs/amazon-transcribe-streaming-sdk) (transcriptions en streaming)
+ [Ruby V3](https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-install.html)
+ [Rust](https://crates.io/crates/aws-sdk-transcribe) (transcriptions par lots)
+ [Rust](https://crates.io/crates/aws-sdk-transcribestreaming) (transcriptions en streaming)
## Création d'un Amazon S3 bucket
Amazon S3 est un service de stockage d'objets sécurisé. Amazon S3 stocke vos fichiers (appelés *objets*) dans des conteneurs (appelés *buckets*).
Pour exécuter une transcription par lots, vous devez d'abord télécharger vos fichiers multimédia dans un Amazon S3 bucket. Si vous ne spécifiez pas de Amazon S3 compartiment pour votre sortie de transcription, Amazon Transcribe place votre transcription dans un compartiment AWS géré Amazon S3 temporairement. La sortie de transcription dans les buckets AWS gérés est automatiquement supprimée après 90 jours.
Découvrez comment [Créer votre premier compartiment S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) et [Charger un objet dans votre compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html).
## Création d'un IAM policy
Pour gérer l'accès AWS, vous devez créer des politiques et les associer à IAM des identités (utilisateurs, groupes ou rôles) ou à AWS des ressources. Une stratégie définit les autorisations de l’entité à laquelle elle est attachée. Par exemple, un rôle ne peut accéder à un fichier multimédia situé dans votre Amazon S3 compartiment que si vous avez associé une politique à ce rôle qui lui accorde l'accès. Si vous souhaitez restreindre davantage ce rôle, vous pouvez limiter son accès à un fichier spécifique au sein d'un Amazon S3 bucket.
Pour en savoir plus sur l'utilisation des AWS politiques, consultez :
+ [Politiques et autorisations dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)
+ [Création de stratégies IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)
+ [Comment ? Amazon Transcribe fonctionne avec IAM](security_iam_service-with-iam.md)
Pour des exemples de politiques que vous pouvez utiliser Amazon Transcribe, voir[Amazon Transcribe exemples de politiques basées sur l'identité](security_iam_id-based-policy-examples.md). Si vous souhaitez générer des stratégies personnalisées, pensez à utiliser le [Générateur de stratégies AWS](https://awspolicygen.s3.amazonaws.com/policygen.html).
Vous pouvez ajouter une politique à l'aide du AWS Management Console AWS CLI, ou du AWS SDK. Pour obtenir des instructions, consultez la section [Ajouter et supprimer des autorisations IAM d'identité](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policy-api).
Les stratégies ont le format suivant :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "{{my-policy-name}}",
"Effect": "Allow",
"Action": [
"{{service}}:{{action}}"
],
"Resource": [
"{{amazon-resource-name}}"
]
}
]
}
```
------
Les Amazon Resource Names (ARN) identifient de manière unique toutes les AWS ressources, telles qu'un Amazon S3 bucket. Vous pouvez utiliser des ARN dans votre stratégie pour accorder des autorisations pour des actions spécifiques afin d’utiliser des ressources spécifiques. Par exemple, si vous souhaitez accorder un accès en lecture à un Amazon S3 bucket et à ses sous-dossiers, vous pouvez ajouter le code suivant à la `Statement` section de votre politique de confiance :
```
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket/*}}"
]
}
```
Voici un exemple de politique qui accorde des autorisations de Amazon Transcribe lecture (`GetObject`,`ListBucket`) et d'écriture (`PutObject`) à un Amazon S3 bucket et à ses sous-dossiers : `amzn-s3-demo-bucket`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket/*}}"
]
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket/*}}"
]
}
]
}
```
------