As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Conceitos básicos de Amazon Transcribe
Para criar transcrições, há alguns pré-requisitos:
+ [Cadastrar-se em uma Conta da AWS](#getting-started-api).
+ [Instale os SDKs AWS CLI e](#getting-started-api) (se você estiver usando o Console de gerenciamento da AWS para suas transcrições, você pode pular esta etapa)
+ [Configurar credenciais do IAM](#getting-started-s3).
+ [Configurar um bucket do Amazon S3](#getting-started-s3).
+ [Criar uma política do IAM](#getting-started-policy).
Depois de atender a esses pré-requisitos, você poderá começar a transcrever. Selecione o método de transcrição de sua preferência na lista a seguir para começar.
+ [AWS CLI](getting-started-cli.md)
+ [Console de gerenciamento da AWS](getting-started-console.md)
+ [AWS SDK](getting-started-sdk.md)
+ [HTTP](getting-started-http-websocket.md)
+ [WebSockets](getting-started-http-websocket.md)
**dica**
Se você é novo Amazon Transcribe ou gostaria de explorar nossos recursos, recomendamos usar [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe)o. Essa também é a opção mais fácil se você quiser iniciar um fluxo usando o microfone do computador.
Como o streaming usa HTTP/2 e WebSockets é mais complicado do que os outros métodos de transcrição, recomendamos revisar a [Configurar uma transcrição de streaming](streaming-setting-up.md) seção antes de começar a usar esses métodos. **Observe que é altamente recomendável usar um SDK para transcrições de streaming**.
## Inscreva-se para um Conta da AWS
Para começar AWS, você precisa de um Conta da AWS. Para obter informações sobre como criar um Conta da AWS, consulte [Introdução a um Conta da AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) no *Guia de AWS Gerenciamento de contas referência*.
## Instalar o AWS CLI e SDKs
Para usar a Amazon Transcribe API, você deve primeiro instalar AWS CLI o. A AWS CLI versão 2 é a atual. Você pode encontrar instruções de instalação para [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) e [Docker](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-docker.html) no [https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
Depois de AWS CLI instalá-lo, você deve [configurá-lo](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) para suas credenciais de segurança e. Região da AWS
Se você quiser usar Amazon Transcribe com um SDK, selecione seu idioma preferido para obter instruções de instalação:
+ [.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 para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) (transcrições em lote)
+ [Python](https://github.com/awslabs/amazon-transcribe-streaming-sdk) (transcrições de 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) (transcrições em lote)
+ [Rust](https://crates.io/crates/aws-sdk-transcribestreaming) (transcrições de streaming)
## Criando um Amazon S3 bucket
Amazon S3 é um serviço seguro de armazenamento de objetos. Amazon S3 armazena seus arquivos (chamados de *objetos*) em contêineres (chamados de *buckets*).
Para executar uma transcrição em lote, você deve primeiro carregar seus arquivos de mídia em um Amazon S3 bucket. Se você não especificar um Amazon S3 intervalo para sua saída de transcrição, Amazon Transcribe colocará sua transcrição em um intervalo AWS gerenciado Amazon S3 temporariamente. A saída da transcrição em buckets AWS gerenciados é excluída automaticamente após 90 dias.
Saiba como [Criar seu primeiro bucket do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) e [Fazer upload de um objeto no seu bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html).
## Criando um IAM política
Para gerenciar o acesso AWS, você deve criar políticas e anexá-las às IAM identidades (usuários, grupos ou funções) ou AWS recursos. Uma política define as permissões da entidade à qual ela está vinculada. Por exemplo, uma função só pode acessar um arquivo de mídia localizado em seu Amazon S3 bucket se você tiver anexado uma política a essa função que lhe conceda acesso. Se quiser restringir ainda mais essa função, você pode limitar seu acesso a um arquivo específico dentro de um Amazon S3 bucket.
Para saber mais sobre o uso de AWS políticas, consulte:
+ [Políticas e permissões em IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)
+ [Criar políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)
+ [Como Amazon Transcribe funciona com o IAM](security_iam_service-with-iam.md)
Por exemplo, políticas com as quais você pode usar Amazon Transcribe, consulte[Amazon Transcribe exemplos de políticas baseadas em identidade](security_iam_id-based-policy-examples.md). Se você quiser gerar políticas personalizadas, considere usar o [AWS Policy Generator](https://awspolicygen.s3.amazonaws.com/policygen.html).
Você pode adicionar uma política usando o Console de gerenciamento da AWS, AWS CLI, ou AWS SDK. Para obter instruções, consulte [Adicionar e remover permissões de IAM identidade](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policy-api).
As políticas têm o formato:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "{{my-policy-name}}",
"Effect": "Allow",
"Action": [
"{{service}}:{{action}}"
],
"Resource": [
"{{amazon-resource-name}}"
]
}
]
}
```
------
Os Amazon Resource Names (ARNs) identificam de forma exclusiva todos os AWS recursos, como um bucket. Amazon S3 Você pode usar ARNs em sua política para conceder permissões para que ações específicas usem recursos específicos. Por exemplo, se você quiser conceder acesso de leitura a um Amazon S3 bucket e suas subpastas, você pode adicionar o seguinte código à `Statement` seção da sua política de confiança:
```
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket/*}}"
]
}
```
Aqui está um exemplo de política que concede permissões de Amazon Transcribe leitura (`GetObject`, `ListBucket``PutObject`) e gravação () a um Amazon S3 bucket e suas subpastas: `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/*}}"
]
}
]
}
```
------