

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á.

# AWS SAM pré-requisitos
<a name="prerequisites"></a>

Preencha os pré-requisitos a seguir antes de instalar e usar a interface de linha de AWS Serverless Application Model comando ().AWS SAMCLI

Para usar o AWS SAMCLI, você precisa do seguinte:
+ Uma AWS conta, credenciais AWS Identity and Access Management (IAM) e um par de chaves de acesso do IAM.
+ O AWS Command Line Interface (AWS CLI) para configurar as AWS credenciais.

**Topics**
+ [Etapa 1: inscrever-se em uma AWS conta](#prerequisites-sign-up)
+ [Etapa 2: criar uma conta de usuário do IAM](#prerequisites-create-user)
+ [Etapa 3: criar um ID de chave de acesso e a chave de acesso secreta](#prerequisites-create-keys)
+ [Etapa 4: instalar o AWS CLI](#prerequisites-install-cli)
+ [Etapa 5: use o AWS CLI para configurar as AWS credenciais](#prerequisites-configure-credentials)
+ [Etapa 6: (opcional) instalar o AWS kit de ferramentas para VS Code](#prerequisites-install-vscode)
+ [Próximas etapas](#prerequisites-next-steps)

## Etapa 1: inscrever-se em uma AWS conta
<a name="prerequisites-sign-up"></a>

Se você não tiver um Conta da AWS, conclua as etapas a seguir para criar um.

**Para se inscrever em um Conta da AWS**

1. Abra a [https://portal.aws.amazon.com/billing/inscrição.](https://portal.aws.amazon.com/billing/signup)

1. Siga as instruções online.

   Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.

   Quando você se inscreve em um Conta da AWS, um *Usuário raiz da conta da AWS*é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar [tarefas que exigem acesso de usuário-raiz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

## Etapa 2: criar uma conta de usuário do IAM
<a name="prerequisites-create-user"></a>

Para criar um usuário administrador, selecione uma das opções a seguir.


****  

| Selecionar uma forma de gerenciar o administrador | Para | Por | Você também pode | 
| --- | --- | --- | --- | 
| Centro de Identidade do IAM (Recomendado) | Usar credenciais de curto prazo para acessar a AWS.Isso está de acordo com as práticas recomendadas de segurança. Para obter informações sobre as práticas recomendadas, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) no *Guia do usuário do IAM*. | Seguindo as instruções em [Conceitos básicos](https://docs.aws.amazon.com//singlesignon/latest/userguide/getting-started.html) no Guia do usuário do Centro de Identidade do AWS IAM . | Configure o acesso programático [configurando o AWS CLI para uso Centro de Identidade do AWS IAM](https://docs.aws.amazon.com//cli/latest/userguide/cli-configure-sso.html) no Guia do AWS Command Line Interface usuário. | 
| No IAM (Não recomendado) | Usar credenciais de longo prazo para acessar a AWS. | Seguindo as instruções em [Criar um acesso de emergência para um usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started-emergency-iam-user.html) no Guia do usuário do IAM. | Configurar o acesso programático, com base em [Gerenciar chaves de acesso para usuários do IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_credentials_access-keys.html) no Guia do usuário do IAM. | 

## Etapa 3: criar um ID de chave de acesso e a chave de acesso secreta
<a name="prerequisites-create-keys"></a>

Para acesso à CLI, é necessário ter um ID de chave de acesso e de uma chave de acesso secreta. Use credenciais temporárias em vez de chaves de acesso de longo prazo quando possível. As credenciais temporárias incluem um ID de acesso, uma chave de acesso secreta e um token de segurança que indica quando as credenciais expiram. Para obter mais informações, consulte [Uso de credenciais temporárias com AWS recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) no *Guia do usuário do IAM*.

Os usuários precisam de acesso programático se quiserem interagir com pessoas AWS fora do Console de gerenciamento da AWS. A forma de conceder acesso programático depende do tipo de usuário que está acessando AWS.

Para conceder acesso programático aos usuários, selecione uma das seguintes opções:


****  

| Qual usuário precisa de acesso programático? | Para | Por | 
| --- | --- | --- | 
| IAM | (Recomendado) Use as credenciais do console como credenciais temporárias para assinar solicitações programáticas para o AWS CLI, AWS SDKs ou. AWS APIs |  Siga as instruções da interface que deseja utilizar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/prerequisites.html)  | 
|  Identidade da força de trabalho (Usuários gerenciados no Centro de Identidade do IAM)  | Use credenciais temporárias para assinar solicitações programáticas para o AWS CLI AWS SDKs, ou. AWS APIs |  Siga as instruções da interface que deseja utilizar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/prerequisites.html)  | 
| IAM | Use credenciais temporárias para assinar solicitações programáticas para o AWS CLI AWS SDKs, ou. AWS APIs | Siga as instruções em [Como usar credenciais temporárias com AWS recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) no Guia do usuário do IAM. | 
| IAM | (Não recomendado)Use credenciais de longo prazo para assinar solicitações programáticas para o AWS CLI, AWS SDKs, ou. AWS APIs |  Siga as instruções da interface que deseja utilizar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/prerequisites.html)  | 

## Etapa 4: instalar o AWS CLI
<a name="prerequisites-install-cli"></a>

 AWS CLI É uma ferramenta de código aberto que permite que você interaja com o Serviços da AWS uso de comandos em seu shell de linha de comando. AWS SAMCLIIsso requer o AWS CLI para atividades como a configuração de credenciais. Para saber mais sobre o AWS CLI, consulte [O que é o AWS Command Line Interface?](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) no *Guia do AWS Command Line Interface usuário*.

Para instalar o AWS CLI, consulte [Instalando ou atualizando a versão mais recente do AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia AWS Command Line Interface do Usuário*.

## Etapa 5: use o AWS CLI para configurar as AWS credenciais
<a name="prerequisites-configure-credentials"></a>

**Para configurar as credenciais com o Centro de Identidade do IAM**
+ Para configurar credenciais com o IAM Identity Center, consulte [Configurar seu perfil com o assistente de AWS configuração de sso](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html#cli-configure-sso-configure).

**Para configurar credenciais com o AWS CLI**

1. Execute o comando `aws configure` da linha de comando.

1. Configure as definições a seguir. Selecione cada um dos links para saber mais:

   1. [ ID da chave de acesso](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-creds)

   1. [ Chave de acesso secreta](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-creds)

   1. [Região da AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-region)

   1. [ Formato da saída](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-format)

   O exemplo a seguir mostra valores de exemplo.

   ```
   $ aws configure
   AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
   AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   Default region name [None]: us-west-2
   Default output format [None]: json
   ```

O AWS CLI armazena essas informações em um *perfil* (uma coleção de configurações) nomeado `default` nos `config` arquivos `credentials` e. Esses arquivos estão localizados no arquivo `.aws` em seu diretório inicial. Por padrão, as informações desse perfil são usadas quando você executa um AWS CLI comando que não especifica explicitamente um perfil a ser usado. Para obter mais informações sobre o arquivo `credentials`, consulte [Configurações de arquivos de configuração e credenciais](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) no *Guia do usuário do AWS Command Line Interface *.

Para obter mais informações sobre como configurar credenciais, como usar uma configuração existente e um arquivo de credenciais, consulte [Configuração rápida](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html) no *Guia do usuário do AWS Command Line Interface *.

## Etapa 6: (opcional) instalar o AWS kit de ferramentas para VS Code
<a name="prerequisites-install-vscode"></a>

Para desenvolvedores que preferem um ambiente de desenvolvimento integrado, o AWS Toolkit for VS Code fornece recursos poderosos para o desenvolvimento sem servidor, incluindo depuração visualCodeLens , integração e fluxos de trabalho de implantação simplificados.

**Pré-requisitos para o desenvolvimento do VS Code**
+ Visual Studio Code (versão 1.73.0 ou posterior) instalado em seu sistema
+ Extensão de suporte à linguagem YAML para VS Code

**Para instalar o AWS Toolkit for VS Code**

1. Abra o Visual Studio Code

1. Abra a visualização Extensions (Ctrl\$1Shift\$1X ou Cmd\$1Shift\$1X)

1. Pesquise por "AWS Toolkit”

1. Instale a extensão “AWS Toolkit” da Amazon Web Services

1. Instale a extensão “YAML” da Red Hat (necessária para os CodeLens recursos do modelo SAM)

**Benefícios de usar o VS Code com AWS SAM**
+ Depuração visual: defina pontos de interrupção e execute suas funções do Lambda localmente
+ CodeLens integração: crie, implante e invoque funções diretamente do seu modelo SAM
+ Terminal integrado: acesse AWS CLI os comandos do AWS SAM sem sair do editor
+ Validação de modelo: validação em tempo real e IntelliSense para modelos SAM

Para obter informações sobre como configurar suas AWS credenciais no VS Code, consulte [Configuração de credenciais](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-credentials.html) no Guia do usuário do AWS Toolkit for VS Code.

## Próximas etapas
<a name="prerequisites-next-steps"></a>
+ Agora você está pronto para instalar o AWS SAMCLI e começar a usar AWS SAM. Para instalar o AWS SAMCLI, consulte[Instale o AWS SAM CLI](install-sam-cli.md).
+ Para configurar o Visual Studio Code para desenvolvimento sem servidor, consulte [Configurando o AWS Toolkit for VS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setting-up.html) Code.