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 do Amazon Textract
Esta seção apresenta tópicos sobre conceitos básicos do uso do Amazon Textract. Caso você seja novo no Amazon Textract, recomendamos analisar primeiramente a terminologia e os conceitos em[Como funciona o Amazon Textract](how-it-works.md).
Você pode tentar a API usando a demonstração no console do Amazon Textract. Para obter mais informações, consulte[https://console.aws.amazon.com/textract/](https://console.aws.amazon.com/textract/).
**Topics**
+ [Etapa 1: Configurar uma conta da AWS e criar um usuário do IAM](setting-up.md)
+ [Etapa 2: Configurar aAWS CLIeAWSSDKs da](setup-awscli-sdk.md)
+ [Etapa 3: Conceitos básicos do uso daAWS CLIeAWSAPI SDK](get-started-exercise.md)
# Etapa 1: Configurar uma conta da AWS e criar um usuário do IAM
Antes de usar o Amazon Textract pela primeira vez, execute as seguintes tarefas:
1. [Cadastre-se na AWS](#setting-up-signup).
1. [Criar um usuário do IAM](#setting-up-iam).
## Cadastre-se na AWS
Quando você se cadastra na Amazon Web Services (AWS), a conta da AWS é cadastrada automaticamente em todos os serviços lançados na AWS. Você será cobrado apenas pelos serviços que usar.
Com o Amazon Textract, você paga apenas pelos recursos que usa. Para obter mais informações sobre as tarifas de uso do Amazon Textract, consulte[Definição de preço do Amazon Textract](https://aws.amazon.com/textract/pricing/). Se você for um cliente novo da AWS, poderá começar a usar gratuitamente o Amazon Textract. Para obter mais informações, consulte [Nível de uso gratuito da AWS](https://aws.amazon.com/free/).
Caso você já tenha uma conta da AWS, passe à próxima tarefa. Caso você ainda não tenha uma conta da AWS, realize as etapas no procedimento a seguir para criar uma.
**Para criar uma conta da AWS**
1. Abra [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).
1. Siga as instruções online.
Parte do procedimento de cadastro envolve uma chamada telefônica e a digitação de um código de verificação usando o teclado do telefone.
Observe o ID da conta da AWS porque você precisará dele na próxima tarefa.
## Criar um usuário do IAM
Os serviços da AWS, como o Amazon Textract, exigem o fornecimento de credenciais quando acessados. Dessa maneira, o serviço pode determinar se você tem permissões para acessar os recursos próprios desse serviço. O console requer sua senha. Você pode criar chaves de acesso para a conta da AWS a fim de acessar a AWS CLI ou a API. No entanto, não recomendamos que você acesse a AWS usando as credenciais da conta da AWS. Em vez disso, recomendamos o uso de:
+ Usar oAWS Identity and Access Management(IAM) para criar um usuário do IAM.
+ Adicione o usuário a um grupo do IAM com permissões de administrador.
Em seguida, você pode acessar a AWS usando uma URL especial e as credenciais desse usuário do IAM.
Se tiver se cadastrado na AWS, mas não tiver criado um usuário do IAM para você mesmo, poderá criar um usando o console do IAM. Siga o procedimento para criar um usuário do IAM na conta.
**Para criar um usuário do IAM e fazer login no console**
1. Crie um usuário do IAM com permissões do administrador na conta da AWS. Para obter instruções, consulte[Criação do primeiro usuário do IAM e do grupo de administradores](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html)no*Manual do usuário do IAM*.
1. Assim como o usuário do IAM, faça login no Console de gerenciamento da AWS usando uma URL especial. Para obter mais informações, consulte[Como usuários fazem login em sua conta](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_how-users-sign-in.html)no*Manual do usuário do IAM*.
**nota**
Um usuário do IAM com permissões de administrador tem acesso irrestrito aoAWSserviços em sua conta. Os exemplos de código neste guia pressupõem que você tenha um usuário do com a`AmazonTextractFullAccess`permissões.`AmazonS3ReadOnlyAccess`é obrigatório para exemplos que acessam documentos armazenados em um bucket do Amazon S3. Dependendo dos requisitos de segurança, convém usar um grupo do IAM que seja limitado a essas permissões. Para obter mais informações, consulte[Criação de grupos do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html).
Para obter mais informações sobre IAM, consulte o seguinte:
+ [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/)
+ [Conceitos básicos](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)
+ [Guia do usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/)
## Próxima etapa
[Etapa 2: Configurar aAWS CLIeAWSSDKs da](setup-awscli-sdk.md)
# Etapa 2: Configurar aAWS CLIeAWSSDKs da
As etapas a seguir mostram como instalar a AWS Command Line Interface (AWS CLI) e os SDKs da AWS usados pelos exemplos nesta documentação.
Existem várias maneiras diferentes de autenticar chamadas de SDK da AWS. Os exemplos neste guia presumem que você esteja usando um perfil de credenciais padrão para chamar comandos da AWS CLI e operações de API do SDK da AWS. Suas credenciais padrão funcionarão em todos os serviços, portanto, se você já configurou suas credenciais, não precisará fazê-lo novamente. No entanto, se você quiser criar outro conjunto de credenciais para esse serviço, você pode criar um perfil de nome. Para obter mais informações sobre como criar perfis,[consulte Perfis nomeados.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
Para ver uma lista dos disponíveisAWSRegiões, consulte[Regiões e endpoints do](https://docs.aws.amazon.com/general/latest/gr/rande.html)no*Referência geral do Amazon Web Services*.
**Para configurar a AWS CLI e os SDKs da AWS**
1. Faça download e instale a AWS CLI e os AWS SDKs que você deseja usar. Este guia apresenta exemplos daAWS CLI, Java e Python. Para obter mais informações sobre outros AWS SDKs, consulte [Ferramentas para a 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. Crie uma chave de acesso para o usuário criado por você em[Criar um usuário do IAM](setting-up.md#setting-up-iam).
1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação, escolha **Usuários**.
1. Selecione o nome do usuário criado por você em[Criar um usuário do IAM](setting-up.md#setting-up-iam).
1. Selecione a guia **Credenciais de segurança**.
1. Selecione **Create access key (Criar chave de acesso)**. Em seguida, selecione o **arquivo Download.csv** para salvar o ID de chave de acesso e a chave de acesso secreta em um arquivo CSV em seu computador. Armazene o arquivo em um lugar seguro. Você não terá mais acesso à chave de acesso secreta depois que essa caixa de diálogo for fechada. Depois de baixar do arquivo CSV, selecione**Fechar**.
1. Defina credenciais no arquivo de perfil de credenciais da AWS no sistema local, localizado em:
+ `~/.aws/credentials`no Linux, macOS ou Unix.
+ `C:\Users\USERNAME\.aws\credentials`no Windows.
O`.aws`a pasta não existe antes da primeira configuração inicial da instância da AWS. Na primeira vez que você configurar suas credenciais com a CLI, essa pasta será criada. Para obter mais informações sobre credenciais da AWS, consulte[Configurações de arquivos de configuração e credenciais.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Esse arquivo deve conter linhas no seguinte formato:
```
[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
```
Substitua o ID da chave de acesso e a chave de acesso secreta*your\$1access\$1key\$1id*e*your\$1secret\$1access\$1key*.
1. Defina a região da AWS padrão na AWS`config`no sistema local, localizado em:
+ `~/.aws/config`no Linux, macOS ou Unix.
+ `C:\Users\USERNAME\.aws\config`no Windows.
O`.aws`a pasta não existe antes da primeira configuração inicial da instância da AWS. Na primeira vez que você configurar suas credenciais com a CLI, essa pasta será criada. Para obter mais informações sobre credenciais da AWS, consulte[Configurações de arquivos de configuração e credenciais.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Esse arquivo deve conter as seguintes linhas:
```
[default]
region = your_aws_region
```
Substitua a região da AWS desejada (por exemplo, “us-west-2") por*your\$1aws\$1region*.
**nota**
Se você não escolher uma região, us-east-1 será usada por padrão.
## Próxima etapa
[Etapa 3: Conceitos básicos do uso daAWS CLIeAWSAPI SDK](get-started-exercise.md)
# Etapa 3: Conceitos básicos do uso daAWS CLIeAWSAPI SDK
Depois de configurar oAWS CLIeAWSOs SDKs que deseja usar, você pode compilar aplicativos que usam o Amazon Textract. Os tópicos a seguir mostram como começar a usar o Amazon Textract.
+ [Analisando texto do documento com o Amazon Textract](analyzing-document-text.md)
## Formatação dos exemplos de AWS CLI
Os exemplos de AWS CLI neste guia são formatados para o sistema operacional Linux. Para usar as amostras com o Microsoft Windows, você precisa alterar a formatação JSON do parâmetro `--document` e mudar as quebras de linha de barras invertidas (\$1) para acentos circunflexos (^). Para obter mais informações sobre a formatação JSON, consulte [Especificação dos valores de parâmetro para a interface da linha de comando da AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html).