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 referência
<a name="serverless-sam-reference"></a>

 Esta seção contém material AWS SAM de referência. Isso inclui material de referência sobre a CLI do AWS SAM, como informações de referência sobre comandos da CLI do AWS SAM e informações adicionais sobre a CLI do AWS SAM, como configuração, controle de versão e informações sobre solução de problemas. Além disso, esta seção inclui informações de referência sobre a AWS SAM especificação e o AWS SAM modelo, como informações de referência sobre conectores, repositórios de imagens e implantações. 

## AWS SAM especificação e o AWS SAM modelo
<a name="serverless-sam-spec"></a>

A AWS SAM especificação é uma especificação de código aberto sob a licença Apache 2.0. A versão atual da AWS SAM especificação está disponível no[AWS SAM modelo](sam-specification.md). AWS SAM A especificação vem com uma sintaxe abreviada simplificada que você usa para definir as funções, eventos APIs, configurações e permissões do seu aplicativo sem servidor. 

Você interage com a AWS SAM especificação por meio do diretório do projeto do AWS SAM aplicativo, que são as pastas e os arquivos criados quando você executa o **sam init** comando. Esse diretório inclui o AWS SAM modelo, um arquivo importante que define seus AWS recursos. O AWS SAM modelo é uma extensão de um AWS CloudFormation modelo. Para obter a referência completa dos modelos CloudFormation , consulte [Referência do modelo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-reference.html) no *AWS CloudFormation Guia do usuário*.

## AWS SAMCLI Referência de comando
<a name="serverless-sam-cli"></a>

A interface de linha de AWS Serverless Application Model comando (AWS SAMCLI) é uma ferramenta de linha de comando que você pode usar com AWS SAM modelos e integrações de terceiros compatíveis para criar e executar seus aplicativos sem servidor.

Você pode usar os comandos AWS SAMCLI para desenvolver, testar e implantar seus aplicativos com tecnologia sem servidor no Nuvem AWS. Veja a seguir alguns exemplos de comandos AWS SAM CLI:
+ `sam init`: se você for um usuário iniciante da CLI AWS SAM, poderá executar o comando `sam init` sem nenhum parâmetro para criar um aplicativo Hello World. O comando gera um AWS SAM modelo pré-configurado e um exemplo de código de aplicativo no idioma que você escolher.
+ `sam local invoke` e `sam local start-api` — Use esses comandos para testar o código do seu aplicativo localmente, antes de implantá-lo no Nuvem AWS.
+ `sam logs` — Use esse comando para buscar os registros que sua função do Lambda gera. Isso pode ajudá-lo a testar e depurar seu aplicativo depois de implantá-lo no Nuvem AWS.
+ `sam package` — Use esse comando para empacotar o código e as dependências do seu aplicativo em um *pacote de implantação*. Você precisa do pacote de implantação para carregar seu aplicativo no Nuvem AWS.
+ `sam deploy` — Use esse comando para implantar seu aplicativo sem servidor no Nuvem AWS. Ele cria os AWS recursos e define as permissões e outras configurações definidas no AWS SAM modelo.

Para obter instruções sobre como instalar o AWS SAMCLI, consulte[Instale o AWS SAM CLI](install-sam-cli.md).

## Modelos de políticas AWS SAM
<a name="serverless-policy-temps"></a>

Com AWS SAM, você pode escolher entre uma lista de modelos de política para definir o escopo das permissões de sua AWS Lambda função para os recursos que seu aplicativo usa. Para obter uma lista de modelos de política disponíveis, consulte [Tabela de modelos de política](serverless-policy-templates.md#serverless-policy-template-table). Para obter informações gerais sobre modelos de políticas e AWS SAM, consulte[Modelos de políticas AWS SAM](serverless-policy-templates.md).

## Tópicos
<a name="reference-sam-topics"></a>
+ [AWS SAM modelo](sam-specification.md)
+ [AWS SAMCLIReferência de comando](serverless-sam-cli-command-reference.md)
+ [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md)
+  [AWS SAM referência do conector](reference-sam-connector.md) 
+ [Modelos de políticas AWS SAM](serverless-policy-templates.md)
+ [Repositórios de imagens para AWS SAM](serverless-image-repositories.md)
+ [Telemetria no AWS SAMCLI](serverless-sam-telemetry.md)
+ [Configure e gerencie o acesso a recursos em seu AWS SAM modelo](sam-permissions.md)

# AWS SAMCLIReferência de comando
<a name="serverless-sam-cli-command-reference"></a>

Esta seção inclui informações de referência sobre comandos da CLI do AWS SAM. Isso inclui detalhes sobre o uso, uma lista abrangente das diferentes opções disponíveis para cada comando e informações adicionais. Quando aplicável, as informações adicionais incluem alguns detalhes, como argumentos, variáveis de ambiente e eventos. Consulte cada comando para obter detalhes. Para obter instruções sobre como instalar o AWS SAMCLI, consulte[Instale o AWS SAM CLI](install-sam-cli.md).

**Topics**
+ [sam build](sam-cli-command-reference-sam-build.md)
+ [sam delete](sam-cli-command-reference-sam-delete.md)
+ [sam deploy](sam-cli-command-reference-sam-deploy.md)
+ [sam init](sam-cli-command-reference-sam-init.md)
+ [sam list](sam-cli-command-reference-sam-list.md)
+ [sam local callback](sam-cli-command-reference-sam-local-callback.md)
+ [sam local execution](sam-cli-command-reference-sam-local-execution.md)
+ [sam local generate-event](sam-cli-command-reference-sam-local-generate-event.md)
+ [sam local invoke](sam-cli-command-reference-sam-local-invoke.md)
+ [sam local start-api](sam-cli-command-reference-sam-local-start-api.md)
+ [sam local start-lambda](sam-cli-command-reference-sam-local-start-lambda.md)
+ [sam logs](sam-cli-command-reference-sam-logs.md)
+ [sam package](sam-cli-command-reference-sam-package.md)
+ [sam pipeline bootstrap](sam-cli-command-reference-sam-pipeline-bootstrap.md)
+ [sam pipeline init](sam-cli-command-reference-sam-pipeline-init.md)
+ [sam publish](sam-cli-command-reference-sam-publish.md)
+ [sam remote callback](sam-cli-command-reference-sam-remote-callback.md)
+ [sam remote execution](sam-cli-command-reference-sam-remote-execution.md)
+ [sam remote invoke](sam-cli-command-reference-remote-invoke.md)
+ [sam remote test-event](sam-cli-command-reference-remote-test-event.md)
+ [sam sync](sam-cli-command-reference-sam-sync.md)
+ [sam traces](sam-cli-command-reference-sam-traces.md)
+ [sam validate](sam-cli-command-reference-sam-validate.md)

# sam build
<a name="sam-cli-command-reference-sam-build"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam build`.
+ Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre como usar o AWS SAMCLI `sam build` comando, consulte[Introdução à construção com AWS SAM](using-sam-cli-build.md).

O comando `sam build` prepara um aplicativo para as etapas subsequentes do fluxo de trabalho de desenvolvimento, como testes locais ou implantação no Nuvem AWS.

## Usage
<a name="ref-sam-cli-build-usage"></a>

```
$ sam build <arguments> <options>
```

## Argumentos
<a name="ref-sam-cli-build-args"></a>

**Resource ID (ID do recurso)**  <a name="ref-sam-cli-build-args-resource-id"></a>
Opcional. Instrui AWS SAM a criar um único recurso declarado em um [AWS SAM modelo](what-is-sam-overview.md#what-is-sam-template). Os artefatos de construção do recurso especificado serão os únicos disponíveis para comandos subsequentes no fluxo de trabalho, ou seja, `sam package` e `sam deploy`.

## Opções
<a name="ref-sam-cli-build-options"></a>

`--base-dir, -s DIRECTORY`  <a name="ref-sam-cli-build-options-base-dir"></a>
Resolve caminhos relativos para o código-fonte da função ou da camada em relação a esse diretório. Use essa opção se quiser alterar a forma como os caminhos relativos às pastas de código-fonte são resolvidos. Por padrão, os caminhos relativos são resolvidos com relação à localização do modelo AWS SAM .  
Além dos recursos no aplicativo raiz ou na pilha que você está criando, essa opção também aplica aplicativos ou pilhas aninhados.  
Essa opção se aplica aos seguintes tipos e propriedades de recursos:  
+ Tipo de recursos: `AWS::Serverless::Function` Propriedade: `CodeUri`
+ Tipo de recurso: `AWS::Serverless::Function` Atributo do recurso: `Metadata` Entrada: `DockerContext`
+ Tipo de recursos: `AWS::Serverless::LayerVersion` Propriedade: `ContentUri`
+ Tipo de recursos: `AWS::Lambda::Function` Propriedade: `Code`
+ Tipo de recursos: `AWS::Lambda::LayerVersion` Propriedade: `Content`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-build-options-beta-features"></a>
Permita ou negue recursos beta.

`--build-dir, -b DIRECTORY`  <a name="ref-sam-cli-build-options-build-dir"></a>
O caminho para um diretório onde os artefatos criados são armazenados. Esse diretório e todo o seu conteúdo são removidos com essa opção.

`--build-image TEXT`  <a name="ref-sam-cli-build-options-build-image"></a>
O URI da imagem de contêiner que você deseja extrair para a compilação. Por padrão, o AWS SAM extrai a imagem de contêiner do Amazon ECR Public. Use essa opção para extrair a imagem de outro localização.  
Especifique essa opção várias vezes. Cada instância dessa opção pode ter uma string ou um par de valores-chave. Se você especificar uma string, ela será a URI da imagem do contêiner a ser usada para todos os recursos do seu aplicativo. Por exemplo, `sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8`. Se você especificar um par de valores-chave, a chave será o nome do recurso e o valor será o URI da imagem do contêiner a ser usada para esse recurso. Por exemplo `sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8`. Com pares de valores-chave, você pode especificar imagens de contêiner diferentes para recursos diferentes.  
Essa opção só se aplica se a opção `--use-container` for especificada, caso contrário, ocorrerá um erro.

`--build-in-source | --no-build-in-source`  <a name="ref-sam-cli-build-options-build-in-source"></a>
Providencie `--build-in-source` para criar seu projeto diretamente na pasta de origem.  
A opção `--build-in-source` oferece suporte aos seguintes runtimes e métodos de compilação:  
+ **Runtimes** — Qualquer runtime Node.js suportado pela opção `sam init --runtime`.
+ **Métodos de compilação** — `Makefile`, `esbuild`.
A opção `--build-in-source` não é compatível com as seguintes opções:  
+ `--hook-name`
+ `--use-container `
*Padrão*: `--no-build-in-source`

`--cached | --no-cached`  <a name="ref-sam-cli-build-options-cached"></a>
Habilite ou desabilite as compilações em cache. Use essa opção para reutilizar artefatos de construção que não foram alterados em relação às compilações anteriores. AWS SAM avalia se você alterou algum arquivo no diretório do projeto. Por padrão, as compilações não são armazenadas em cache. Se a opção `--no-cached` for invocada, ela substituirá a configuração `cached = true` em samcofig.toml.  
O AWS SAM não avalia se você alterou os módulos de terceiros dos quais seu projeto depende, nos quais você não forneceu uma versão específica. Por exemplo, se sua função Python incluir um `requirements.txt` arquivo com a entrada `requests=1.x` e a versão mais recente do módulo de solicitação mudar de `1.1` para`1.2`, AWS SAM não extrairá a versão mais recente até que você execute uma compilação sem cache.

`--cache-dir`  <a name="ref-sam-cli-build-options-cached-dir"></a>
O diretório em que os artefatos do cache são armazenados quando `--cached` é especificado. O diretório padrão do cache é `.aws-sam/cache`.

`--config-env TEXT`  <a name="ref-sam-cli-build-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-build-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--container-env-var, -e TEXT`  <a name="ref-sam-cli-build-options-container-env-var"></a>
Passe as variáveis de ambiente para um contêiner de build. Especifique essa opção várias vezes. Cada instância dessa opção usa um par de valores-chave, em que a chave é a variável de recurso e ambiente, e o valor é o valor da variável de ambiente. Por exemplo: `--container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2`.  
Essa opção só se aplica se a opção `--use-container` for especificada, caso contrário, ocorrerá um erro.

`--container-env-var-file, -ef PATH`  <a name="ref-sam-cli-build-options-container-env-var-file"></a>
O caminho e o nome do arquivo JSON que contém valores para as variáveis de ambiente do contêiner. Para obter mais informações sobre arquivos variáveis de ambiente do contêiner, consulte [As variáveis de ambiente do contêiner](serverless-sam-cli-using-build.md#serverless-sam-cli-using-container-environment-file).  
Essa opção só se aplica se a opção `--use-container` for especificada, caso contrário, ocorrerá um erro.

`--debug`  <a name="ref-sam-cli-build-options-debug"></a>
Ativa o registro de depuração para imprimir mensagens de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--docker-network TEXT`  <a name="ref-sam-cli-build-options-docker-network"></a>
Especifica o nome ou ID de uma rede Docker existente à qual os contêineres do Docker Lambda devem se conectar, juntamente com a rede de ponte padrão. Se não for especificado, os contêineres do Lambda se conectarão somente à rede Docker da ponte padrão.

`--exclude, -x`  <a name="ref-sam-cli-build-options-exclude"></a>
O nome do (s) recurso (s) a ser excluído do `sam build`. Por exemplo, se seu modelo contiver `Function1`, `Function2` e `Function3` e você executar `sam build --exclude Function2`, somente `Function1` e `Function3` será criado.

`--help`  <a name="ref-sam-cli-build-options-help"></a>
Mostra esta mensagem e sai.

`--hook-name TEXT`  <a name="ref-sam-cli-build-options-hook-name"></a>
O nome do hook usado para estender a funcionalidade AWS SAMCLI.  
Valores aceitos: `terraform`.

`--manifest , -m PATH`  <a name="ref-sam-cli-build-options-manifest"></a>
O caminho para um arquivo de manifesto de dependência personalizado (por exemplo, package.json) a ser usado em vez do padrão.

`--mount-symlinks`  <a name="ref-sam-cli-build-options-mount-symlinks"></a>
Garante que a CLI do AWS SAM sempre monte symlinks que estão presentes nos arquivos a serem criados ou invocados. Isso se aplica somente aos symlinks no diretório de nível superior (ou seja, links simbólicos que estão diretamente na raiz da função). Por padrão, os symlinks não são montados, exceto aqueles necessários para usar o `build-in-source` no `node_modules` no NodeJS.

`--no-use-container`  <a name="ref-sam-cli-build-options-no-use-container"></a>
Uma opção que permite usar o kit de ferramentas do IDE para definir o comportamento padrão. Você também pode usar `sam build --no-use-container` para executar uma compilação em sua máquina local em vez de um contêiner do Docker.

`--parallel`  <a name="ref-sam-cli-build-options-parallel"></a>
Permite compilações paralelas. Use essa opção para criar as funções e camadas do seu AWS SAM modelo em paralelo. Por padrão, as funções e camadas são criadas em sequência.

`--parameter-overrides`  <a name="ref-sam-cli-build-options-parameter-overrides"></a>
(Opcional) Uma string que contém substituições de CloudFormation parâmetros codificadas como pares de valores-chave. Usa o mesmo formato do AWS Command Line Interface (AWS CLI). Por exemplo: '`ParameterKey`=`KeyPairName`, `ParameterValue`=`MyKey` `ParameterKey`=`InstanceType`, `ParameterValue`=`t1.micro`'. Essa opção não é compatível com o `--hook-name`.

`--profile TEXT`  <a name="ref-sam-cli-build-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="ref-sam-cli-build-options-region"></a>
O Região da AWS para implantar. Por exemplo, us-east-1.

`--save-params`  <a name="ref-sam-cli-build-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--skip-prepare-infra`  <a name="ref-sam-cli-build-options-skip-prepare-infra"></a>
Ignora a fase de preparação se nenhuma alteração na infraestrutura tiver sido feita. Execute com a opção `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-build-options-skip-pull-image"></a>
Especifica se o comando deve ignorar a extração da imagem mais recente do Docker para o runtime do Lambda.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-build-options-template-file"></a>
O caminho e o nome do arquivo de AWS SAM modelo`[default: template.[yaml|yml]]`. Essa opção não é compatível com o `--hook-name`.

`--terraform-project-root-path`  <a name="ref-sam-cli-build-options-terraform-project-root-path"></a>
O caminho relativo ou absoluto para o diretório de nível superior contendo seus arquivos de configuração Terraform ou código-fonte da função. Se esses arquivos estiverem localizados fora do diretório que contém seu módulo raiz Terraform, use essa opção para especificar seu caminho absoluto ou relativo. Essa opção exige que `--hook-name` seja definida como `terraform`.

`--use-container`, `-u`  <a name="ref-sam-cli-build-options-use-container"></a>
Se as funções dependerem de pacotes com dependências compiladas de forma nativa, use essa opção para desenvolver a função dentro de um contêiner do Docker semelhante ao Lambda.

## Exemplo
<a name="sam-cli-command-reference-sam-build-examples"></a>

Para obter um exemplo detalhado e uma explicação aprofundada sobre o uso do subcomando `sam build`, consulte [Introdução à construção com AWS SAM](using-sam-cli-build.md).

# sam delete
<a name="sam-cli-command-reference-sam-delete"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam delete`.

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam delete` comando exclui um AWS SAM aplicativo excluindo a CloudFormation pilha, os artefatos que foram empacotados e implantados no Amazon S3 e no Amazon ECR e o arquivo de modelo. AWS SAM 

Esse comando também verifica se há uma pilha complementar do Amazon ECR implantada e, em caso afirmativo, solicita ao usuário a exclusão dessa pilha e dos repositórios do Amazon ECR. Se `--no-prompts` for especificado, as pilhas complementares e os repositórios do Amazon ECR serão excluídos por padrão.

## Usage
<a name="sam-cli-command-reference-sam-delete-usage"></a>

```
$ sam delete <options>
```

## Opções
<a name="sam-cli-command-reference-sam-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-delete-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é `default`. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-delete-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é `samconfig.toml` na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-delete-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--help`  <a name="sam-cli-command-reference-sam-delete-options-help"></a>
Mostra esta mensagem e sai.

`--no-prompts`  <a name="sam-cli-command-reference-sam-delete-options-no-prompts"></a>
Especifique essa opção para AWS SAM operar no modo não interativo. O nome da pilha deve ser fornecido, com a opção `--stack-name` ou no arquivo de configuração `toml`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-delete-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-delete-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--s3-bucket`  <a name="sam-cli-command-reference-sam-delete-options-s3-bucket"></a>
O caminho do bucket do Amazon S3 que deseja excluir.

`--s3-prefix`  <a name="sam-cli-command-reference-sam-delete-options-s3-prefix"></a>
O prefixo do bucket do Amazon S3 que deseja excluir.

`--save-params`  <a name="sam-cli-command-reference-sam-delete-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-delete-options-stack-name"></a>
O nome da CloudFormation pilha que você deseja excluir.

## Exemplos
<a name="sam-cli-command-reference-sam-delete-examples"></a>

O comando a seguir exclui a pilha `MY-STACK`. 

```
$ sam delete --stack-name MY-STACK
```

O seguinte comando exclui a pilha `MY-STACK` e o bucket do S3 `sam-s3-demo-bucket`:

```
$ sam delete \
    --stack-name MyStack \
    --s3-bucket MySAMBucket
```

# sam deploy
<a name="sam-cli-command-reference-sam-deploy"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam deploy`.
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre como usar o AWS SAMCLI `sam deploy` comando, consulte[Introdução à implantação com AWS SAM](using-sam-cli-deploy.md).

O `sam deploy` comando implanta um aplicativo para o usuário Nuvem AWS . AWS CloudFormation

## Usage
<a name="ref-sam-cli-deploy-usage"></a>

```
$ <environment variables> sam deploy <options>
```

## Variáveis de ambiente
<a name="ref-sam-cli-deploy-env"></a>

`SAM_CLI_POLL_DELAY`  <a name="ref-sam-cli-deploy-env-sam-cli-poll-delay"></a>
Defina a variável de `SAM_CLI_POLL_DELAY` ambiente com um valor de segundos em seu shell para configurar com que frequência a CLI do AWS SAM verifica o estado da CloudFormation pilha, o que é útil ao ver a limitação de. CloudFormation Essa variável de ambiente é usada para a sondagem de chamadas de API `describe_stack`, que são feitas durante a execução de `sam deploy`.   
Veja um exemplo dessa variável:  

```
$ SAM_CLI_POLL_DELAY=5 sam deploy
```

## Opções
<a name="ref-sam-cli-deploy-options"></a>

`--capabilities LIST`  <a name="ref-sam-cli-deploy-options-capabilities"></a>
Uma lista de recursos que você deve especificar para permitir CloudFormation a criação de determinadas pilhas. Alguns modelos de pilha podem incluir recursos que afetam suas permissões Conta da AWS, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para essas pilhas, você deve confirmar explicitamente seus recursos especificando esse opção. Os únicos valores válidos são `CAPABILITY_IAM` e `CAPABILITY_NAMED_IAM`. Se você tiver recursos do IAM, então poderá especificar qualquer recurso. Se tiver recursos do IAM com nomes personalizados, então você deverá especificar `CAPABILITY_NAMED_IAM`. Se você não especificar essa opção, a operação retornará um erro `InsufficientCapabilities`.  
Quando você implanta uma aplicação que contém aplicações aninhadas, deve usar `CAPABILITY_AUTO_EXPAND` para reconhecer que a aplicação contém aplicações aninhadas. Para obter mais informações, consulte [Implantar aplicativos aninhados](serverless-sam-template-nested-applications.md#serverless-sam-templates-nested-applications-deploying).

`--config-env TEXT`  <a name="ref-sam-cli-deploy-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é `default`. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-deploy-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é `samconfig.toml` na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="ref-sam-cli-deploy-options-confirm-changeset"></a>
Solicite a confirmação se o AWS SAMCLI implanta o conjunto de alterações computado.

`--debug`  <a name="ref-sam-cli-deploy-options-debug"></a>
Ative o registro de depuração para imprimir a mensagem de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--disable-rollback | --no-disable-rollback`  <a name="ref-sam-cli-deploy-options-disable-rollback"></a>
Especifique se deseja reverter sua CloudFormation pilha se ocorrer um erro durante uma implantação. Por padrão, se houver um erro durante uma implantação, sua CloudFormation pilha voltará ao último estado estável. Se você especificar `--disable-rollback` e ocorrer um erro durante uma implantação, os recursos que foram criados ou atualizados antes da ocorrência do erro não serão revertidos.

`--fail-on-empty-changeset | --no-fail-on-empty-changeset`  <a name="ref-sam-cli-deploy-options-fail-on-empty-changeset"></a>
Especifique se deseja retornar um código de saída diferente de zero se não houver alterações a serem feitas na pilha. O comportamento padrão é retornar um código de saída diferente de zero.

`--force-upload`  <a name="ref-sam-cli-deploy-options-force-upload"></a>
Especifique essa opção para fazer upload de artefatos, mesmo que eles correspondam aos artefatos existentes no bucket do Amazon S3. Os artefatos correspondentes são sobrescritos.

`--guided, -g`  <a name="ref-sam-cli-deploy-options-guided"></a>
Especifique essa opção para que o AWS SAMCLI use prompts que o guiem durante a implantação.

`--help`  <a name="ref-sam-cli-deploy-options-help"></a>
Mostre esta mensagem e saia.

`--image-repositories TEXT`  <a name="ref-sam-cli-deploy-options-image-repositories"></a>
Um mapeamento de funções para o URI do repositório Amazon ECR. Funções de referência por meio de sua ID lógica. Veja um exemplo a seguir:  

```
$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Você pode especificar esta opção várias vezes em um único comando.

`--image-repository TEXT`  <a name="ref-sam-cli-deploy-options-image-repository"></a>
O nome do repositório Amazon ECR em que esse comando carrega a imagem da sua função. Essa opção é necessária para funções declaradas com o tipo de pacote `Image`.

`--kms-key-id TEXT`  <a name="ref-sam-cli-deploy-options-kms-key-id"></a>
O ID de uma chave AWS Key Management Service (AWS KMS) usada para criptografar artefatos que estão em repouso no bucket do Amazon S3. Se você não especificar essa opção, AWS SAM use as chaves de criptografia gerenciadas pelo Amazon S3.

`--metadata`  <a name="ref-sam-cli-deploy-options-metadata"></a>
Um mapa de metadados para anexar a todos os artefatos referenciados em seu modelo.

`--no-execute-changeset`  <a name="ref-sam-cli-deploy-options-no-execute-changeset"></a>
Indica se o conjunto de alterações deve ser aplicado. Especifique essa opção se quiser visualizar as alterações da pilha antes de aplicar o conjunto de alterações. Esse comando cria um conjunto de alterações CloudFormation e, em seguida, sai sem aplicar o conjunto de alterações. Para aplicar o conjunto de alterações, execute o mesmo comando sem essa opção.

`--no-progressbar`  <a name="ref-sam-cli-deploy-options-no-progressbar"></a>
Não exiba uma barra de progresso ao fazer o upload de artefatos para o Amazon S3.

`--notification-arns LIST`  <a name="ref-sam-cli-deploy-options-notification-arns"></a>
Uma lista dos ARNs tópicos CloudFormation do Amazon Simple Notification Service (Amazon SNS) associados à pilha.

`--on-failure [ROLLBACK | DELETE | DO_NOTHING]`  <a name="ref-sam-cli-deploy-options-on-failure"></a>
Especifique a ação a ser tomada quando uma pilha falhar na criação.  
As seguintes opções estão disponíveis:  
+ `ROLLBACK` — Reverte a pilha para um estado anterior em boas condições.
+ `DELETE` — Reverte a pilha para um estado anterior em boas condições, se existir um. Caso contrário, exclui a pilha.
+ `DO_NOTHING` — Nem reverte nem exclui a pilha. O efeito é o mesmo do `--disable-rollback`.
O comportamento padrão é `ROLLBACK`.  
Você pode especificar a opção `--disable-rollback` ou a opção `--on-failure`, mas não ambos.

`--parameter-overrides LIST`  <a name="ref-sam-cli-deploy-options-parameter-overrides"></a>
Uma string que contém substituições de CloudFormation parâmetros codificadas como pares de valores-chave. Cada substituição usa o formato `ParameterKey=name,ParameterValue=value`. As substituições múltiplas são separadas por espaços. Veja dois exemplos a seguir:  

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2
```

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana
```

`--profile TEXT`  <a name="ref-sam-cli-deploy-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="ref-sam-cli-deploy-options-region"></a>
O Região da AWS para implantar. Por exemplo, us-east-1.

`--resolve-image-repos`  <a name="ref-sam-cli-deploy-options-resolve-image-repos"></a>
Crie automaticamente repositórios do Amazon ECR para uso no empacotamento e implantação em implantações não guiadas. Esta opção se aplica apenas às funções e camadas com o `PackageType: Image` especificado. Se você especificar a opção `--guided`, então o AWS SAMCLI ignora o `--resolve-image-repos`.  
Se você criar AWS SAM automaticamente qualquer repositório do Amazon ECR para funções ou camadas com essa opção e, posteriormente, você excluir essas funções ou camadas do seu AWS SAM modelo, os repositórios correspondentes do Amazon ECR serão automaticamente excluídos.

`--resolve-s3`  <a name="ref-sam-cli-deploy-options-resolve-s3"></a>
Crie automaticamente um bucket do Amazon S3 para uso no empacotamento e implantação em implantações não guiadas. Se você especificar a opção `--guided`, então a CLI AWS SAM ignora o `--resolve-s3`. Se você especificar as opções `--s3-bucket` e `--resolve-s3`, ocorrerá um erro.

`--role-arn TEXT`  <a name="ref-sam-cli-deploy-options-role-arn"></a>
O Amazon Resource Name (ARN) de uma função do IAM que é CloudFormation assumida ao aplicar o conjunto de alterações.

`--s3-bucket TEXT`  <a name="ref-sam-cli-deploy-options-s3-bucket"></a>
O nome do bucket do Amazon S3 em que esse comando carrega seu modelo. CloudFormation Se seu modelo for maior que 51.200 bytes, a opção `--s3-bucket` ou a opção `--resolve-s3` serão obrigatórias. Se você especificar as opções `--s3-bucket` e `--resolve-s3`, ocorrerá um erro.

`--s3-prefix TEXT`  <a name="ref-sam-cli-deploy-options-s3-prefix"></a>
O prefixo adicionado aos nomes dos artefatos que são enviados ao bucket do Amazon S3. O nome do prefixo é um nome de caminho (nome da pasta) para o bucket do Amazon S3.

`--save-params`  <a name="ref-sam-cli-deploy-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--signing-profiles LIST`  <a name="ref-sam-cli-deploy-options-signing-profiles"></a>
A lista de perfis de assinatura com os quais assinar seus pacotes de implantação. Essa opção usa uma lista de pares de valores-chave, em que a chave é o nome da função ou camada a ser assinada e o valor é o perfil de assinatura, com um proprietário de perfil opcional delimitado por `:`. Por exemplo, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--stack-name TEXT`  <a name="ref-sam-cli-deploy-options-stack-name"></a>
(Obrigatório) O nome da CloudFormation pilha na qual você está implantando. Se você especificar uma pilha existente, o comando atualizará a pilha. Se você especificar uma nova pilha, o comando a criará.

`--tags LIST`  <a name="ref-sam-cli-deploy-options-tags"></a>
Uma lista de tags a serem associadas à pilha criada ou atualizada. CloudFormation também propaga essas tags para recursos na pilha que as suportam.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-deploy-options-template-file"></a>
O caminho e o nome do arquivo em que seu AWS SAM modelo está localizado.  
Se você especificar essa opção, AWS SAM implantará somente o modelo e os recursos locais para os quais ele aponta.

`--use-json`  <a name="ref-sam-cli-deploy-options-use-json"></a>
JSON de saída para o CloudFormation modelo. A saída padrão é YAML.

## Exemplo
<a name="sam-cli-command-reference-sam-deploy-examples"></a>

Para obter um exemplo detalhado e uma explicação aprofundada sobre o uso do subcomando `sam deploy`, consulte [Introdução à implantação com AWS SAM](using-sam-cli-deploy.md).

# sam init
<a name="sam-cli-command-reference-sam-init"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam init`.
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam init` comando, consulte[Crie seu aplicativo em AWS SAM](using-sam-cli-init.md).

O comando `sam init` fornece opções para inicializar um novo aplicativo sem servidor.

## Usage
<a name="sam-cli-command-reference-sam-init-usage"></a>

```
$ sam init <options>
```

## Opções
<a name="sam-cli-command-reference-sam-init-options"></a>

`--app-template TEXT`  <a name="sam-cli-command-reference-sam-init-options-app-template"></a>
O identificador do modelo de aplicativo gerenciado que você deseja usar. Se você não tiver certeza, chame `sam init` sem opções para um fluxo de trabalho interativo.  
Esse parâmetro é obrigatório se `--no-interactive` for especificado e `--location` não for fornecido.  
Esse parâmetro só está disponível na versão 0.30.0 e posterior do AWS SAM CLI. A especificação desse parâmetro com uma versão anterior resulta em um erro.

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 Ative o monitoramento CloudWatch do Amazon Application Insights para seu aplicativo. Para saber mais, consulte [Usando o CloudWatch Application Insights para monitorar seus aplicativos AWS SAM sem servidor](monitor-app-insights.md).   
 A opção padrão é `--no-application-insights`. 

`--architecture, -a [ x86_64 | arm64 ]`  <a name="sam-cli-command-reference-sam-init-options-architecture"></a>
A arquitetura do conjunto de instruções para as funções do Lambda do seu aplicativo. Especifique um dos `x86_64` ou `arm64`.

`--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]`  <a name="sam-cli-command-reference-sam-init-options-base-image"></a>
A imagem base do seu aplicativo. Essa opção se aplica somente quando o tipo de pacote é `Image`.  
Esse parâmetro é necessário se `--no-interactive` for especificado, `--package-type` for especificado como `Image` e `--location` não for especificado.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-init-options-debug"></a>
Ativa o registro de depuração para imprimir as mensagens de depuração que o AWS SAM CLI gera e para exibir timestamps.

`--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]`  <a name="sam-cli-command-reference-sam-init-options-dependency-manager"></a>
O gerenciador de dependências do seu tempo de execução do Lambda.

`--extra-content`  <a name="sam-cli-command-reference-sam-init-options-extra-content"></a>
Substitua quaisquer parâmetros personalizados na configuração `cookiecutter.json` do modelo, por exemplo, `{"customParam1": "customValue1", "customParam2":"customValue2"}`.

`--help, -h`  <a name="sam-cli-command-reference-sam-init-options-help"></a>
Mostra esta mensagem e sai.

`--location, -l TEXT`  <a name="sam-cli-command-reference-sam-init-options-location"></a>
O local doo modelo ou aplicativo (Git, Mercurial, HTTP/HTTPS, arquivo.zip, caminho).  
Esse parâmetro é necessário se `--no-interactive` for especificado e `--runtime`,`--name`, e `--app-template` não for fornecido.  
Para repositórios Git, você deve usar a localização da raiz do repositório.  
Para caminhos locais, o modelo deve estar no formato de arquivo.zip ou [Cookiecutter](https://cookiecutter.readthedocs.io/en/latest/README.html).

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-init-options-name"></a>
O nome do seu projeto a ser gerado como um diretório.  
Esse parâmetro é obrigatório se `--no-interactive` for especificado e `--location` não for fornecido.

`--no-input`  <a name="sam-cli-command-reference-sam-init-options-no-input"></a>
Desativa a solicitação do Cookiecutter e aceita os valores vcfdefault que são definidos na configuração do modelo.

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
Desative a solicitação interativa para os parâmetros de inicialização e falha se algum valor necessário estiver ausente.

`--output-dir, -o PATH`  <a name="sam-cli-command-reference-sam-init-options-output-dir"></a>
O local em que o aplicativo inicializado é gerado.

`--package-type [ Zip | Image ]`  <a name="sam-cli-command-reference-sam-init-options-package-type"></a>
O tipo de pacote do aplicativo de exemplo. `Zip` cria um arquivo .zip e `Image` cria uma imagem de contêiner.

`--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java11 | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.4 | ruby3.3 | ruby3.2 ]`  <a name="sam-cli-command-reference-sam-init-options-runtime"></a>
O tempo de execução do Lambda do seu aplicativo. Essa opção se aplica somente quando o tipo de pacote é `Zip`.  
Esse parâmetro é necessário se `--no-interactive` for especificado, `--package-type` for especificado como `Zip` e `--location` não for especificado.

`--save-params`  <a name="sam-cli-command-reference-sam-init-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--tracing | --no-tracing`  <a name="sam-cli-command-reference-sam-init-options-tracing"></a>
Ative o AWS X-Ray rastreamento para suas funções do Lambda.

## Exemplo
<a name="sam-cli-command-reference-sam-init-examples"></a>

Para obter um exemplo detalhado e uma explicação aprofundada sobre o uso do subcomando `sam init`, consulte [Crie seu aplicativo em AWS SAM](using-sam-cli-init.md).

# sam list
<a name="sam-cli-command-reference-sam-list"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam list`.

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O comando `sam list` gera informações importantes sobre os recursos em seu aplicativo sem servidor e o estado do seu aplicativo sem servidor. Use **sam list** antes e depois da implantação para ajudar durante o desenvolvimento local e na nuvem.

## Usage
<a name="sam-cli-command-reference-sam-list-usage"></a>

```
$ sam list <options> <subcommand>
```

## Opções
<a name="sam-cli-command-reference-sam-list-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-list-options-help"></a>
Mostre esta mensagem e saia.

## Subcomandos
<a name="sam-cli-command-reference-sam-list-subcommands"></a>

`endpoints`  <a name="sam-cli-command-reference-sam-list-subcommands-endpoints"></a>
Exibe uma lista de endpoints locais e de nuvem da sua CloudFormation pilha. Para obter mais informações, consulte [sam list endpoints](sam-cli-command-reference-sam-list-endpoints.md).

`resources`  <a name="sam-cli-command-reference-sam-list-subcommands-resources"></a>
Exibe os recursos em seu modelo AWS Serverless Application Model (AWS SAM) que são criados AWS CloudFormation na implantação. Para obter mais informações, consulte [sam list resources](sam-cli-command-reference-sam-list-resources.md).

`stack-outputs`  <a name="sam-cli-command-reference-sam-list-subcommands-stack-outputs"></a>
Exibe as saídas da sua CloudFormation pilha a partir de um modelo AWS SAM ou CloudFormation . Para obter mais informações, consulte [sam list stack-outputs](sam-cli-command-reference-sam-list-stack-outputs.md).

# sam list endpoints
<a name="sam-cli-command-reference-sam-list-endpoints"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam list endpoints` subcomando Command Line Interface (AWS SAMCLI).

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam list endpoints` subcomando exibe uma lista de endpoints locais e de nuvem da sua CloudFormation pilha. Você pode interagir com esses recursos por meio dos comandos **sam local** e **sam sync**.

AWS Lambda e os tipos de recursos do Amazon API Gateway são compatíveis com esse comando.

**nota**  
Domínios personalizados são suportados quando configurados para seus recursos do Amazon API Gateway. Esse comando exibirá o domínio personalizado em vez do endpoint padrão.

## Usage
<a name="sam-cli-command-reference-sam-list-endpoints-usage"></a>

```
$ sam list endpoints <options>
```

## Opções
<a name="sam-cli-command-reference-sam-list-endpoints-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados.  
*Valor padrão*: `default`  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados.  
*Valor padrão*: O `samconfig.toml` no diretório de trabalho atual.  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-endpoints-options-debug"></a>
Ative o registro de depuração para imprimir mensagens de depuração geradas pelo AWS SAMCLI com timestamps.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-endpoints-options-help"></a>
Mostre esta mensagem e saia.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-endpoints-options-output"></a>
Especifique o formato para gerar resultados.  
*Valor padrão*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-profile"></a>
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-region"></a>
Defina a AWS região do serviço. Por exemplo, .`us-east-1`

`--save-params`  <a name="sam-cli-command-reference-sam-list-endpoints-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-stack-name"></a>
Nome da CloudFormation pilha implantada. O nome da pilha pode ser encontrado no `samconfig.toml` arquivo do seu aplicativo ou no arquivo de configuração designado.  
Quando essa opção não for especificada, os recursos locais definidos em seu modelo serão exibidos.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-endpoints-options-template"></a>
AWS SAM arquivo de modelo.  
*Valor padrão*: `template.[yaml|yml|json]`

## Exemplos
<a name="sam-cli-command-reference-sam-list-endpoints-examples"></a>

Exiba uma saída, no formato json, dos endpoints de recursos implantados da sua CloudFormation pilha chamada. `test-stack`

```
$ sam list endpoints --stack-name test-stack --output json
			
[
  {
    "LogicalResourceId": "HelloWorldFunction",
    "PhysicalResourceId": "sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq",
    "CloudEndpoint": "https://zt55oi7kbljxjmcoahsj3cknwu0rposq.lambda-url.us-east-1.on.aws/",
    "Methods": "-"
  },
  {
    "LogicalResourceId": "ServerlessRestApi",
    "PhysicalResourceId": "uj80uoe2o2",
    "CloudEndpoint": [
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Prod",
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Stage"
    ],
    "Methods": [
      "/hello['get']"
    ]
  }
]
```

# sam list resources
<a name="sam-cli-command-reference-sam-list-resources"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam list resources` subcomando Command Line Interface (AWS SAMCLI).

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam list resources` subcomando exibe os recursos em seu modelo AWS Serverless Application Model (AWS SAM) que são criados AWS CloudFormation pela AWS SAM transformação na implantação.

Use **sam list resources** com um AWS SAM modelo antes da implantação para ver os recursos que serão criados. Forneça um nome de CloudFormation pilha para visualizar uma lista consolidada que inclui recursos implantados.

**nota**  
Para gerar uma lista de recursos do seu AWS SAM modelo, uma transformação local do seu modelo é executada. Os recursos que serão implantados sob condições, como em uma região específica, estão incluídos nessa lista.

## Usage
<a name="sam-cli-command-reference-sam-list-resources-usage"></a>

```
$ sam list resources <options>
```

## Opções
<a name="sam-cli-command-reference-sam-list-resources-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados.  
*Valor padrão*: `default`  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados.  
*Valor padrão*: O `samconfig.toml` no diretório de trabalho atual.  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
Ative o registro de depuração para imprimir mensagens de depuração geradas pelo AWS SAMCLI com timestamps.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
Mostre esta mensagem e saia.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
Especifique o formato para gerar resultados.  
*Valor padrão*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
Defina a AWS região do serviço. Por exemplo, .`us-east-1`

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
Nome da CloudFormation pilha implantada. O nome da pilha pode ser encontrado no `samconfig.toml` arquivo do seu aplicativo ou no arquivo de configuração designado.  
Quando fornecida, a lógica IDs do recurso do seu modelo será mapeada para a entrada física IDs correspondente. CloudFormation Para saber mais sobre física IDs, consulte [Campos de recursos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields) no *Guia AWS CloudFormation do usuário*.  
Quando essa opção não for especificada, os recursos locais definidos em seu modelo serão exibidos.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM arquivo de modelo.  
*Valor padrão*: `template.[yaml|yml|json]`

## Exemplos
<a name="sam-cli-command-reference-sam-list-resources-examples"></a>

Exiba uma saída, em formato de tabela, dos recursos locais do seu AWS SAM modelo e dos recursos implantados da sua CloudFormation pilha chamada. `test-stack` Execute no mesmo diretório do seu modelo local.

```
$ sam list resources --stack-name test-stack --output table
			
-------------------------------------------------------------------------------------------------------------------------
Logical ID                                                   Physical ID
-------------------------------------------------------------------------------------------------------------------------
HelloWorldFunction                                           sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq
HelloWorldFunctionHelloWorldPermissionProd                   sam-app-test-list-
                                                             HelloWorldFunctionHelloWorldPermissionProd-1QH7CPOCBL2IK
HelloWorldFunctionRole                                       sam-app-test-list-HelloWorldFunctionRole-SRJDMJ6F7F41
ServerlessRestApi                                            uj80uoe2o2
ServerlessRestApiDeployment47fc2d5f9d                        pncw5f
ServerlessRestApiProdStage                                   Prod
ServerlessRestApiDeploymentf5716dc08b                        -
-------------------------------------------------------------------------------------------------------------------------
```

# sam list stack-outputs
<a name="sam-cli-command-reference-sam-list-stack-outputs"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam list stack-outputs` subcomando Command Line Interface (AWS SAMCLI).

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam list stack-outputs` subcomando exibe as saídas da sua AWS CloudFormation pilha a partir de um AWS Serverless Application Model (AWS SAM) ou modelo. CloudFormation Para obter mais informações sobre `Outputs`, consulte [Resultados](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html) no *Guia do usuário do AWS CloudFormation *.

## Usage
<a name="sam-cli-command-reference-sam-list-stack-outputs-usage"></a>

```
$ sam list stack-outputs <options>
```

## Opções
<a name="sam-cli-command-reference-sam-list-stack-outputs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados.  
*Valor padrão*: `default`  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados.  
*Valor padrão*: O `samconfig.toml` no diretório de trabalho atual.  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-debug"></a>
Ative o registro de depuração para imprimir mensagens de depuração geradas pelo AWS SAMCLI com timestamps.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-help"></a>
Mostre esta mensagem e saia.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-output"></a>
Especifique o formato para gerar resultados.  
*Valor padrão*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-profile"></a>
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-region"></a>
Defina a AWS região do serviço. Por exemplo, .`us-east-1`

`--save-params`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-"></a>
Nome da CloudFormation pilha implantada. O nome da pilha pode ser encontrado no `samconfig.toml` arquivo do seu aplicativo ou no arquivo de configuração designado.  
Essa opção é obrigatória.

## Exemplos
<a name="sam-cli-command-reference-sam-list-stack-outputs-examples"></a>

Exibe as saídas, em formato de tabela, dos recursos em sua CloudFormation pilha denominados. `test-stack`

```
$ sam list stack-outputs --stack-name test-stack --output table
			
------------------------------------------------------------------------------------------------------------------------
OutputKey                                OutputValue                              Description
------------------------------------------------------------------------------------------------------------------------
HelloWorldFunctionIamRole                arn:aws:iam::account-number:role/sam-      Implicit IAM Role created for Hello
                                         app-test-list-HelloWorldFunctionRole-    World function
                                         SRJDMJ6F7F41
HelloWorldApi                            https://uj80uoe2o2.execute-api.us-       API Gateway endpoint URL for Prod
                                         east-1.amazonaws.com/Prod/hello/         stage for Hello World function
HelloWorldFunction                       arn:aws:lambda:us-                       Hello World Lambda Function ARN
                                         east-1:account-number:function:sam-app-
                                         test-list-
                                         HelloWorldFunction-H85Y7yIV7ZLq
------------------------------------------------------------------------------------------------------------------------
```

# sam local callback
<a name="sam-cli-command-reference-sam-local-callback"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam local callback`.

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam local callback` comando permite que você envie retornos de chamada para execuções de funções duráveis locais durante o desenvolvimento e o teste.

## Usage
<a name="sam-cli-command-reference-sam-local-callback-usage"></a>

```
$ sam local callback <subcommand> <options>
```

## Opções
<a name="sam-cli-command-reference-sam-local-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-callback-options-help"></a>
Mostre esta mensagem e saia.

## Subcomandos
<a name="sam-cli-command-reference-sam-local-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-succeed"></a>
Envie um retorno de chamada bem-sucedido para uma execução de função durável. Para obter mais informações, consulte [sam local callback succeed](sam-cli-command-reference-sam-local-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-fail"></a>
Envie um retorno de chamada de falha para uma execução de função durável. Para obter mais informações, consulte [sam local callback fail](sam-cli-command-reference-sam-local-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-heartbeat"></a>
Envie um retorno de chamada de pulsação para uma execução de função durável. Para obter mais informações, consulte [sam local callback heartbeat](sam-cli-command-reference-sam-local-callback-heartbeat.md).

# sam local callback succeed
<a name="sam-cli-command-reference-sam-local-callback-succeed"></a>

Envie um retorno de chamada bem-sucedido para uma execução de função durável.

## Usage
<a name="ref-sam-cli-local-callback-succeed-usage"></a>

```
$ sam local callback succeed CALLBACK_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-local-callback-succeed-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma resposta bem-sucedida.

## Opções
<a name="ref-sam-cli-local-callback-succeed-options"></a>

`-r, --result TEXT`  
Carga útil do resultado de sucesso como string.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-callback-succeed-examples"></a>

Envie um retorno de chamada bem-sucedido sem resultado:

```
$ sam local callback succeed my-callback-id
```

Envie um retorno de chamada de sucesso com o resultado:

```
$ sam local callback succeed my-callback-id --result 'Task completed successfully'
```

Envie um retorno de chamada bem-sucedido com a opção curta:

```
$ sam local callback succeed my-callback-id -r 'Success result'
```

# sam local callback fail
<a name="sam-cli-command-reference-sam-local-callback-fail"></a>

Envie um retorno de chamada de falha para uma execução de função durável.

## Usage
<a name="ref-sam-cli-local-callback-fail-usage"></a>

```
$ sam local callback fail CALLBACK_ID [OPTIONS]
```

## Argumentos necessários
<a name="ref-sam-cli-local-callback-fail-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma resposta de falha.

## Opções
<a name="ref-sam-cli-local-callback-fail-options"></a>

`--error-data TEXT`  
Dados de erro adicionais.

`--stack-trace TEXT`  
Entradas de rastreamento de pilha. Essa opção pode ser especificada várias vezes.

`--error-type TEXT`  
Tipo de erro.

`--error-message TEXT`  
Mensagem de erro detalhada.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-callback-fail-examples"></a>

Enviar retorno de chamada de falha sem parâmetros:

```
$ sam local callback fail my-callback-id
```

Enviar retorno de chamada de falha com mensagem de erro:

```
$ sam local callback fail my-callback-id --error-message 'Task failed'
```

Envie um retorno de chamada de falha com todos os parâmetros:

```
$ sam local callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam local callback heartbeat
<a name="sam-cli-command-reference-sam-local-callback-heartbeat"></a>

Envie um retorno de chamada de pulsação para uma execução de função durável.

## Usage
<a name="ref-sam-cli-local-callback-heartbeat-usage"></a>

```
$ sam local callback heartbeat CALLBACK_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-local-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma pulsação.

## Opções
<a name="ref-sam-cli-local-callback-heartbeat-options"></a>

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-callback-heartbeat-examples"></a>

Enviar retorno de chamada de pulsação:

```
$ sam local callback heartbeat my-callback-id
```

# sam local execution
<a name="sam-cli-command-reference-sam-local-execution"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam local execution`.

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam local execution` comando permite gerenciar e inspecionar as execuções de funções duráveis locais durante o desenvolvimento e o teste.

**nota**  
Esses comandos podem não exigir acesso às AWS credenciais.

## Usage
<a name="sam-cli-command-reference-sam-local-execution-usage"></a>

```
$ sam local execution <subcommand> <options>
```

## Opções
<a name="sam-cli-command-reference-sam-local-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-execution-options-help"></a>
Mostre esta mensagem e saia.

## Subcomandos
<a name="sam-cli-command-reference-sam-local-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-get"></a>
Obtenha detalhes de uma execução de função durável. Para obter mais informações, consulte [sam local execution get](sam-cli-command-reference-sam-local-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-history"></a>
Obtenha o histórico de execução de uma função durável. Para obter mais informações, consulte [sam local execution history](sam-cli-command-reference-sam-local-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-stop"></a>
Interrompa a execução de uma função durável. Para obter mais informações, consulte [sam local execution stop](sam-cli-command-reference-sam-local-execution-stop.md).

# sam local execution get
<a name="sam-cli-command-reference-sam-local-execution-get"></a>

Recupere os detalhes da execução de uma função durável específica.

**nota**  
Esse comando pode não exigir acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-local-execution-get-usage"></a>

```
$ sam local execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-local-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
O Amazon Resource Name (ARN) da execução da função durável para a qual recuperar detalhes.

## Opções
<a name="ref-sam-cli-local-execution-get-options"></a>

`--format [summary|json]`  
Formato de saída. Padrão: `summary`

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar os recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-execution-get-examples"></a>

Obtenha detalhes da execução com o formato de resumo padrão:

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Obtenha detalhes da execução no formato JSON:

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam local execution history
<a name="sam-cli-command-reference-sam-local-execution-history"></a>

Obtenha o histórico de execução de uma função durável.

## Usage
<a name="ref-sam-cli-local-execution-history-usage"></a>

```
$ sam local execution history EXECUTION_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-local-execution-history-arguments"></a>

`EXECUTION_ID`  
O identificador exclusivo da execução durável da função para a qual recuperar o histórico.

## Opções
<a name="ref-sam-cli-local-execution-history-options"></a>

`--format [table|json]`  
Formato de saída. Padrão: `table`

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-execution-history-examples"></a>

Obtenha o histórico de execução em formato de tabela:

```
$ sam local execution history my-execution-id
```

Obtenha o histórico de execução no formato JSON:

```
$ sam local execution history my-execution-id --format json
```

# sam local execution stop
<a name="sam-cli-command-reference-sam-local-execution-stop"></a>

Interrompa a execução de uma função durável em execução.

**nota**  
Esse comando pode não exigir acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-local-execution-stop-usage"></a>

```
$ sam local execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-local-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
O Amazon Resource Name (ARN) da execução da função durável a ser interrompida.

## Opções
<a name="ref-sam-cli-local-execution-stop-options"></a>

`--error-message TEXT`  
Mensagem de erro a ser associada à execução interrompida.

`--error-type TEXT`  
Tipo de erro a ser associado à execução interrompida.

`--error-data TEXT`  
Dados de erro a serem associados à execução interrompida.

`--stack-trace TEXT`  
Entradas de rastreamento de pilha. Essa opção pode ser especificada várias vezes.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-execution-stop-examples"></a>

Pare a execução sem detalhes de erro:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Pare a execução com mensagem de erro e digite:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Pare a execução com detalhes completos do erro e rastreamento de pilha:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam local generate-event
<a name="sam-cli-command-reference-sam-local-generate-event"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam local generate-event` subcomando Command Line Interface (AWS SAMCLI).
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam local generate-event` comando, consulte[Introdução aos testes com sam local generate-event](using-sam-cli-local-generate-event.md).

O subcomando `sam local generate-event` gera amostras de carga útil de eventos para suporte Serviços da AWS.

## Usage
<a name="ref-sam-cli-local-generate-event-usage"></a>

```
$ sam local generate-event <options> <service> <event> <event-options>
```

## Opções
<a name="ref-sam-cli-local-generate-event-options"></a>

`--config-env TEXT`  <a name="ref-sam-cli-local-generate-event-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-generate-event-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é `samconfig.toml` na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--help`  <a name="ref-sam-cli-local-generate-event-options-help"></a>
Mostra esta mensagem e sai.

## Serviço
<a name="ref-sam-cli-local-generate-event-service"></a>

Para visualizar uma lista de serviços compatíveis, execute o comando a seguir:

```
$ sam local generate-event
```

## Event
<a name="ref-sam-cli-local-generate-event-event"></a>

Para ver uma lista de eventos compatíveis que podem ser gerados para cada serviço, execute o seguinte:

```
$ sam local generate-event <service>
```

## Opções de eventos
<a name="ref-sam-cli-local-generate-event-event-options"></a>

Para ver uma lista das opções de eventos compatíveis que você pode modificar, execute o seguinte:

```
$ sam local generate-event <service> <event> --help
```

## Exemplos
<a name="sam-cli-command-reference-sam-local-generate-event-examples"></a>

Para obter exemplos sobre como usar o subcomando `sam local generate-event`, consulte [Gere eventos de exemplo](using-sam-cli-local-generate-event.md#using-sam-cli-local-generate-event-generate).

# sam local invoke
<a name="sam-cli-command-reference-sam-local-invoke"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam local invoke` subcomando Command Line Interface (AWS SAMCLI).
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam local invoke` subcomando, consulte[Introdução aos testes com sam local invoke](using-sam-cli-local-invoke.md).

O `sam local invoke` subcomando inicia uma invocação única de uma função localmente. AWS Lambda 

**nota**  
Não é recomendável usar os recursos de invocação local do SAM CLI em código não confiável. Para ter um isolamento completo do seu ambiente local, execute o código diretamente no serviço Lambda.

**nota**  
Para funções duráveis, `sam local invoke` suporta execução em estado com verificação e repetição automáticas. O contêiner permanece em execução durante a execução durável da função para lidar com a persistência e a retomada do estado.

## Usage
<a name="ref-sam-cli-local-invoke-usage"></a>

```
$ sam local invoke <arguments> <options>
```

**nota**  
Se você tiver mais de uma função definida em seu AWS SAM modelo, forneça a ID lógica da função que você deseja invocar.

## Argumentos
<a name="ref-sam-cli-local-invoke-args"></a>

**Resource ID (ID do recurso)**  <a name="ref-sam-cli-local-invoke-args-resource-id"></a>
O ID da função do Lambda a ser invocada.  
Esse argumento é opcional. Se seu aplicativo contiver uma única função Lambda, a AWS SAM CLI a invocará. Se seu aplicativo contiver várias funções, forneça o ID da função a ser invocada.  
*Valores válidos*: o ID lógico do recurso ou o ARN do recurso.

## Opções
<a name="ref-sam-cli-local-invoke-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-invoke-options-add-host"></a>
Passa um nome de host para mapeamento de endereço IP para o arquivo host do contêiner do Docker. Esse parâmetro pode ser passado várias vezes.  

**Example**  
Exemplo: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-invoke-options-beta-features"></a>
Permita ou negue recursos beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-invoke-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-invoke-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-invoke-options-container-env-vars"></a>
(Opcional) Passe variáveis de ambiente para o contêiner de imagem da função do Lambda ao depurar localmente.

`--container-host TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host"></a>
Host do contêiner Lambda emulado localmente. O valor padrão é `localhost`. Se você quiser executar AWS SAMCLI em um contêiner do Docker no macOS, você pode especificar `host.docker.internal`. Se você quiser executar o contêiner em um host diferente AWS SAMCLI, você pode especificar o endereço IP do host remoto.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host-interface"></a>
O endereço IP da interface de rede do host à qual as portas do contêiner devem se vincular. O valor padrão é `127.0.0.1`. Use `0.0.0.0` para vincular a todas as interfaces.

`--debug`  <a name="ref-sam-cli-local-invoke-options-debug"></a>
Ativa o registro de depuração para imprimir mensagens de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--debug-args TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-args"></a>
Argumentos adicionais a serem transmitidos para o depurador.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-port"></a>
Quando especificado, inicia o contêiner da função do Lambda no modo de depuração e expõe essa porta no host local.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-invoke-options-debugger-path"></a>
O caminho do host para um depurador montado no contêiner Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-network"></a>
Especifica o nome ou ID de uma rede Docker existente à qual os contêineres do Docker do Lambda devem se conectar, juntamente com a rede de ponte padrão. Se não for especificado, os contêineres do Lambda se conectarão somente à rede de Docker de ponte padrão.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-volume-basedir"></a>
A localização do diretório base em que o AWS SAM arquivo existe. Se o Docker estiver sendo executado em uma máquina remota, você deverá montar o caminho em que o AWS SAM arquivo existe na máquina Docker e modificar esse valor para corresponder à máquina remota.

`--durable-execution-name TEXT`  <a name="ref-sam-cli-local-invoke-options-durable-execution-name"></a>
Nome da execução durável (somente para funções duráveis)

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-invoke-options-env-vars"></a>
O JSON ou `.env` arquivo que contém valores para as variáveis de ambiente da função Lambda. O formato do arquivo é detectado automaticamente. Para obter mais informações sobre variáveis de ambiente, consulte [Arquivo de variável de ambiente](serverless-sam-cli-using-invoke.md#serverless-sam-cli-using-invoke-environment-file).

`--event, -e PATH`  <a name="ref-sam-cli-local-invoke-options-event"></a>
O arquivo JSON que contém dados de eventos que são passados para a função do Lambda quando ela é invocada. Se você não especificar essa opção, nenhum evento será assumido. Para inserir JSON de`stdin`, você deve passar o valor '-'. Para obter detalhes sobre formatos de mensagens de eventos de diferentes AWS serviços, consulte Como [trabalhar com outros serviços](https://docs.aws.amazon.com/lambda/latest/dg/lambda-services.html) no *Guia do AWS Lambda desenvolvedor*.

`--force-image-build`  <a name="ref-sam-cli-local-invoke-options-force-image-build"></a>
Especifica se o AWS SAMCLI deve reconstruir a imagem usada para invocar função do Lambda com camadas.

`--help`  <a name="ref-sam-cli-local-invoke-options-help"></a>
Mostra esta mensagem e sai.

`--hook-name TEXT`  <a name="ref-sam-cli-local-invoke-options-hook-name"></a>
O nome do hook usado para estender a funcionalidade AWS SAMCLI.  
Valores aceitos: `terraform`.

`--invoke-image TEXT`  <a name="ref-sam-cli-local-invoke-options-invoke-image"></a>
O URI da imagem do contêiner que você deseja usar para a invocação da função local. Por padrão, o AWS SAM extrai a imagem de contêiner do Amazon ECR Public (que está listada em [Repositórios de imagens para AWS SAM](serverless-image-repositories.md)). Use essa opção para extrair a imagem de outro localização.  
Por exemplo, .`sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8`

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-invoke-options-layer-cache-basedir"></a>
Especifica a localização do diretório base onde as camadas que seu modelo usa são baixadas.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-invoke-options-log-file"></a>
O arquivo de log para o qual enviar os registros de runtime.

`--mount-symlinks`  <a name="ref-sam-cli-local-invoke-options-mount-symlinks"></a>
Garante que a CLI do AWS SAM sempre monte symlinks que estão presentes nos arquivos a serem criados ou invocados. Isso se aplica somente aos symlinks no diretório de nível superior (ou seja, links simbólicos que estão diretamente na raiz da função). Por padrão, os symlinks não são montados, exceto aqueles necessários para usar o `build-in-source` no `node_modules` no NodeJS.

`--no-event`  <a name="ref-sam-cli-local-invoke-options-no-event"></a>
Invoca a função com um evento vazio.

`--no-memory-limit`  <a name="ref-sam-cli-local-invoke-options-no-memory-limit"></a>
Remove a limitação de memória no contêiner durante a chamada local, mesmo quando a memória está configurada no AWS SAM modelo.

`--parameter-overrides`  <a name="ref-sam-cli-local-invoke-options-parameter-overrides"></a>
Uma string que contém substituições de CloudFormation parâmetros codificadas como pares de valores-chave. Use o mesmo formato do AWS Command Line Interface (AWS CLI). O formato da CLI do AWS SAMé uma palavra-chave explícita de chave e valor e cada substituição é separada por um espaço. Veja dois exemplos a seguir:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--profile TEXT`  <a name="ref-sam-cli-local-invoke-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="ref-sam-cli-local-invoke-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--runtime TEXT`  <a name="ref-sam-cli-local-invoke-options-runtime"></a>
Usa o runtime especificado para invocar uma função do Lambda localmente. Isso substitui o runtime definido no arquivo `template.yml`. Isso também permite testar as funções do Lambda com diferentes tempos de execução sem modificar a configuração original da função.

`--save-params`  <a name="ref-sam-cli-local-invoke-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--shutdown`  <a name="ref-sam-cli-local-invoke-options-shutdown"></a>
Emula um evento de desligamento após a conclusão da invocação, a fim de testar o tratamento da extensão sobre o comportamento de desligamento.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-invoke-options-skip-prepare-infra"></a>
Ignora a fase de preparação se nenhuma alteração na infraestrutura tiver sido feita. Execute com a opção `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-local-invoke-options-skip-pull-image"></a>
Por padrão, ele AWS SAMCLI verifica o ambiente de runtime remoto mais recente do Lambda e atualiza sua imagem local automaticamente para se manter sincronizada.  
Especifique essa opção para pular a remoção da Docker imagem mais recente para seu ambiente de runtime do Lambda.

`--template, -t PATH`  <a name="ref-sam-cli-local-invoke-options-template"></a>
O arquivo AWS SAM de modelo.  
Essa opção não é compatível com o `--hook-name`.  
Se você especificar essa opção, AWS SAM carrega somente o modelo e os recursos locais para os quais ele aponta.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
O ID do locatário para funções Lambda de vários locatários. Usado para garantir o isolamento computacional entre diferentes inquilinos. Obrigatório ao invocar funções configuradas com o modo de isolamento do inquilino.

`--terraform-plan-file`  <a name="ref-sam-cli-local-invoke-options-terraform-plan-file"></a>
O caminho relativo ou absoluto para seu arquivo de Terraform plano local ao usar o AWS SAMCLI com Terraform Cloud. Essa opção exige que `--hook-name` seja definida como `terraform`.

## Exemplos
<a name="sam-cli-command-reference-sam-local-invoke-examples"></a>

O exemplo a seguir usa um evento gerado para testes locais usando um evento `s3.json` para invocar uma função do Lambda localmente

```
$ sam local invoke --event events/s3.json S3JsonLoggerFunction
```

O exemplo a seguir testa a função ` HelloWorldFunction` usando o runtime do Python 3.11

```
$ sam local invoke --runtime python3.11 HelloWorldFunction
```

O exemplo a seguir testa a função ` HelloWorldFunction` com nome de execução durável

```
$ sam local invoke HelloWorldFunction --durable-execution-name my-execution
```

# sam local start-api
<a name="sam-cli-command-reference-sam-local-start-api"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam local start-api` subcomando Command Line Interface (AWS SAMCLI).
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam local start-api` subcomando, consulte[Introdução aos testes com sam local start-api](using-sam-cli-local-start-api.md).

O `sam local start-api` subcomando executa suas AWS Lambda funções localmente para testar por meio de um host de servidor HTTP local.

## Usage
<a name="ref-sam-cli-local-start-api-usage"></a>

```
$ sam local start-api <options>
```

## Opções
<a name="ref-sam-cli-local-start-api-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-api-options-add-host"></a>
Passa um nome de host para mapeamento de endereço IP para o arquivo host do contêiner do Docker. Esse parâmetro pode ser passado várias vezes.  

**Example**  
Exemplo: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-api-options-beta-features"></a>
Permita ou negue recursos beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-api-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-api-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-api-options-container-env-vars"></a>
Opcional. Passe variáveis de ambiente para o contêiner de imagem ao depurar localmente.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host"></a>
Host do contêiner Lambda emulado localmente. O valor padrão é `localhost`. Se você quiser executar AWS SAMCLI em um contêiner do Docker no macOS, você pode especificar `host.docker.internal`. Se você quiser executar o contêiner em um host diferente AWS SAMCLI, você pode especificar o endereço IP do host remoto.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host-interface"></a>
O endereço IP da interface de rede do host à qual as portas do contêiner devem se vincular. O valor padrão é `127.0.0.1`. Use `0.0.0.0` para vincular a todas as interfaces.

`--debug`  <a name="ref-sam-cli-local-start-api-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração gerada pelo AWS SAMCLI e exibir timestamps.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-args"></a>
Argumentos adicionais a serem transmitidos para o depurador.

`--debug-function`  <a name="ref-sam-cli-local-start-api-options-debug-function"></a>
Opcional. Especifica a função do Lambda para aplicar opções de depuração quando for especificado como `--warm-containers`. Esse parâmetro se aplica a `--debug-port`, `--debugger-path` e `--debug-args`.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-port"></a>
Quando especificado, inicia o contêiner da função do Lambda no modo de depuração e expõe essa porta no host local.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-api-options-debugger-path"></a>
O caminho do host para um depurador que será montado no contêiner Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-network"></a>
Especifica o nome ou ID de uma rede Docker existente à qual os contêineres do Docker do Lambda devem se conectar, juntamente com a rede de ponte padrão. Se não for especificado, os contêineres do Lambda se conectarão somente à rede de Docker de ponte padrão.

` --docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-volume-basedir"></a>
A localização do diretório base em que o AWS SAM arquivo existe. Se o Docker estiver sendo executado em uma máquina remota, você deverá montar o caminho em que o AWS SAM arquivo existe na máquina Docker e modificar esse valor para corresponder à máquina remota.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-api-options-env-vars"></a>
O JSON ou `.env` arquivo que contém valores para as variáveis de ambiente da função Lambda. O formato do arquivo é detectado automaticamente.

`--force-image-build`  <a name="ref-sam-cli-local-start-api-options-force-image-build"></a>
Especifica se AWS SAM CLI deve reconstruir a imagem usada para invocar funções com camadas.

`--help`  <a name="ref-sam-cli-local-start-api-options-help"></a>
Mostra esta mensagem e sai.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-api-options-hook-name"></a>
O nome do hook usado para estender a funcionalidade AWS SAMCLI.  
Valores aceitos: `terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-api-options-host"></a>
O nome do host local ou endereço IP ao qual se vincular (padrão: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-api-options-invoke-image"></a>
O URI da imagem de contêiner que você deseja usar para suas funções do Lambda. Por padrão, AWS SAM extrai a imagem do contêiner do Amazon ECR Public. Use essa opção para extrair a imagem de outro localização.  
Especifique essa opção várias vezes. Cada instância dessa opção pode ter uma string ou um par de valores-chave. Se você especificar uma string, ela será a URI da imagem do contêiner a ser usada para todas as funções em seu aplicativo. Por exemplo, `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8`. Se você especificar um par de valores-chave, a chave será o nome do recurso e o valor será o URI da imagem do contêiner a ser usada para esse recurso. Por exemplo `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8 `. Com pares de valores-chave, você pode especificar imagens de contêiner diferentes para recursos diferentes.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-api-options-layer-cache-basedir"></a>
Especifica a localização com base na qual as camadas que seu modelo usa são baixadas.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-api-options-log-file"></a>
O arquivo de log para o qual enviar os registros de runtime.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-api-options-no-memory-limit"></a>
Remove a limitação de memória no contêiner durante a chamada local, mesmo quando a memória está configurada no AWS SAM modelo.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-api-options-parameter-overrides"></a>
Uma string que contém substituições de CloudFormation parâmetros codificadas como pares de valores-chave. Use o mesmo formato do AWS Command Line Interface (AWS CLI). O formato da CLI do AWS SAMé uma palavra-chave explícita de chave e valor e cada substituição é separada por um espaço. Veja dois exemplos a seguir:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-api-options-port"></a>
O número da porta local para escutar (padrão: '3000').

`--profile TEXT`  <a name="ref-sam-cli-local-start-api-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="ref-sam-cli-local-start-api-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-api-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--shutdown`  <a name="ref-sam-cli-local-start-api-options-shutdown"></a>
Emula um evento de desligamento após a conclusão da invocação, a fim de testar o tratamento da extensão sobre o comportamento de desligamento.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-api-options-skip-prepare-infra"></a>
Ignora a fase de preparação se nenhuma alteração na infraestrutura tiver sido feita. Execute com a opção `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-api-options-skip-pull-image"></a>
Especifica se o comando deve ignorar a extração da imagem mais recente do Docker para o runtime do Lambda.

`--ssl-cert-file PATH`  <a name="ref-sam-cli-local-start-api-options-ssl-cert-file"></a>
Caminho para o arquivo do certificado SSL (padrão: Nenhum). Ao usar essa opção, a opção `--ssl-key-file` também deve ser usada.

`--ssl-key-file PATH`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Caminho para o arquivo de chave SSL (padrão: Nenhum). Ao usar essa opção, a opção `--ssl-cert-file` também deve ser usada.

`--static-dir, -s TEXT`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Todos os arquivos de ativos estáticos (por exemplo,CSS/JavaScript/HTML) localizados nesse diretório são apresentados em`/`.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-api-options-template"></a>
O arquivo AWS SAM de modelo.  
Se você especificar essa opção, AWS SAM carrega somente o modelo e os recursos locais para os quais ele aponta.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-api-options-terraform-plan-file"></a>
O caminho relativo ou absoluto para seu arquivo de Terraform plano local ao usar o AWS SAMCLI com Terraform Cloud. Essa opção exige que `--hook-name` seja definida como `terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-api-options-warm-containers"></a>
Opcional. Especifica como AWS SAMCLI gerencia os contêineres para cada função.  
Existem duas opções:  
   `EAGER`: os contêineres de todas as funções são carregados na inicialização e persistem entre as invocações.  
   `LAZY`: os contêineres são carregados somente quando cada função é invocada pela primeira vez. Esses contêineres persistem para invocações adicionais.

## Exemplo
<a name="sam-cli-command-reference-sam-local-start-api-examples"></a>

O exemplo a seguir inicia um servidor local, permitindo que você teste a aplicação por meio da API. Para que esse comando funcione, a aplicação deve estar instalada e o Docker deve estar em execução.

```
$ sam local start-api --port 3000
```

# sam local start-lambda
<a name="sam-cli-command-reference-sam-local-start-lambda"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam local start-lambda` subcomando Command Line Interface (AWS SAMCLI).
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam local start-lambda` subcomando, consulte[Introdução aos testes com sam local start-lambda](using-sam-cli-local-start-lambda.md).

O subcomando `sam local start-lambda` inicia um endpoint local para emular AWS Lambda.

## Usage
<a name="ref-sam-cli-local-start-lambda-usage"></a>

```
$ sam local start-lambda <options>
```

## Opções
<a name="ref-sam-cli-local-start-lambda-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-lambda-options-add-host"></a>
Passa um nome de host para mapeamento de endereço IP para o arquivo host do contêiner do Docker. Esse parâmetro pode ser passado várias vezes.  

**Example**  
Exemplo: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-lambda-options-beta-features"></a>
Permita ou negue recursos beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-lambda-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-lambda-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-lambda-options-container-env-vars"></a>
Opcional. Passe variáveis de ambiente para o contêiner de imagem ao depurar localmente.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host"></a>
Host do contêiner Lambda emulado localmente. O valor padrão é `localhost`. Se você quiser executar AWS SAMCLI em um contêiner do Docker no macOS, você pode especificar `host.docker.internal`. Se você quiser executar o contêiner em um host diferente AWS SAMCLI, você pode especificar o endereço IP do host remoto.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host-interface"></a>
O endereço IP da interface de rede do host à qual as portas do contêiner devem se vincular. O valor padrão é `127.0.0.1`. Use `0.0.0.0` para vincular a todas as interfaces.

`--debug`  <a name="ref-sam-cli-local-start-lambda-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração gerada pelo AWS SAMCLI e exibir timestamps.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-args"></a>
Argumentos adicionais a serem transmitidos para o depurador.

`--debug-function`  <a name="ref-sam-cli-local-start-lambda-options-debug-function"></a>
Opcional. Especifica a função do Lambda para aplicar opções de depuração quando for especificado como `--warm-containers`. Esse parâmetro se aplica a `--debug-port`, `--debugger-path` e `--debug-args`.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-port"></a>
Quando especificado, inicia o contêiner da função do Lambda no modo de depuração e expõe essa porta no host local.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debugger-path"></a>
O caminho do host para um depurador a ser montado no contêiner Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-network"></a>
Especifica o nome ou ID de uma rede Docker existente à qual os contêineres do Docker do Lambda devem se conectar, juntamente com a rede de ponte padrão. Se não for especificado, os contêineres do Lambda se conectarão somente à rede de Docker de ponte padrão.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-volume-basedir"></a>
A localização do diretório base em que o AWS SAM arquivo existe. Se o Docker estiver sendo executado em uma máquina remota, você deverá montar o caminho em que o AWS SAM arquivo existe na máquina Docker e modificar esse valor para corresponder à máquina remota.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-lambda-options-env-vars"></a>
O JSON ou `.env` arquivo que contém valores para as variáveis de ambiente da função Lambda. O formato do arquivo é detectado automaticamente.

`--force-image-build`  <a name="ref-sam-cli-local-start-lambda-options-force-image-build"></a>
Especifique se CLI deve reconstruir a imagem usada para invocar funções com camadas.

`--help`  <a name="ref-sam-cli-local-start-lambda-options-help"></a>
Mostra esta mensagem e sai.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-lambda-options-hook-name"></a>
O nome do hook usado para estender a funcionalidade AWS SAMCLI.  
Valores aceitos: `terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-host"></a>
O nome do host local ou endereço IP ao qual se vincular (padrão: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-lambda-options-invoke-image"></a>
O URI da imagem do contêiner que você deseja usar para a invocação da função local. Por padrão, AWS SAM extrai a imagem do contêiner do Amazon ECR Public. Use essa opção para extrair a imagem de outro localização.  
Por exemplo, .`sam local start-lambda MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8`

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-lambda-options-layer-cache-basedir"></a>
Especifica a localização com base na qual as camadas que seu modelo usa são baixadas.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-lambda-options-log-file"></a>
O arquivo de log para o qual enviar os registros de runtime.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-lambda-options-no-memory-limit"></a>
Remove a limitação de memória no contêiner durante a chamada local, mesmo quando a memória está configurada no AWS SAM modelo.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-lambda-options-parameter-overrides"></a>
Uma string que contém substituições de CloudFormation parâmetros codificadas como pares de valores-chave. Use o mesmo formato do AWS Command Line Interface (AWS CLI). O formato da CLI do AWS SAMé uma palavra-chave explícita de chave e valor e cada substituição é separada por um espaço. Veja dois exemplos a seguir:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-lambda-options-port"></a>
O número da porta local para escutar (padrão: '3001').

`--profile TEXT`  <a name="ref-sam-cli-local-start-lambda-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="ref-sam-cli-local-start-lambda-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-lambda-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--shutdown`  <a name="ref-sam-cli-local-start-lambda-options-shutdown"></a>
Emula um evento de desligamento após a conclusão da invocação, a fim de testar o tratamento da extensão sobre o comportamento de desligamento.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-lambda-options-skip-prepare-infra"></a>
Ignora a fase de preparação se nenhuma alteração na infraestrutura tiver sido feita. Execute com a opção `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-lambda-options-skip-pull-image"></a>
Especifica se o comando CLI deve ignorar a extração da imagem do Docker mais recente para o runtime do Lambda.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-lambda-options-template"></a>
O arquivo AWS SAM de modelo.  
Se você especificar essa opção, AWS SAM carrega somente o modelo e os recursos locais para os quais ele aponta. Essa opção não é compatível com `--hook-name`.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-lambda-options-terraform-plan-file"></a>
O caminho relativo ou absoluto para seu arquivo de Terraform plano local ao usar o AWS SAMCLI com Terraform Cloud. Essa opção exige que `--hook-name` seja definida como `terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-lambda-options-warm-containers"></a>
Opcional. Especifica como AWS SAMCLI gerencia os contêineres para cada função.  
Existem duas opções:  
+ `EAGER`: os contêineres de todas as funções são carregados na inicialização e persistem entre as invocações.
+ `LAZY`: os contêineres são carregados somente quando cada função é invocada pela primeira vez. Esses contêineres persistem para invocações adicionais.

## Exemplo
<a name="sam-cli-command-reference-sam-local-start-lambda-examples"></a>

Para obter um exemplo detalhado e uma explicação aprofundada sobre o uso do subcomando `sam local start-lambda`, consulte [Introdução aos testes com sam local start-lambda](using-sam-cli-local-start-lambda.md).

# sam logs
<a name="sam-cli-command-reference-sam-logs"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam logs`.

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam logs` comando busca registros que são gerados por suas AWS Lambda funções.

## Usage
<a name="sam-cli-command-reference-sam-logs-usage"></a>

```
$ sam logs <options>
```

## Opções
<a name="sam-cli-command-reference-sam-logs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-logs-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Inclui registros dos grupos de CloudWatch registros de registros que você especifica. Se você especificar essa opção junto com`name`, AWS SAM incluirá registros dos grupos de registros especificados, além dos registros dos recursos nomeados.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração gerada pelo AWS SAMCLI e exibir timestamps.

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Busca registros até agora. A hora pode ser valores relativos, como '5 minutos atrás', 'amanhã' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'.

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Permite especificar uma expressão para encontrar rapidamente registros que correspondam a termos, frases ou valores nos seus eventos de log. Isso pode ser uma palavra-chave simples (por exemplo, “erro”) ou um padrão compatível com o Amazon CloudWatch Logs. Para a sintaxe, consulte a [documentação do Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).

`--help`  <a name="sam-cli-command-reference-sam-logs-options-help"></a>
Mostra esta mensagem e sai.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Inclui traços de X-Ray na saída do log.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
O nome do recurso para o qual buscar registros. Se esse recurso fizer parte de uma CloudFormation pilha, esse pode ser o ID lógico do recurso da função no AWS SAM modelo CloudFormation/. Vários nomes podem ser fornecidos repetindo o parâmetro novamente. Se o recurso estiver em uma pilha aninhada, o nome poderá ser precedido pelo nome da pilha aninhada para extrair registros desse recurso (/). NestedStackLogicalId ResourceLogicalId Se o nome do recurso não for fornecido, a pilha fornecida será verificada e as informações de registro serão extraídas de todos os recursos compatíveis. Se você não especificar essa opção, AWS SAM buscará os registros de todos os recursos na pilha especificada. Os seguintes tipos de registro são compatíveis:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`

`--output TEXT`  <a name="sam-cli-command-reference-sam-logs-options-output"></a>
Especifica o formato de saída para logs. Para imprimir registros formatados, especifique`text`. Para imprimir os registros como JSON, especifique `json`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
O nome da CloudFormation pilha da qual o recurso faz parte.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Busca registros a partir desse momento. A hora pode ser valores relativos, como '5 minutos atrás', 'ontem' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'. O padrão é '10 minutos atrás'.

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Encerra a saída do log. Isso ignora o argumento de horário de término e continua a buscar os registros à medida que eles se tornam disponíveis.

## Exemplos
<a name="sam-cli-command-reference-sam-logs-examples"></a>

Quando suas funções fazem parte de uma CloudFormation pilha, você pode buscar registros usando o ID lógico da função ao especificar o nome da pilha.

```
$ sam logs -n HelloWorldFunction --stack-name myStack
```

Visualize os registros de um intervalo de tempo específico usando as opções -s (--start-time) e -e (--end-time).

```
$ sam logs -n HelloWorldFunction --stack-name myStack -s '10min ago' -e '2min ago'
```

Você também pode adicionar a opção `--tail` de aguardar novos registros e vê-los à medida que chegam.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --tail
```

Use a opção `--filter` para encontrar rapidamente os logs que correspondem a determinados termos, frases ou valores nos eventos de log.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --filter "error"
```

Visualize os registros de um recurso em uma pilha secundária.

```
$ sam logs --stack-name myStack -n childStack/HelloWorldFunction
```

Registros finais de todos os recursos compatíveis em seu aplicativo.

```
$ sam logs --stack-name sam-app --tail
```

Busque registros de uma função do Lambda específica e da API Gateway API em seu aplicativo.

```
$ sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi
```

Busque registros de todos os recursos compatíveis em seu aplicativo e, além disso, dos grupos de registros especificados.

```
$ sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456
```

# sam package
<a name="sam-cli-command-reference-sam-package"></a>

A interface de linha de AWS Serverless Application Model comando (AWS SAM CLI) empacota um AWS SAM aplicativo.

Esse comando cria um `.zip` arquivo com seu código e dependências e carrega o arquivo no Amazon Simple Storage Service (Amazon S3). AWS SAM ativa a criptografia para todos os arquivos armazenados no Amazon S3. Em seguida, ele retorna uma cópia do seu AWS SAM modelo, substituindo as referências aos artefatos locais pela localização do Amazon S3 em que o comando carregou os artefatos.

Por padrão, quando você usa esse comando, AWS SAMCLI pressupõe que seu diretório de trabalho atual seja o diretório raiz do seu projeto. O AWS SAMCLI primeiro tenta localizar um arquivo de modelo criado usando o [sam build](sam-cli-command-reference-sam-build.md) comando, localizado na `.aws-sam` subpasta e nomeado`template.yaml`. Em seguida, o AWS SAMCLI tenta localizar um arquivo de modelo chamado `template.yaml` ou `template.yml` no diretório de trabalho atual. Se você especificar a `--template` opção, o comportamento padrão AWS SAMCLI do modelo será substituído e empacotará apenas esse AWS SAM modelo e os recursos locais para os quais ele aponta.

**nota**  
[sam deploy](sam-cli-command-reference-sam-deploy.md) agora executa implicitamente a funcionalidade do `sam package`. Você pode usar o [sam deploy](sam-cli-command-reference-sam-deploy.md) comando diretamente para empacotar e implantar sua aplicação.

## Usage
<a name="sam-cli-command-reference-sam-package-usage"></a>

```
$ sam package <arguments> <options>
```

## Argumentos
<a name="sam-cli-command-reference-sam-package-args"></a>

**Resource ID (ID do recurso)**  <a name="sam-cli-command-reference-sam-package-args-resource-id"></a>
O ID da função do Lambda para empacotar.  
Esse argumento é opcional. Se seu aplicativo contiver uma única função Lambda, a AWS SAM CLI a empacotará. Se seu aplicativo contiver várias funções, forneça o ID da função para empacotar uma única função.  
*Valores válidos*: o ID lógico do recurso ou o ARN do recurso.

## Opções
<a name="sam-cli-command-reference-sam-package-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-package-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-package-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-package-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração gerada pelo AWS SAMCLI e exibir timestamps.

`--force-upload`  <a name="sam-cli-command-reference-sam-package-options-force-upload"></a>
Substituir arquivos existentes no bucket do Amazon S3. Especifique essa bandeira para fazer upload de artefatos, mesmo que eles correspondam aos artefatos existentes no bucket do Amazon S3.

`--help`  <a name="sam-cli-command-reference-sam-package-options-help"></a>
Mostra esta mensagem e sai.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-package-options-image-repository"></a>
O URI do repositório do Amazon Elastic Container Registry (Amazon ECR) onde esse comando faz upload da imagem da função. Necessário para funções declaradas com o tipo de pacote `Image`.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-package-options-kms-key-id"></a>
O ID de uma chave AWS Key Management Service (AWS KMS) usada para criptografar artefatos que estão em repouso no bucket do Amazon S3. Se essa opção não for especificada, AWS SAM usará as chaves de criptografia gerenciadas pelo Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-package-options-metadata"></a>
(Opcional) Um mapa de metadados para anexar a todos os artefatos referenciados em seu modelo.

`--no-progressbar`  <a name="sam-cli-command-reference-sam-package-options-no-progressbar"></a>
Não exiba uma barra de progresso ao fazer o upload de artefatos para o Amazon S3.

`--output-template-file PATH`  <a name="sam-cli-command-reference-sam-package-options-output-template-file"></a>
O caminho para o arquivo em que o comando grava o modelo empacotado. Se você não especificar um caminho, o comando gravará o modelo na saída padrão.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-package-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-package-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--resolve-s3`  <a name="sam-cli-command-reference-sam-package-options-resolve-s3"></a>
Crie automaticamente um bucket do Amazon S3 para usar na embalagem. Se você especificar as opções `--s3-bucket` e `--resolve-s3`, ocorrerá um erro.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-bucket"></a>
O nome do bucket do Amazon S3 em que esse comando faz upload do artefato. Se seu artefato for maior que 51.200 bytes, a opção `--s3-bucket` ou a `--resolve-s3` será obrigatória. Se você especificar as opções `--s3-bucket` e `--resolve-s3`, ocorrerá um erro.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-prefix"></a>
Prefixo adicionado ao nome do artefato que é carregado para o bucket do Amazon S3. O nome do prefixo é um nome de caminho (nome da pasta) para o bucket do Amazon S3. Isso só se aplica às funções declaradas com o tipo de `Zip` pacote.

`--save-params`  <a name="sam-cli-command-reference-sam-package-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--signing-profiles LIST`  <a name="sam-cli-command-reference-sam-package-options-signing-profiles"></a>
(Opcional) A lista de perfis de assinatura com os quais assinar seus pacotes de implantação. Esse parâmetro usa uma lista de pares de valores-chave, em que a chave é o nome da função ou camada a ser assinada e o valor é o perfil de assinatura, com um proprietário de perfil opcional delimitado por `:`. Por exemplo, .`FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-package-options-template-file"></a>
O caminho e o nome do arquivo em que seu AWS SAM modelo está localizado.  
Se você especificar essa opção, AWS SAM empacotará somente o modelo e os recursos locais para os quais ele aponta.

`--use-json`  <a name="sam-cli-command-reference-sam-package-options-use-json"></a>
JSON de saída para o CloudFormation modelo. YAML é usado por padrão.

## Exemplo
<a name="sam-cli-command-reference-sam-package-examples"></a>

O exemplo a seguir cria e empacota artefatos para uma função CodeDeploy e aplicativos Lambda. Os artefatos são carregados em um bucket do Amazon S3. A saída do comando é um novo arquivo chamado `package.yml`.

```
$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket
```

# sam pipeline bootstrap
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam local pipeline bootstrap` subcomando Command Line Interface (AWS SAMCLI).

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam pipeline bootstrap` subcomando gera os recursos de AWS infraestrutura necessários para se conectar ao seu sistema de CI/CD. Essa etapa deve ser executada em cada estágio de implantação em seu pipeline antes de executar o comando **sam pipeline init**.

Esse subcomando configura os seguintes recursos de AWS infraestrutura:
+ Opção de configurar as permissões do pipeline por meio de:
  + Um usuário do pipeline IAM com ID da chave de acesso e credenciais de acesso à chave secreta a serem compartilhadas com o CI/CD sistema.
**nota**  
Recomendamos alternar as chaves de acesso regularmente. Para obter mais informações, consulte [Alterne as chaves de acesso regularmente para casos de uso que exijam credenciais de longo prazo](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) no *Guia do usuário do IAM*.
  +  CI/CD Plataformas suportadas por meio do OIDC. Para uma introdução sobre o uso do OIDC com pipeline AWS SAM , vá para [Como usar a autenticação OIDC com pipelines AWS SAM](deploying-with-oidc.md).
+ Uma função CloudFormation de execução do IAM assumida pela CloudFormation para implantar o AWS SAM aplicativo.
+ Um bucket Amazon S3 para armazenar os AWS SAM artefatos.
+ Opcionalmente, um repositório de imagens do Amazon ECR para armazenar pacotes de implantação Lambda de imagens de contêiner (se você tiver um recurso do tipo de pacote `Image`).

## Usage
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## Opções
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 O UUID do repositório do Bitbucket. Essa opção é específica ao uso do Bitbucket OIDC para obter permissões.  
Esse valor pode ser encontrado em https://bitbucket.org/*workspace*/*repository*/admin/addon/admin/pipelines/openid-connect 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
O ARN do bucket Amazon S3 que contém os artefatos. AWS SAM 

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
A CI/CD plataforma para o AWS SAM gasoduto.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
O ARN da função do IAM a ser assumida CloudFormation durante a implantação da pilha do aplicativo. Forneça somente se quiser usar sua própria função. Caso contrário, o comando criará uma nova função.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é **default**. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo os valores de parâmetros padrão a serem usados. O valor padrão é `samconfig.toml` na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Solicite a confirmação da implantação de seus recursos.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Especifique se deseja criar um repositório de imagens do Amazon ECR se nenhum for fornecido. O repositório Amazon ECR contém as imagens de contêiner das funções do Lambda, ou camadas com um tipo de pacote de `Image`. O padrão é `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Ativa o registro de depuração e imprime as mensagens de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nome da filial a partir da qual as implantações ocorrerão. Essa opção é específica para usar GitHub Ações OIDC para obter permissões.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
A GitHub organização à qual o repositório pertence. Se nenhuma organização existir, insira o nome de usuário do proprietário do repositório. Essa opção é específica para usar GitHub Ações OIDC para obter permissões.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nome do GitHub repositório a partir do qual as implantações ocorrerão. Essa opção é específica para usar GitHub Ações OIDC para obter permissões.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
O GitLab grupo ao qual o repositório pertence. Essa opção é específica para usar o GitLab OIDC para obter permissões.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
O nome GitLab do projeto. Essa opção é específica para usar o GitLab OIDC para obter permissões.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Mostra esta mensagem e sai.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
O ARN de um repositório de imagens do Amazon ECR que contém as imagens de contêiner das funções do Lambda, ou camadas que têm um tipo de pacote de `Image`. Se fornecidas, as opções `--create-image-repository` serão ignoradas. Se não for fornecido e `--create-image-repository` for especificado, o comando cria um.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Desative a solicitação interativa para parâmetros de bootstrap e falhe se algum parâmetro necessário estiver ausente. O valor padrão é `--interactive`. Para esse comando, `--stage` é o único parâmetro obrigatório.  
Se `--no-interactive` for especificado junto com `--use-oidc-provider`, todos os parâmetros necessários para seu provedor de OIDC devem ser incluídos.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
O ID do cliente configurado para uso com seu provedor OIDC.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nome do CI/CD provedor que será usado para permissões do OIDC. GitLab GitHub, e o Bitbucket são compatíveis.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
O URL do provedor de OIDC. O valor deve começar com **https://**.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Escolha um provedor de permissões para assumir a função de execução do pipeline. O valor padrão é **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
O ARN do perfil do IAM a ser assumida pelo usuário do pipeline para operar nesse estágio. Forneça somente se quiser usar sua própria função. Se não for fornecido, esse comando criará uma nova função.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
O Amazon Resource Name (ARN) do usuário do IAM com o ID da chave de acesso e a chave de acesso secreta compartilhados com o CI/CD sistema. Ele é usado para conceder permissão a esse usuário do IAM para acessar a AWS conta correspondente. Se não for fornecido, o comando criará um usuário do IAM junto com o ID da chave de acesso e as credenciais da chave de acesso secreta.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
A AWS região para a qual implantar. Por exemplo, .`us-east-1`

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
O nome do estágio de implantação correspondente. Ele é usado como um sufixo para os recursos de AWS infraestrutura criados.

## Solução de problemas
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Erro: Falta o parâmetro necessário
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

Quando `--no-interactive` for especificado junto com `--use-oidc-provider` e nenhum dos parâmetros necessários for fornecido, essa mensagem de erro será exibida junto com uma descrição dos parâmetros ausentes.

## Exemplo
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

O exemplo a seguir cria os AWS recursos necessários para criar seu CI/CD sistema, ativa o registro de depuração e imprime mensagens de depuração geradas pelo AWS SAMCLI: usa um evento gerado para testes locais usando um evento para invocar uma função `s3.json` Lambda localmente.

```
$ sam pipeline bootstrap --debug
```

# sam pipeline init
<a name="sam-cli-command-reference-sam-pipeline-init"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam pipeline init` subcomando Command Line Interface (AWS SAMCLI).

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam pipeline init` subcomando gera um arquivo de configuração de pipeline que seu CI/CD sistema pode usar para implantar aplicativos sem servidor usando. AWS SAM

Antes de usar **sam pipeline init**, você deve criar os recursos necessários para cada estágio do seu pipeline. Você pode fazer isso executando **sam pipeline init --bootstrap** para ser guiado pelo processo de geração do arquivo de instalação e configuração ou consultando os recursos que você criou anteriormente com o comando **sam pipeline bootstrap**.

## Usage
<a name="sam-cli-command-reference-sam-pipeline-init-usage"></a>

```
$ sam pipeline init <options>
```

## Opções
<a name="sam-cli-command-reference-sam-pipeline-init-options"></a>

`--bootstrap`  <a name="sam-cli-command-reference-sam-pipeline-init-options-bootstrap"></a>
Ative o modo interativo que orienta o usuário na criação dos recursos de AWS infraestrutura necessários.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é `default`. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é `samconfig.toml` no diretório raiz do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-init-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-init-options-help"></a>
Mostra esta mensagem e sai.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-init-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

## Exemplo
<a name="sam-cli-command-reference-sam-pipeline-init-examples"></a>

O exemplo a seguir mostra como usar a `--bootstrap` opção para permitir que você percorra um modo interativo que orienta você na criação dos recursos de AWS infraestrutura necessários:

```
$ sam pipeline init --bootstrap
```

# sam publish
<a name="sam-cli-command-reference-sam-publish"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam publish`.

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam publish` comando publica um AWS SAM aplicativo no AWS Serverless Application Repository. Esse comando usa um AWS SAM modelo empacotado e publica o aplicativo na região especificada AWS .

O `sam publish` comando espera que o AWS SAM modelo inclua uma `Metadata` seção que contenha os metadados do aplicativo necessários para publicação. Na seção `Metadata`, as propriedades `LicenseUrl` e `ReadmeUrl` devem se referir aos buckets do Amazon Simple Storage Service (Amazon S3), não aos arquivos locais. Para obter mais informações sobre a `Metadata` seção do AWS SAM modelo, consulte[Como publicar a aplicação com a CLI do AWS SAM](serverless-sam-template-publishing-applications.md).

Por padrão, `sam publish` cria o aplicativo como privado. Antes que outras AWS contas possam visualizar e implantar seu aplicativo, você deve compartilhá-lo. Para obter informações sobre o compartilhamento de aplicativos, consulte [Exemplos de políticas AWS Serverless Application Repository baseadas em recursos](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/security_iam_resource-based-policy-examples.html) no Guia do *AWS Serverless Application Repository desenvolvedor*.

**nota**  
Atualmente, `sam publish` não oferece suporte à publicação de aplicativos aninhados especificados localmente. Se seu aplicativo contiver aplicativos aninhados, você deverá publicá-los separadamente no AWS Serverless Application Repository antes de publicar seu aplicativo principal.

## Usage
<a name="sam-cli-command-reference-sam-publish-usage"></a>

```
$ sam publish <options>
```

## Opções
<a name="sam-cli-command-reference-sam-publish-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-publish-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-publish-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-publish-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--help`  <a name="sam-cli-command-reference-sam-publish-options-help"></a>
Mostra esta mensagem e sai.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-publish-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-publish-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-publish-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--semantic-version TEXT`  <a name="sam-cli-command-reference-sam-publish-options-semantic-version"></a>
(Opcional) Use essa opção para fornecer uma versão semântica do seu aplicativo que substitua a propriedade `SemanticVersion` na seção `Metadata` do arquivo de modelo. Para obter mais informações sobre controle de versionamento semântico, consulte a especificação de controle de versão [semântica](https://semver.org/).

`--template, -t PATH`  <a name="sam-cli-command-reference-sam-publish-options-template"></a>
O caminho do arquivo AWS SAM de modelo`[default: template.[yaml|yml]]`.

## Exemplos
<a name="sam-cli-command-reference-sam-publish-examples"></a>

Para publicar um aplicativo:

```
$ sam publish --template packaged.yaml --region us-east-1
```

# sam remote callback
<a name="sam-cli-command-reference-sam-remote-callback"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote callback`.

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam remote callback` comando permite que você envie retornos de chamada para execuções remotas de funções duráveis em execução no AWS Lambda.

**nota**  
Esses comandos exigem acesso às AWS credenciais.

## Usage
<a name="sam-cli-command-reference-sam-remote-callback-usage"></a>

```
$ sam remote callback <subcommand> <options>
```

## Opções
<a name="sam-cli-command-reference-sam-remote-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-callback-options-help"></a>
Mostre esta mensagem e saia.

## Subcomandos
<a name="sam-cli-command-reference-sam-remote-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-succeed"></a>
Envie um retorno de chamada bem-sucedido para uma execução remota de função durável. Para obter mais informações, consulte [sam remote callback succeed](sam-cli-command-reference-sam-remote-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-fail"></a>
Envie uma falha de retorno de chamada para uma execução remota de função durável. Para obter mais informações, consulte [sam remote callback fail](sam-cli-command-reference-sam-remote-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-heartbeat"></a>
Envie uma pulsação de retorno de chamada para uma execução remota de função durável. Para obter mais informações, consulte [sam remote callback heartbeat](sam-cli-command-reference-sam-remote-callback-heartbeat.md).

# sam remote callback succeed
<a name="sam-cli-command-reference-sam-remote-callback-succeed"></a>

Envie um retorno de chamada bem-sucedido para uma execução remota de função durável.

**nota**  
Esse comando requer acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-remote-callback-succeed-usage"></a>

```
$ sam remote callback succeed CALLBACK_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-remote-callback-succeed-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma resposta bem-sucedida.

## Opções
<a name="ref-sam-cli-remote-callback-succeed-options"></a>

`-r, --result TEXT`  
Carga útil do resultado de sucesso como string.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar os recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-remote-callback-succeed-examples"></a>

Envie um retorno de chamada bem-sucedido sem resultado:

```
$ sam remote callback succeed my-callback-id
```

Envie um retorno de chamada de sucesso com o resultado:

```
$ sam remote callback succeed my-callback-id --result 'Task completed successfully'
```

# sam remote callback fail
<a name="sam-cli-command-reference-sam-remote-callback-fail"></a>

Envie uma falha de retorno de chamada para uma execução remota de função durável.

**nota**  
Esse comando requer acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-remote-callback-fail-usage"></a>

```
$ sam remote callback fail CALLBACK_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-remote-callback-fail-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma resposta de falha.

## Opções
<a name="ref-sam-cli-remote-callback-fail-options"></a>

`--error-data TEXT`  
Dados de erro adicionais.

`--stack-trace TEXT`  
Entradas de rastreamento de pilha. Essa opção pode ser especificada várias vezes.

`--error-type TEXT`  
Tipo de erro.

`--error-message TEXT`  
Mensagem de erro detalhada.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-remote-callback-fail-examples"></a>

Envie um retorno de chamada de falha sem parâmetros:

```
$ sam remote callback fail my-callback-id
```

Enviar retorno de chamada de falha com mensagem de erro:

```
$ sam remote callback fail my-callback-id --error-message 'Task failed'
```

Envie um retorno de chamada de falha com todos os parâmetros:

```
$ sam remote callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam remote callback heartbeat
<a name="sam-cli-command-reference-sam-remote-callback-heartbeat"></a>

Envie uma pulsação de retorno de chamada para uma execução remota de função durável.

**nota**  
Esse comando requer acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-remote-callback-heartbeat-usage"></a>

```
$ sam remote callback heartbeat CALLBACK_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-remote-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma pulsação.

## Opções
<a name="ref-sam-cli-remote-callback-heartbeat-options"></a>

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-remote-callback-heartbeat-examples"></a>

Enviar retorno de chamada de pulsação:

```
$ sam remote callback heartbeat my-callback-id
```

# sam remote execution
<a name="sam-cli-command-reference-sam-remote-execution"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote execution`.

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam remote execution` comando permite gerenciar e inspecionar execuções remotas de funções duráveis em execução no AWS Lambda.

**nota**  
Esses comandos exigem acesso às AWS credenciais.

## Usage
<a name="sam-cli-command-reference-sam-remote-execution-usage"></a>

```
$ sam remote execution <subcommand> <options>
```

## Opções
<a name="sam-cli-command-reference-sam-remote-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-execution-options-help"></a>
Mostre esta mensagem e saia.

## Subcomandos
<a name="sam-cli-command-reference-sam-remote-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-get"></a>
Obtenha detalhes de uma execução duradoura. Para obter mais informações, consulte [sam remote execution get](sam-cli-command-reference-sam-remote-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-history"></a>
Obtenha o histórico de execução de uma função durável. Para obter mais informações, consulte [sam remote execution history](sam-cli-command-reference-sam-remote-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-stop"></a>
Interrompa a execução de uma função durável. Para obter mais informações, consulte [sam remote execution stop](sam-cli-command-reference-sam-remote-execution-stop.md).

# sam remote execution get
<a name="sam-cli-command-reference-sam-remote-execution-get"></a>

Recupere os detalhes da execução de uma função durável específica do AWS Lambda.

O ARN de execução deve estar no formato retornado pelo Invoke ou encontrado nos registros de execução.

**nota**  
Esse comando requer acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-remote-execution-get-usage"></a>

```
$ sam remote execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-remote-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
O Amazon Resource Name (ARN) da execução da função durável para a qual recuperar detalhes.

## Opções
<a name="ref-sam-cli-remote-execution-get-options"></a>

`--format [summary|json]`  
Formato de saída. Padrão: `summary`

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-remote-execution-get-examples"></a>

Obtenha detalhes da execução com o formato de resumo padrão:

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55'
```

Obtenha detalhes da execução no formato JSON:

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55' --format json
```

**nota**  
Você deve garantir que os caracteres de controle no ARN de execução `$` sejam escapados corretamente ao usar comandos shell.

# sam remote execution history
<a name="sam-cli-command-reference-sam-remote-execution-history"></a>

Recupere o histórico de execução de uma função durável específica do AWS Lambda.

O ARN de execução deve estar no formato retornado StartDurableExecution ou encontrado nos registros de execução.

**nota**  
Esse comando requer acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-remote-execution-history-usage"></a>

```
$ sam remote execution history DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-remote-execution-history-arguments"></a>

`DURABLE_EXECUTION_ARN`  
O Amazon Resource Name (ARN) da execução da função durável para a qual recuperar o histórico.

## Opções
<a name="ref-sam-cli-remote-execution-history-options"></a>

`--format [table|json]`  
Formato de saída. Padrão: `table`

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-remote-execution-history-examples"></a>

Obtenha o histórico de execução com o formato de tabela padrão:

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Obtenha o histórico de execução no formato JSON:

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam remote execution stop
<a name="sam-cli-command-reference-sam-remote-execution-stop"></a>

Interrompa a execução de uma função durável em execução no AWS Lambda.

O ARN de execução deve estar no formato retornado StartDurableExecution ou encontrado nos registros de execução.

**nota**  
Esse comando requer acesso às AWS credenciais.

## Usage
<a name="ref-sam-cli-remote-execution-stop-usage"></a>

```
$ sam remote execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-remote-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
O Amazon Resource Name (ARN) da execução da função durável a ser interrompida.

## Opções
<a name="ref-sam-cli-remote-execution-stop-options"></a>

`--error-message TEXT`  
Mensagem de erro a ser associada à execução interrompida.

`--error-type TEXT`  
Tipo de erro a ser associado à execução interrompida.

`--error-data TEXT`  
Dados de erro a serem associados à execução interrompida.

`--stack-trace TEXT`  
Entradas de rastreamento de pilha. Essa opção pode ser especificada várias vezes.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar os recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-remote-execution-stop-examples"></a>

Pare a execução sem detalhes de erro:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Pare a execução com mensagem de erro e digite:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Pare a execução com detalhes completos do erro e rastreamento de pilha:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam remote invoke
<a name="sam-cli-command-reference-remote-invoke"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote invoke`.
+ Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam remote invoke` comando, consulte[Introdução aos testes na nuvem com sam remote invoke](using-sam-cli-remote-invoke.md).

O `sam remote invoke` comando invoca recursos suportados no . Nuvem AWS

## Usage
<a name="sam-cli-command-reference-remote-invoke-usage"></a>

```
$ sam remote invoke <arguments> <options>
```

## Argumentos
<a name="sam-cli-command-reference-remote-invoke-args"></a>

**Resource ID (ID do recurso)**  <a name="sam-cli-command-reference-remote-invoke-args-resource-id"></a>
O ID do recurso suportado a ser invocado.  
Esse argumento aceita os seguintes valores:  
+ **O nome de recurso da Amazon (ARN)** - O ARN do conjunto de recursos.
**dica**  
Use `sam list stack-outputs --stack-name <stack-name>` para obter o ARN dos seus recursos.
+ **ID lógico** - O ID lógico do recurso. Você também deve fornecer o nome da AWS CloudFormation pilha usando a `--stack-name` opção.
+ **ID físico** — O ID físico do recurso. Esse ID é criado quando você implanta um recurso usando CloudFormation o.
**dica**  
Use `sam list resources --stack-name <stack-name>` para obter a identificação física dos seus recursos.  
**Quando você fornece um ARN ou ID física:**  
Se você fornecer um ARN ou ID física, não forneça um nome de pilha. Quando o nome da pilha for fornecido usando a `--stack-name` opção, ou quando o nome da pilha for definido em seu arquivo de configuração, ele AWS SAM CLI processará automaticamente sua ID de recurso como um valor de ID lógico da CloudFormation pilha.  
**Quando você não fornece um ID de recurso:**  
Se você não fornecer um ID de recurso, mas fornecer um nome de pilha com a `--stack-name` opção, a AWS SAM CLI tentará invocar automaticamente um recurso em CloudFormation sua pilha usando a seguinte lógica:  

1. Eles AWS SAM CLI identificarão os tipos de recursos na seguinte ordem e passarão para a próxima etapa quando o tipo de recurso for encontrado em sua pilha:

   1. Lambda

   1. Step Functions

   1. Amazon SQS

   1. Kinesis Data Streams

1. Se o tipo de recurso tiver um único recurso em sua pilha, AWS SAM CLI ele o invocará. Se existirem vários recursos do tipo de recurso em sua pilha, eles AWS SAM CLI retornarão um erro.
A seguir estão exemplos do que eles AWS SAM CLI farão:  
+ **Pilha que contém duas funções Lambda e uma fila do Amazon SQS** — Ela AWS SAM CLI localizará o tipo de recurso Lambda e retornará um erro, pois a pilha contém mais de uma função Lambda.
+ **Pilha que contém uma função Lambda e dois aplicativos Amazon Kinesis Data Streams** AWS SAM CLI — Eles localizarão a função Lambda e a invocarão, pois a pilha contém um único recurso Lambda.
+ **Pilha que contém uma única fila do Amazon SQS e dois aplicativos do Kinesis Data Streams — Eles AWS SAM CLI localizarão a fila** do Amazon SQS e a invocarão, pois a pilha contém uma única fila do Amazon SQS.

## Opções
<a name="sam-cli-command-reference-remote-invoke-options"></a>

`--beta-features | --no-beta-features`  <a name="sam-cli-command-reference-remote-invoke-options-beta-features"></a>
Permita ou negue recursos beta.

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-config-env"></a>
Especifique o ambiente a ser usado em seu arquivo AWS SAMCLI de configuração.  
*Padrão*: `default`

`--config-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-config-file"></a>
Especifique o caminho e o nome do arquivo de configuração.  
Para obter mais informações sobre esses arquivos de configuração, consulte [Configurando o AWS SAM CLI](using-sam-cli-configure.md).  
*Padrão*: `samconfig.toml` na raiz do diretório do seu projeto. 

`--debug`  <a name="sam-cli-command-reference-remote-invoke-options-debug"></a>
Ative o registro da depuração. Isso imprime mensagens de depuração e registros de data e hora gerados pelo AWS SAM CLI.

`--event, -e TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-event"></a>
O evento a ser enviado ao recurso de destino.

`--event-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-event-file"></a>
O caminho para um arquivo que contém o evento a ser enviado ao recurso de destino.

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Mostra a mensagem de ajuda e sai.

`--output [ text | json ]`  <a name="sam-cli-command-reference-remote-invoke-options-output"></a>
Exiba os resultados da sua invocação em um formato de saída específico.  
`json`— Os metadados da solicitação e a resposta do recurso são retornados na estrutura JSON. A resposta contém a saída completa do SDK.  
`text`— Os metadados da solicitação são retornados na estrutura de texto. A resposta do recurso é retornada no formato de saída do recurso invocado.

`--parameter`  <a name="sam-cli-command-reference-remote-invoke-options-parameter"></a>
[https://boto3.amazonaws.com/v1/documentation/api/latest/index.html](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)Parâmetros adicionais que você pode passar para o recurso que está sendo chamado.    
**Amazon Kinesis Data Streams**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-kinesis"></a>
Os seguintes parâmetros adicionais podem ser usados para colocar um registro no fluxo de dados do Kinesis:  
+ `ExplicitHashKey='string'`
+ `PartitionKey='string'`
+ `SequenceNumberForOrdering='string'`
+ `StreamARN='string'`
Para obter uma descrição de cada parâmetro, consulte [Kinesis.client.PUT\$1RECORD](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis/client/put_record.html).  
**AWS Lambda**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-lambda"></a>
Os seguintes parâmetros adicionais podem ser usados para invocar um recurso Lambda e receber uma resposta em buffer:  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | Event | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
Os seguintes parâmetros adicionais podem ser usados para invocar um recurso Lambda com streaming de resposta:  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
Para obter uma descrição de cada parâmetro, consulte o seguinte:  
+ [Lambda com resposta em buffer — Lambda.client.invoke](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke.html)
+ [Lambda com streaming de resposta — Lambda.client.invoke\$1with\$1response\$1stream](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke_with_response_stream.html)  
**Amazon Simple Queue Service (Amazon SQS)**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sqs"></a>
Os seguintes parâmetros adicionais podem ser usados para enviar uma mensagem para uma fila do Amazon SQS:  
+ `DelaySeconds=integer`
+ `MessageAttributes='json string'`
+ `MessageDeduplicationId='string'`
+ `MessageGroupId='string'`
+ `MessageSystemAttributes='json string'`
Para obter uma descrição de cada parâmetro, consulte [sqs.client.SEND\$1MESSAGE](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs/client/send_message.html).  
**AWS Step Functions**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sf"></a>
Os seguintes parâmetros adicionais podem ser usados para iniciar uma execução de máquina de estado:  
+ `name='string'`
+ `traceHeader='string'`
Para obter uma descrição de cada parâmetro, consulte [sfn.client.start\$1execution](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/stepfunctions/client/start_execution.html).

`--profile TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-profile"></a>
O perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-region"></a>
O Região da AWS do recurso. Por exemplo, .`us-east-1`

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-stack-name"></a>
O nome da CloudFormation pilha à qual o recurso pertence.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
O ID do locatário para funções Lambda de vários locatários. Usado para garantir o isolamento computacional entre diferentes inquilinos. Obrigatório ao invocar funções configuradas com o modo de isolamento do inquilino.

`--test-event-name NAME`  <a name="sam-cli-command-reference-remote-invoke-options-test-event-name"></a>
O nome do evento de teste compartilhável a ser passado para sua função do Lambda.  
Essa opção oferece suporte apenas às funções Lambda.

## Exemplo
<a name="sam-cli-command-reference-remote-invoke-examples"></a>

O exemplo a seguir invoca recursos compatíveis na AWS nuvem e ativa o registro de depuração, que imprime mensagens de depuração e registros de data e hora gerados pelo: AWS SAMCLI

```
$ sam remote invoke--debug
```

# sam remote test-event
<a name="sam-cli-command-reference-remote-test-event"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote test-event`.
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre como usar o AWS SAMCLI `sam remote test-event` comando, consulte[Introdução aos testes em nuvem com sam remote test-event](using-sam-cli-remote-test-event.md).

O `sam remote test-event` comando interage com eventos de teste compartilháveis no registro do EventBridge esquema da Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-usage"></a>

```
$ sam remote test-event <options> <subcommand>
```

## Opções
<a name="sam-cli-command-reference-remote-test-event-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Mostre a mensagem de ajuda e saia.

## Subcomandos
<a name="sam-cli-command-reference-remote-test-event-subcommands"></a>

`delete`  
Exclua um evento de teste compartilhável do registro do EventBridge esquema. Para obter mais informações, consulte [sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md).

`get`  
Obtenha um evento de teste compartilhável do registro do EventBridge esquema. Para obter mais informações, consulte [sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md).

`list`  
Listar eventos de teste compartilháveis existentes para uma AWS Lambda função. Para obter mais informações, consulte [sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md).

`put`  
Salve um evento de um arquivo local no registro do EventBridge esquema. Para obter mais informações, consulte [sam remote test-event put](sam-cli-command-reference-remote-test-event-put.md).

# sam remote test-event delete
<a name="sam-cli-command-reference-remote-test-event-delete"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam remote test-event delete` subcomando Command Line Interface (AWS SAMCLI).
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre como usar o AWS SAMCLI `sam remote test-event` comando, consulte[Introdução aos testes em nuvem com sam remote test-event](using-sam-cli-remote-test-event.md).

O `sam remote test-event delete` subcomando exclui um evento de teste compartilhável do registro de esquemas da Amazon EventBridge .

## Usage
<a name="sam-cli-command-reference-remote-test-event-delete-usage"></a>

```
$ sam remote test-event delete <arguments> <options>
```

## Argumentos
<a name="sam-cli-command-reference-remote-test-event-delete-args"></a>

**Resource ID (ID do recurso)**  <a name="sam-cli-command-reference-remote-test-event-delete-args-resource-id"></a>
O ID da AWS Lambda função associada ao evento de teste compartilhável.  
Se você fornecer uma ID lógica, também deverá fornecer um valor para a AWS CloudFormation pilha associada à função Lambda usando `--stack-name` a opção.  
*Valores válidos*: o ID lógico do recurso ou o recurso ARN.

## Opções
<a name="sam-cli-command-reference-remote-test-event-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-delete-options-help"></a>
Mostre a mensagem de ajuda e saia.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-name"></a>
O nome do evento de teste compartilhável a ser excluído.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-stack-name"></a>
O nome da CloudFormation pilha associada à função Lambda.  
Essa opção é necessária se você estiver fornecendo a ID lógica da função do Lambda como argumento.

# sam remote test-event get
<a name="sam-cli-command-reference-remote-test-event-get"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam remote test-event get` subcomando Command Line Interface (AWS SAMCLI).
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam remote test-event` comando, consulte[Introdução aos testes em nuvem com sam remote test-event](using-sam-cli-remote-test-event.md).

O `sam remote test-event get` subcomando obtém um evento de teste compartilhável do registro de EventBridge esquemas da Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-get-usage"></a>

```
$ sam remote test-event get <arguments> <options>
```

## Argumentos
<a name="sam-cli-command-reference-remote-test-event-get-args"></a>

**Resource ID (ID do recurso)**  <a name="sam-cli-command-reference-remote-test-event-get-args-resource-id"></a>
O ID da AWS Lambda função associada ao evento de teste compartilhável a ser obtido.  
Se você fornecer uma ID lógica, também deverá fornecer um valor para a AWS CloudFormation pilha associada à função Lambda usando `--stack-name` a opção.  
*Valores válidos*: o ID lógico do recurso ou o recurso ARN.

## Opções
<a name="sam-cli-command-reference-remote-test-event-get-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-get-options-help"></a>
Mostre a mensagem de ajuda e saia.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-name"></a>
O nome do evento de teste compartilhável a ser obtido.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-get-options-output-file"></a>
O caminho e o nome do arquivo para salvar o evento em sua máquina local.  
Se você não fornecer essa opção, ele AWS SAM CLI exibirá o conteúdo do evento de teste compartilhável para o seu console.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-stack-name"></a>
O nome da CloudFormation pilha associada à função Lambda.  
Essa opção é necessária se você estiver fornecendo a ID lógica da função do Lambda como argumento.

# sam remote test-event list
<a name="sam-cli-command-reference-remote-test-event-list"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam remote test-event list` subcomando Command Line Interface (AWS SAMCLI).
+ Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre como usar o AWS SAMCLI `sam remote test-event` comando, consulte[Introdução aos testes em nuvem com sam remote test-event](using-sam-cli-remote-test-event.md).

O `sam remote test-event list` subcomando lista os eventos de teste compartilháveis existentes para uma AWS Lambda função específica do registro de EventBridge esquemas da Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-list-usage"></a>

```
$ sam remote test-event list <arguments> <options>
```

## Argumentos
<a name="sam-cli-command-reference-remote-test-event-list-args"></a>

**Resource ID (ID do recurso)**  <a name="sam-cli-command-reference-remote-test-event-list-args-resource-id"></a>
O ID da função do Lambda associado aos eventos de teste compartilháveis.  
Se você fornecer uma ID lógica, também deverá fornecer um valor para a AWS CloudFormation pilha associada à função Lambda usando `--stack-name` a opção.  
*Valores válidos*: o ID lógico do recurso ou o recurso ARN.

## Opções
<a name="sam-cli-command-reference-remote-test-event-list-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-list-options-help"></a>
Mostre a mensagem de ajuda e saia.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-stack-name"></a>
O nome da CloudFormation pilha associada à função Lambda.  
Essa opção é necessária se você estiver fornecendo a ID lógica da função do Lambda como argumento.

## Exemplos
<a name="sam-cli-command-reference-remote-test-event-list-examples"></a>

Para obter exemplos sobre como usar esse comando, consulte [Listando eventos de teste compartilháveis](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-list).

# sam remote test-event put
<a name="sam-cli-command-reference-remote-test-event-put"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam remote test-event put` subcomando Command Line Interface (AWS SAMCLI).
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam remote test-event` comando, consulte[Introdução aos testes em nuvem com sam remote test-event](using-sam-cli-remote-test-event.md).

O `sam remote test-event put` subcomando salva um evento de teste compartilhável da sua máquina local no registro do EventBridge esquema da Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-put-usage"></a>

```
$ sam remote test-event put <arguments> <options>
```

## Argumentos
<a name="sam-cli-command-reference-remote-test-event-put-args"></a>

**Resource ID (ID do recurso)**  <a name="sam-cli-command-reference-remote-test-event-put-args-resource-id"></a>
O ID da AWS Lambda função associada ao evento de teste compartilhável.  
Se você fornecer uma ID lógica, também deverá fornecer um valor para a AWS CloudFormation pilha associada à função Lambda usando `--stack-name` a opção.  
*Valores válidos*: o ID lógico do recurso ou o recurso ARN.

## Opções
<a name="sam-cli-command-reference-remote-test-event-put-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-file"></a>
O caminho do arquivo e o nome do evento em sua máquina local.  
Forneça `-` como o valor do nome do arquivo a ser lido de `stdin`.  
Essa opção é obrigatória.

`--force`, `-f`  <a name="sam-cli-command-reference-remote-test-event-put-options-force"></a>
Substitua um evento de teste compartilhável com o mesmo nome.

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-put-options-help"></a>
Mostre a mensagem de ajuda e saia.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-name"></a>
O nome para salvar o evento de teste compartilhável como.  
Se existir um evento de teste compartilhável com o mesmo nome no registro do EventBridge esquema, AWS SAM CLI ele não o substituirá. Para sobrescrever, adicione a opção `--force`.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-output-file"></a>
O caminho e o nome do arquivo para salvar o evento em sua máquina local.  
Se você não fornecer essa opção, ele AWS SAM CLI exibirá o conteúdo do evento de teste compartilhável para o seu console.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-stack-name"></a>
O nome da CloudFormation pilha associada à função Lambda.  
Essa opção é necessária se você estiver fornecendo a ID lógica da função do Lambda como argumento.

## Exemplo
<a name="sam-cli-command-reference-remote-test-event-put-examples"></a>

Para obter um exemplo sobre como usar esse comando, consulte [Salvando eventos de teste compartilháveis](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-put).

# sam sync
<a name="sam-cli-command-reference-sam-sync"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam sync`.
+ Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI, consulte[AWS SAM CLI](using-sam-cli.md).

O comando `sam sync` sincroniza as alterações do aplicativo local com o Nuvem AWS.

## Usage
<a name="sam-cli-command-reference-sam-sync-usage"></a>

```
$ sam sync <options>
```

## Opções
<a name="sam-cli-command-reference-sam-sync-options"></a>

`--base-dir, -s DIRECTORY`  <a name="sam-cli-command-reference-sam-sync-options-base-dir"></a>
Resolve caminhos relativos para o código-fonte da função ou da camada em relação a esse diretório. Use essa opção para alterar a forma como os caminhos relativos para as pastas de código-fonte são resolvidos. Por padrão, os caminhos relativos são resolvidos com relação à localização do AWS SAM modelo.  
Além dos recursos no aplicativo raiz ou na pilha que você está criando, essa opção também se aplica a aplicativos ou pilhas aninhados. Além disso, essa opção se aplica aos seguintes tipos e propriedades de recursos:  
+ Tipo de recursos: `AWS::Serverless::Function` Propriedade: `CodeUri`
+ Tipo de recurso: `AWS::Serverless::Function` Atributo do recurso: `Metadata` Entrada: `DockerContext`
+ Tipo de recursos: `AWS::Serverless::LayerVersion` Propriedade: `ContentUri`
+ Tipo de recursos: `AWS::Lambda::Function` Propriedade: `Code`
+ Tipo de recursos: `AWS::Lambda::LayerVersion` Propriedade: `Content`

`--build-image TEXT`  <a name="sam-cli-command-reference-sam-sync-options-build-image"></a>
O URI da [imagem do contêiner](serverless-image-repositories.md#serverless-image-repository-uris) que você deseja usar ao criar o aplicativo. Por padrão, AWS SAM usa o URI do repositório de imagens de contêiner do [Amazon Elastic Container Registry (Amazon ECR) Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html). Especifique essa opção para usar uma imagem diferente.  
Você pode usar essa opção várias vezes em um único comando. Cada opção aceita uma sequência ou um par de chave/valor.  
+ **String** - Especifique o URI da imagem do contêiner que todos os recursos do seu aplicativo usarão. Veja um exemplo a seguir:

  ```
  $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  ```
+ **Par de valores-chave** - especifique o nome do recurso como chave e o URI da imagem do contêiner a ser usado com esse recurso como valor. Use esse formato para especificar um URI de imagem de contêiner diferente para cada recurso em seu aplicativo. Veja um exemplo a seguir:

  ```
  $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
  ```
Essa opção só se aplica se a opção `--use-container` for especificada, caso contrário, ocorrerá um erro.

`--build-in-source | --no-build-in-source`  <a name="sam-cli-command-reference-sam-sync-options-build-in-source"></a>
Providencie `--build-in-source` para compilar seu projeto diretamente na pasta de origem.  
A opção `--build-in-source` oferece suporte aos seguintes runtimes e métodos de compilação:  
+ **Runtimes** — Qualquer runtime Node.js suportado pela opção `sam init --runtime`.
+ **Métodos de compilação** — `Makefile`, `esbuild`.
A opção `--build-in-source` não é compatível com as seguintes opções:  
+ `--use-container `
*Padrão*: `--no-build-in-source`

`--capabilities LIST`  <a name="sam-cli-command-reference-sam-sync-options-capabilities"></a>
Uma lista de recursos que você especifica para permitir CloudFormation a criação de determinadas pilhas. Alguns modelos de pilha podem incluir recursos que podem afetar as permissões em seu Conta da AWS. Por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Especifique essa opção para substituir os valores padrão. Os valores válidos incluem:  
+ CAPACIDADE\$1IAM
+ CAPACIDADE\$1NAMED\$1IAM
+ POLÍTICA DE RECURSOS DE CAPACIDADE
+ CAPABILITY\$1AUTO\$1EXPAND
*Padrão*: `CAPABILITY_NAMED_IAM` e `CAPABILITY_AUTO_EXPAND`

`--code`  <a name="sam-cli-command-reference-sam-sync-options-code"></a>
Por padrão, AWS SAM sincroniza todos os recursos em seu aplicativo. Especifique essa opção para sincronizar somente recursos de código, que incluem o seguinte:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::LayerVersion`
+ `AWS::Lambda::LayerVersion`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`
Para sincronizar recursos de código, AWS SAM usa o AWS serviço APIs diretamente, em vez de implantar por meio AWS CloudFormation de. Para atualizar sua CloudFormation pilha, execute **sam sync --watch** ou**sam deploy**.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-sync-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-sync-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--dependency-layer | --no-dependency-layer`  <a name="sam-cli-command-reference-sam-sync-options-dependency-layer"></a>
Especifica se as dependências de funções individuais devem ser separadas em outra camada para acelerar o processo de sincronização.  
*Padrão*: `--dependency-layer`

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repository"></a>
O nome do repositório do Amazon Elastic Container Registry (Amazon ECR) no qual esse comando faz upload da imagem da função. Necessário para funções declaradas com o tipo de pacote `Image`.

`--image-repositories TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repositories"></a>
Um mapeamento de funções para o URI do repositório Amazon ECR. Funções de referência por meio de sua ID lógica. Veja um exemplo a seguir:  

```
$ sam sync --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Você pode especificar esta opção várias vezes em um único comando.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-kms-key-id"></a>
O ID de uma chave AWS Key Management Service (AWS KMS) usada para criptografar artefatos que estão em repouso no bucket do Amazon S3. Se você não especificar essa opção, AWS SAM use as chaves de criptografia gerenciadas pelo Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-sync-options-metadata"></a>
Um mapa de metadados para anexar a todos os artefatos que você faz referência no seu modelo.

`--notification-arns LIST`  <a name="sam-cli-command-reference-sam-sync-options-notification-arns"></a>
Uma lista dos ARNs tópicos CloudFormation do Amazon Simple Notification Service (Amazon SNS) associados à pilha.

`--no-use-container`  <a name="ref-sam-cli-sync-options-no-use-container"></a>
Uma opção que permite usar o kit de ferramentas do IDE para definir o comportamento padrão.

`--parameter-overrides`  <a name="sam-cli-command-reference-sam-sync-options-parameter-overrides"></a>
Uma string que contém substituições de CloudFormation parâmetros codificadas como pares de valores-chave. Use o mesmo formato do AWS Command Line Interface (AWS CLI). O formato da CLI do AWS SAMé uma palavra-chave explícita de chave e valor e cada substituição é separada por um espaço. Veja dois exemplos a seguir:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--resource TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource"></a>
Especifica o tipo de recurso a ser sincronizado. Para sincronizar vários recursos, você pode especificar essa opção várias vezes. Essa opção é compatível com a opção `--code`. O valor deve ser um dos recursos listados em `--code`. Por exemplo, .`--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion`

`--resource-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource-id"></a>
Especifica o ID do recurso a ser sincronizado. Para sincronizar vários recursos, você pode especificar essa opção várias vezes. Essa opção é compatível com a opção `--code`. Por exemplo, .`--resource-id Function1 --resource-id Function2`

`--role-arn TEXT`  <a name="sam-cli-command-reference-sam-sync-options-role-arn"></a>
O Amazon Resource Name (ARN) de uma função do IAM que é CloudFormation assumida ao aplicar o conjunto de alterações.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-bucket"></a>
O nome do bucket do Amazon Simple Storage Service (Amazon S3) no qual esse comando carrega seu modelo. CloudFormation Se seu modelo for maior que 51.200 bytes, a opção `--s3-bucket` ou a opção `--resolve-s3` serão obrigatórias. Se você especificar as opções `--s3-bucket` e `--resolve-s3`, ocorrerá um erro.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-prefix"></a>
O prefixo adicionado aos nomes dos artefatos que você faz upload para o bucket do Amazon S3. O nome do prefixo é um nome de caminho (nome da pasta) para o bucket do Amazon S3. Isso se aplica somente às funções declaradas com o tipo de pacote `Zip`.

`--save-params`  <a name="sam-cli-command-reference-sam-sync-options-save-params"></a>
Salva os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--skip-deploy-sync | --no-skip-deploy-sync`  <a name="sam-cli-command-reference-sam-sync-options-skip-deploy-sync"></a>
Especifica `--skip-deploy-sync` para ignorar a sincronização inicial da infraestrutura se ela não for necessária. Ele AWS SAMCLI comparará seu AWS SAM modelo local com o CloudFormation modelo implantado e executará uma implantação somente se uma alteração for detectada.  
Especifica `--no-skip-deploy-sync` a realização de uma CloudFormation implantação sempre que `sam sync` for executada.  
Para saber mais, consulte [Ignore a implantação inicial CloudFormation](using-sam-cli-sync.md#using-sam-cli-sync-options-skip-deploy-sync).  
*Padrão*: `--skip-deploy-sync`

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-sync-options-stack-name"></a>
O nome da CloudFormation pilha do seu aplicativo.  
Essa opção é obrigatória.

`--tags LIST`  <a name="sam-cli-command-reference-sam-sync-options-tags"></a>
Uma lista de tags a serem associadas à pilha criada ou atualizada. CloudFormation também propaga essas tags para recursos na pilha que as suportam.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-sync-options-template-file"></a>
O caminho e o nome do arquivo em que seu AWS SAM modelo está localizado.  
Se você especificar essa opção, AWS SAM implantará somente o modelo e os recursos locais para os quais ele aponta.

`--use-container, -u`  <a name="sam-cli-command-reference-sam-sync-options-use-container"></a>
Se suas funções dependerem de pacotes que tenham dependências compiladas de forma nativa, use essa opção para criar sua função dentro de um contêiner AWS Lambda semelhante Docker a.  
Atualmente, essa opção não é compatível com o `--dependency-layer`. Se você usa `--use-container` com `--dependency-layer`, AWS SAMCLI informa e continua com `--no-dependency-layer`.

`--watch`  <a name="sam-cli-command-reference-sam-sync-options-watch"></a>
Inicia um processo que monitora o aplicativo local em busca de alterações e as sincroniza automaticamente com o. Nuvem AWS Por padrão, quando você especifica essa opção, AWS SAM sincroniza todos os recursos em seu aplicativo à medida que você os atualiza. Com essa opção, AWS SAM executa uma CloudFormation implantação inicial. Em seguida, AWS SAM usa o AWS serviço APIs para atualizar os recursos de código. AWS SAM usa CloudFormation para atualizar recursos de infraestrutura quando você atualiza seu AWS SAM modelo.

`--watch-exclude TEXT`  <a name="sam-cli-command-reference-sam-sync-options-watch-exclude"></a>
Exclui um arquivo ou pasta da observação de alterações no arquivo. Para usar essa opção, `--watch` deverá ser fornecido.  
Cada opção recebe um par de valores-chave:  
+ **Chave** — O ID lógico de uma função do Lambda em seu aplicativo.
+ **Valor** — O nome do arquivo ou pasta associado a ser excluído.
Quando você atualiza quaisquer arquivos ou pastas especificados com a `--watch-exclude` opção, AWS SAM CLI eles não iniciarão uma sincronização. No entanto, quando uma atualização de outros arquivos ou pastas inicia uma sincronização, esses arquivos ou pastas serão incluídos nessa sincronização.  
Você pode fornecer essa opção várias vezes em um único comando.

## Exemplos
<a name="sam-cli-command-reference-sam-sync-examples"></a>

Para obter exemplos sobre como usar esse comando, consulte [Opções para o comando sam sync](using-sam-cli-sync.md#using-sam-cli-sync-options).

# sam traces
<a name="sam-cli-command-reference-sam-traces"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam traces`.

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam traces` comando busca AWS X-Ray traços em seu Conta da AWS no Região da AWS.

## Usage
<a name="sam-cli-command-reference-sam-traces-usage"></a>

```
$ sam traces <options>
```

## Opções
<a name="sam-cli-command-reference-sam-traces-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-traces-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “`samconfig.toml`“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
Busca rastros até agora. A hora pode ser valores relativos, como '5 minutos atrás', 'amanhã' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'.

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
Especifica o formato de saída para logs. Para imprimir registros formatados, especifique`text`. Para imprimir os registros como JSON, especifique `json`.

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
Busca traços a partir desse momento. A hora pode ser valores relativos, como '5 minutos atrás', 'ontem' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'. O padrão é '10 minutos atrás'.

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
Encerra a saída do rastreamento. Isso ignora o argumento de horário de término e continua exibindo rastreamentos à medida que eles se tornam disponíveis.

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
O identificador exclusivo para rastreamento com X-Ray.

## Exemplos
<a name="sam-cli-command-reference-sam-traces-examples"></a>

Execute o comando a seguir para buscar traços do X-Ray por ID.

```
$ sam traces --trace-id tracing-id-1 --trace-id tracing-id-2
```

Execute o comando a seguir para rastrear traços do X-Ray assim que estiverem disponíveis.

```
$ sam traces --tail
```

# sam validate
<a name="sam-cli-command-reference-sam-validate"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam validate`.

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam validate` comando verifica se um arquivo AWS SAM de modelo é válido.

## Usage
<a name="sam-cli-command-reference-sam-validate-usage"></a>

```
$ sam validate <options>
```

## Opções
<a name="sam-cli-command-reference-sam-validate-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-validate-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-validate-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-validate-options-debug"></a>
Ativa o registro de depuração para imprimir a mensagem de depuração gerada pelo AWS SAMCLI e exibir timestamps.

`--lint`  <a name="sam-cli-command-reference-sam-validate-options-lint"></a>
 Execute a validação de linting no modelo por meio de **cfn-lint**. Crie um arquivo de configuração `cfnlintrc` para especificar parâmetros adicionais. *Para obter mais informações, consulte [cfn-lint no repositório.](https://github.com/aws-cloudformation/cfn-lint)CloudFormation GitHub * 

`--profile TEXT`  <a name="sam-cli-command-reference-sam-validate-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-validate-options-region"></a>
A AWS região para a qual implantar. Por exemplo, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-validate-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-validate-options-template-file"></a>
 O arquivo AWS SAM de modelo. O valor padrão é `template.[yaml|yml]`.   
 Se o modelo estiver no diretório de trabalho atual e tiver um nome `template.[yaml|yml|json]`, essa opção não será necessária.   
 Se você acabou de executar **sam build**, essa opção não é necessária. 

## Exemplo
<a name="sam-cli-command-reference-sam-validate-examples"></a>

Para obter um exemplo sobre como usar esse comando para validar um modelo, consulte [Validar arquivos AWS SAM de modelo](serverless-sam-cli-using-validate.md).

Para obter em exemplo sobre como usar esse comando com cfn-lint, consulte [Valide seus AWS SAM aplicativos com CloudFormation o Linter](validate-cfn-lint.md).

# gerenciamento da CLI do AWS SAM
<a name="reference-sam-cli"></a>

Esta seção contém informações sobre como você pode gerenciar e personalizar sua versão do AWS SAMCLI. Estão incluídas informações sobre como você pode configurar os valores do parâmetro de comando da CLI do AWS SAM usando um arquivo de configuração no nível do projeto. Também inclui informações sobre como gerenciar diferentes versões do seu AWS SAMCLI, definir AWS credenciais para que você AWS SAM possa fazer chamadas para AWS serviços em seu nome e diferentes maneiras de personalizar AWS SAM. Esta seção termina com uma seção sobre AWS SAM solução geral de problemas.

**Topics**
+ [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md)
+ [Gerenciar versões do AWS SAM CLI](manage-sam-cli-versions.md)
+ [Configurando AWS credenciais](serverless-getting-started-set-up-credentials.md)
+ [Telemetria no AWS SAMCLI](serverless-sam-telemetry.md)
+ [AWS SAM CLI solução de problemas](sam-cli-troubleshooting.md)

# Arquivo de configuração do AWS SAM CLI
<a name="serverless-sam-cli-config"></a>

A interface de linha de AWS Serverless Application Model comando (AWS SAMCLI) oferece suporte a um arquivo de configuração em nível de projeto que você pode usar para configurar valores de parâmetros de AWS SAMCLI comando.

Para obter a documentação sobre como criar e usar arquivos de configuração, consulte [Configurando o AWS SAM CLI](using-sam-cli-configure.md).

**Topics**
+ [Configurações padrão do arquivo de configuração](#serverless-sam-cli-config-default)
+ [Formatos de arquivo de configuração suportados](#serverless-sam-cli-config-formats)
+ [Especificar um arquivo de configuração](#serverless-sam-cli-config-specify)
+ [Noções básicas de arquivos de configuração](#serverless-sam-cli-config-basics)
+ [Regras de valores de parâmetros](#serverless-sam-cli-config-rules)
+ [Precedência de configuração](#serverless-sam-cli-config-precedence)
+ [Criando e modificando arquivos de configuração](#serverless-sam-cli-config-using)

## Configurações padrão do arquivo de configuração
<a name="serverless-sam-cli-config-default"></a>

AWS SAM usa as seguintes configurações padrão do arquivo de configuração:
+ **Name**: `samconfig`.
+ **Localização** - Na raiz do seu projeto. Este é o mesmo local do seu arquivo `template.yaml`.
+ **Formato** – `TOML`. Para saber mais, consulte [TOML](https://toml.io/en/) na *documentação do TOML*.

Veja a seguir um exemplo de estrutura de projeto que inclui o nome e o local do arquivo de configuração padrão:

```
sam-app
├── README.md
├── __init__.py
├── events
├── hello_world
├── samconfig.toml
├── template.yaml
└── tests
```

O seguinte é um arquivo `samconfig.toml` de exemplo:

```
...
version = 0.1

[default]
[default.global]
[default.global.parameters]
stack_name = "sam-app"

[default.build.parameters]
cached = true
parallel = true

[default.deploy.parameters]
capabilities = "CAPABILITY_IAM"
confirm_changeset = true
resolve_s3 = true

[default.sync.parameters]
watch = true

[default.local_start_api.parameters]
warm_containers = "EAGER"

[prod]
[prod.sync]
[prod.sync.parameters]
watch = false
```

## Formatos de arquivo de configuração suportados
<a name="serverless-sam-cli-config-formats"></a>

Os formatos `TOML` e `[YAML|YML]` são suportados. Veja a seguinte sintaxe básica:

### TOML
<a name="serverless-sam-cli-config-formats-toml"></a>

```
version = 0.1
[environment]
[environment.command]
[environment.command.parameters]
option = parameter value
```

### YAML
<a name="serverless-sam-cli-config-formats-yaml"></a>

```
version: 0.1
environment:
  command:
    parameters:
      option: parameter value
```

## Especificar um arquivo de configuração
<a name="serverless-sam-cli-config-specify"></a>

Por padrão, o AWS SAMCLI procura um arquivo de configuração na seguinte ordem:

1. **Arquivo de configuração personalizado** — Se você usar a opção `--config-file` para especificar o nome e o local do arquivo, o AWS SAMCLI primeiro procurará esse arquivo.

1. **`samconfig.toml`Arquivo padrão** - Esse é o nome e o formato do arquivo de configuração padrão, localizado na raiz do seu projeto. Se você não especificar um arquivo de configuração personalizado, e AWS SAMCLI procurará esse arquivo em seguida.

1. **`samconfig.[yaml|yml]`arquivo** — Se o `samconfig.toml` não existir na raiz do seu projeto, AWS SAMCLI procurará esse arquivo.

Veja a seguir um exemplo de especificação de arquivo de configuração personalizado usando a opção `--config-file`:

```
$ sam deploy --config-file myconfig.yaml
```

**nota**  
O `--config-file` parâmetro deve ser relativo à localização do arquivo de AWS SAM modelo, pois é AWS SAMCLI necessário determinar o contexto no qual a configuração é aplicada. O `samconfig.toml` arquivo gerencia as configurações da sua versão do AWS SAMCLI, e a CLI procura o `samconfig.toml` arquivo (ou o parâmetro do arquivo de configuração substituído) na pasta relativa do arquivo. `template.yaml`

## Noções básicas de arquivos de configuração
<a name="serverless-sam-cli-config-basics"></a>

### Environment
<a name="serverless-sam-cli-config-basics-environment"></a>

Um **ambiente** é um identificador nomeado que contém um conjunto exclusivo de configurações. Você pode ter vários ambientes em um único AWS SAM aplicativo.

O nome do ambiente padrão é `default`.

Use a AWS SAMCLI `--config-env` opção para especificar o ambiente a ser usado.

### Command
<a name="serverless-sam-cli-config-basics-command"></a>

O **comando** é o comando AWS SAMCLI para o qual especificar valores de parâmetros.

Para especificar valores de parâmetros para todos os comandos, use o identificador `global`.

Ao referenciar um comando AWS SAM CLI, substitua espaços (` `) e hífens () por sublinhados (`–`). `_` Veja os exemplos a seguir:
+ `build`
+ `local_invoke`
+ `local_start_api`

### Parâmetros
<a name="serverless-sam-cli-config-basics-parameters"></a>

Os **parâmetros** são especificados como pares de chave-valor.
+ A **chave** é o nome da opção do comando AWS SAM CLI.
+ O **valor** é o valor a ser especificado.

Ao especificar chaves, use o nome da opção de comando de formato longo e substitua hífens (`–`) por sublinhados (`_`). Veja os exemplos a seguir:
+ `region`
+ `stack_name`
+ `template_file`

## Regras de valores de parâmetros
<a name="serverless-sam-cli-config-rules"></a>

### TOML
<a name="serverless-sam-cli-config-rules-toml"></a>
+ Os valores booleanos podem ser `true` ou `false`. Por exemplo, .`confirm_changeset = true`
+ Para valores de string, use aspas (`""`). Por exemplo, .`region = "us-west-2"`
+ Para valores de lista, use aspas (`""`) e separe cada valor usando um espaço (` `). Por exemplo: `capabilities = "CAPABILITY_IAM CAPABILITY_NAMED_IAM"`.
+ Para valores que contêm uma lista de pares de valores-chave, os pares são delimitados por espaço (` `) e o valor de cada par é cercado por aspas codificadas (`\" \"`). Por exemplo, .`tags = "project=\"my-application\" stage=\"production\""`
+ Para valores de parâmetros que podem ser especificados várias vezes, o valor é uma matriz de argumentos. Por exemplo: `image_repositories = ["my-function-1=image-repo-1", "my-function-2=image-repo-2"]`.

### YAML
<a name="serverless-sam-cli-config-rules-yaml"></a>
+ Os valores booleanos podem ser `true` ou `false`. Por exemplo, .`confirm_changeset: true`
+ Para entradas que contêm um único valor de string, as aspas (`""`) são opcionais. Por exemplo, .`region: us-west-2` Isso inclui entradas que contêm vários pares de valores-chave fornecidos como uma única sequência de caracteres. Este é um exemplo:

  ```
  $ sam deploy --tags "foo=bar hello=world"
  ```

  ```
  default:
    deploy:
      parameters:
        tags: foo=bar hello=world
  ```
+ Para entradas que contêm uma lista de valores ou entradas que podem ser usadas várias vezes em um único comando, especifique-as como uma lista de cadeias de caracteres.

  Este é um exemplo:

  ```
  $ sam remote invoke --parameter "InvocationType=Event" --parameter "LogType=None"
  ```

  ```
  default:
    remote_invoke:
      parameters:
          parameter:
          - InvocationType=Event
          - LogType=None
  ```

## Precedência de configuração
<a name="serverless-sam-cli-config-precedence"></a>

Ao configurar valores, a seguinte precedência ocorre:
+ Os valores dos parâmetros que você fornece na linha de comando têm precedência sobre os valores correspondentes no arquivo de configuração e na seção `Parameters` do arquivo de modelo.
+ Se a opção `--parameter-overrides` for usada na linha de comando ou em seu arquivo de configuração com a chave `parameter_overrides`, seus valores terão precedência sobre os valores na seção `Parameters` do arquivo de modelo.
+ Em seu arquivo de configuração, as entradas fornecidas para um comando específico têm precedência sobre as entradas globais. No exemplo a seguir, o comando `sam deploy` usará o nome da pilha `my-app-stack`.

------
#### [ TOML ]

  ```
  [default.global.parameters]
  stack_name = "common-stack"
  
  [default.deploy.parameters]
  stack_name = "my-app-stack"
  ```

------
#### [ YAML ]

  ```
  default:
    global:
      parameters:
        stack_name: common-stack
    deploy:
      parameters:
        stack_name: my-app-stack
  ```

------

## Criando e modificando arquivos de configuração
<a name="serverless-sam-cli-config-using"></a>

### Criação de arquivos de configuração
<a name="serverless-sam-cli-config-using-create"></a>

Quando você cria um aplicativo usando `sam init`, um arquivo `samconfig.toml` padrão é criado. Você também pode criar manualmente seu arquivo de configuração.

### Modificar arquivos de configuração
<a name="serverless-sam-cli-config-using-modify"></a>

Você pode modificar manualmente seus arquivos de configuração. Além disso, durante qualquer fluxo interativoCLI do AWS SAM, os valores configurados serão exibidos entre colchetes (`[ ]`). Se você modificar esses valores, AWS SAMCLI atualizará seu arquivo de configuração.

Veja a seguir um exemplo de fluxo interativo usando o comando `sam deploy --guided`:

```
$ sam deploy --guided

Configuring SAM deploy
======================

    Looking for config file [samconfig.toml] :  Found
    Reading default arguments  :  Success

    Setting default arguments for 'sam deploy'
    =========================================
    Stack Name [sam-app]: ENTER
    AWS Region [us-west-2]: ENTER
    #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
    Confirm changes before deploy [Y/n]: n
    #SAM needs permission to be able to create roles to connect to the resources in your template
    Allow SAM CLI IAM role creation [Y/n]: ENTER
    #Preserves the state of previously provisioned resources when an operation fails
    Disable rollback [y/N]: ENTER
    HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
    Save arguments to configuration file [Y/n]: ENTER
    SAM configuration file [samconfig.toml]: ENTER
    SAM configuration environment [default]: ENTER
```

Ao modificar seu arquivo de configuração, AWS SAM  CLI manipula os valores globais da seguinte forma:
+ Se o valor do parâmetro existir na seção `global` do seu arquivo de configuração, AWS SAMCLI não grava o valor na seção de comando específica.
+ Se o valor do parâmetro existir nas seções de comando específicas `global` e nas seções de comando específicas, AWS SAMCLI excluirá a entrada específica em favor do valor global.

# Gerenciar versões do AWS SAM CLI
<a name="manage-sam-cli-versions"></a>

Gerencie suas versões da interface de linha de AWS Serverless Application Model comando (AWS SAMCLI) por meio de atualização, downgrade e desinstalação. Opcionalmente, você pode baixar e instalar a compilação AWS SAMCLI noturna.

**Topics**
+ [Atualizar o AWS SAM CLI](#manage-sam-cli-versions-upgrade)
+ [Desinstalando o AWS SAMCLI](#manage-sam-cli-versions-uninstall)
+ [Pare de usar o Homebrew para gerenciar o AWS SAMCLI](#manage-sam-cli-versions-switch)
+ [Gerenciando a AWS SAMCLI compilação noturna](#manage-sam-cli-versions-nightly-build)
+ [Instalar a AWS SAM CLI em um ambiente virtual usando o pip](#manage-sam-cli-versions-install-virtual)
+ [Gerenciamento o AWS SAM CLI com o Homebrew](#manage-sam-cli-versions-homebrew)
+ [Solução de problemas](#manage-sam-cli-versions-troubleshoot)

## Atualizar o AWS SAM CLI
<a name="manage-sam-cli-versions-upgrade"></a>

### Linux
<a name="manage-sam-cli-versions-upgrade-linux"></a>

Para atualizar o AWS SAMCLI no Linux, siga as instruções de instalação em [Instalar o AWS SAM CLI](install-sam-cli.md#install-sam-cli-instructions), mas adicione a opção `--update` ao comando de instalação, da seguinte forma:

```
sudo ./sam-installation/install --update
```

### macOS
<a name="manage-sam-cli-versions-upgrade-macos"></a>

O AWS SAMCLI deve ser atualizado pelo mesmo método usado para instalá-lo. Recomendamos que você use o instalador do pacote para instalar e atualizar AWS SAMCLI o.

 Para atualizar o AWS SAMCLI usando o instalador de pacotes, instale a versão mais recente do pacote. Para obter instruções, consulte [Instalar o AWS SAM CLI](install-sam-cli.md#install-sam-cli-instructions). 

### Windows
<a name="manage-sam-cli-versions-upgrade-windows"></a>

Para atualizar o AWS SAMCLI, repita as etapas de instalação do Windows [Instale o AWS SAM CLI](install-sam-cli.md) novamente.

## Desinstalando o AWS SAMCLI
<a name="manage-sam-cli-versions-uninstall"></a>

### Linux
<a name="manage-sam-cli-versions-uninstall-linux"></a>

Para desinstalar o AWS SAMCLI no Linux, você deve excluir o symlink e o diretório de instalação executando os seguintes comandos:

1. Localize o symlink e instale caminhos.
   + Encontre o link simbólico usando o **which** comando:

     ```
     which sam
     ```

     A saída mostra o caminho em que os AWS SAM binários estão localizados, por exemplo:

     ```
      /usr/local/bin/sam
     ```
   + Encontre o diretório para o qual o link simbólico aponta usando o **ls** comando:

     ```
     ls -l /usr/local/bin/sam
     ```

     No exemplo a seguir, o diretório de instalação é `/usr/local/aws-sam-cli`.

     ```
      lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
     ```

1. Exclua o symlink.

   ```
   sudo rm /usr/local/bin/sam
   ```

1. Exclua o diretório de instalação.

   ```
   sudo rm -rf /usr/local/aws-sam-cli
   ```

### macOS
<a name="manage-sam-cli-versions-uninstall-macos"></a>

Desinstale o AWS SAMCLI por meio do mesmo método usado para instalá-lo. Recomendamos que você use o instalador do pacote para instalar AWS SAMCLI o.

Se você instalou o AWS SAMCLI usando o instalador do pacote, siga estas etapas para desinstalar.

**Para desinstalar o AWS SAM CLI**

1.  Remova o programa AWS SAMCLI modificando e executando o seguinte: 

   ```
   $ sudo rm -rf /path-to/aws-sam-cli
   ```

   1.  *sudo*— Se o seu usuário tiver permissões de gravação no local onde o AWS SAMCLI programa está instalado, não **sudo** é necessário. Caso contrário, o **sudo** será obrigatório. 

   1.  */path-to*— Caminho até onde você instalou o AWS SAMCLI programa. O local padrão é `/usr/local`. 

1.  Remova o AWS SAMCLI `$PATH` modificando e executando o seguinte: 

   ```
   $ sudo rm -rf /path-to-symlink-directory/sam
   ```

   1.  *sudo*— Se o seu usuário tiver permissões de gravação para`$PATH`, não **sudo** é necessário. Caso contrário, o **sudo** será obrigatório. 

   1.  *path-to-symlink-directory*— Sua variável de `$PATH` ambiente. O local padrão é `/usr/local/bin`. 

1.  Verifique se o AWS SAMCLI está desinstalado executando o seguinte: 

   ```
   $ sam --version
   command not found: sam
   ```

### Windows
<a name="manage-sam-cli-versions-uninstall-windows"></a>

Para desinstalar o AWS SAMCLI usando as Configurações do Windows, siga estas etapas:

1. No menu Iniciar, procure por “Adicionar ou remover programas”.

1. Escolha o resultado chamado **AWS SAM Interface da linha de comando** e escolha **Desinstalar** para executar o desinstalador.

1. Confirme que você deseja desinstalar AWS SAMCLI o.

## Pare de usar o Homebrew para gerenciar o AWS SAMCLI
<a name="manage-sam-cli-versions-switch"></a>

Se você usa Homebrew para instalar e atualizar o AWS SAMCLI, recomendamos usar um método AWS compatível. Siga estas instruções para mudar para um método compatível.

**Para deixar de usar o Homebrew**

1. Siga as instruções em [Desinstalando uma CLI Homebrew instalada AWS SAM](#manage-sam-cli-versions-homebrew-uninstall) para desinstalar a versão do Homebrew gerenciada.

1. Siga as instruções em [Instale o AWS SAM CLI](install-sam-cli.md) para instalar a CLI AWS SAM usando um método compatível.

## Gerenciando a AWS SAMCLI compilação noturna
<a name="manage-sam-cli-versions-nightly-build"></a>

Você pode baixar e instalar a versão AWS SAMCLI noturna. Ela contém uma versão de pré-lançamento do código AWS SAMCLI que pode ser menos estável do que a versão de produção. Quando instalado, você pode usar a compilação noturna com o comando `sam-nightly`. Você pode instalar e usar as versões de produção e compilação noturna do AWS SAMCLI ao mesmo tempo.

**nota**  
A compilação noturna não contém uma versão de pré-lançamento da imagem de compilação. Por isso, criar seu aplicativo sem servidor com a opção **--use-container** usa a versão de produção mais recente da imagem de compilação.

### Instalando a compilação AWS SAMCLI noturna
<a name="manage-sam-cli-versions-nightly-build-install"></a>

Para instalar a AWS SAMCLI versão noturna, siga estas instruções.

#### Linux
<a name="manage-sam-cli-versions-nightly-build-install-linux"></a>

Você pode instalar a versão de compilação noturna do AWS SAMCLI na plataforma Linux x86\$164 usando o instalador do pacote.

**Para instalar a compilação AWS SAMCLI noturna**

1. Baixe o instalador do pacote [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)no *aws-sam-cli GitHubrepositório.*

1. Siga as etapas de [instalação do AWS SAMCLI](install-sam-cli.md) para instalar o pacote de compilação noturna.

#### macOS
<a name="manage-sam-cli-versions-nightly-build-install-macos"></a>

Você pode instalar a versão de compilação noturna do AWS SAMCLI na macOS usando o instalador do pacote de compilação noturna.

**Para instalar a compilação AWS SAMCLI noturna**

1. Baixe o instalador do pacote para sua plataforma [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)no *aws-sam-cli GitHubrepositório.*

1. Siga as etapas de [instalação do AWS SAMCLI](install-sam-cli.md) para instalar o pacote de compilação noturna.

#### Windows
<a name="manage-sam-cli-versions-nightly-build-windows"></a>

A versão de compilação noturna do AWS SAMCLI está disponível com este link para download: [AWS SAMCLI compilação noturna](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi). Para instalar a compilação noturna no Windows, execute as mesmas etapas do [Instale o AWS SAM CLI](install-sam-cli.md), mas use o link de download da compilação noturna.

Para verificar se você instalou a versão de compilação noturna, execute o comando **sam-nightly --version**. A saída desse comando está no formato `1.X.Y.dev<YYYYMMDDHHmm>`, por exemplo:

```
SAM CLI, version 1.20.0.dev202103151200
```

### Mude do Homebrew para o instalador de pacotes
<a name="manage-sam-cli-versions-nightly-build-switch"></a>

Se você estiver usando o Homebrew para instalar e atualizar a compilação AWS SAMCLI noturna e quiser passar a usar o instalador de pacotes, siga estas etapas.

**Para mudar do Homebrew para o instalador de pacotes**

1. Desinstale a Homebrew compilação AWS SAMCLI noturna instalada.

   ```
   $ brew uninstall aws-sam-cli-nightly
   ```

1. Verifique se a compilação AWS SAMCLI noturna está desinstalada executando o seguinte:

   ```
   $ sam-nightly --version
   zsh: command not found: sam-nightly
   ```

1. Siga as etapas da seção anterior para instalar a compilação AWS SAMCLI noturna.

## Instalar a AWS SAM CLI em um ambiente virtual usando o pip
<a name="manage-sam-cli-versions-install-virtual"></a>

Recomendamos usar o instalador de pacotes nativo para instalar AWS SAMCLI o. Se você precisar usar o pip, recomendamos que você instale a AWS SAM CLI em um ambiente virtual. Isso garante um ambiente de instalação limpo e um ambiente isolado caso ocorram erros.

**nota**  
Em 24 de outubro de 2023, AWS SAM CLI o suporte para o. Python 3.7 Para saber mais, consulte [AWS SAMCLI descontinuando o suporte para Python 3.7](important-notes.md#important-notes-2023-10-python).

**Como instalar a AWS SAM CLI em um ambiente virtual**

1. Em um diretório inicial de sua escolha, crie um ambiente virtual e dê um nome a ele.

------
#### [ Linux / macOS ]

   ```
   $ mkdir project
   $ cd project
   $ python3 -m venv venv
   ```

------
#### [ Windows ]

   ```
   > mkdir project
   > cd project
   > py -3 -m venv venv
   ```

------

1. Ative o ambiente virtual.

------
#### [ Linux / macOS ]

   ```
   $ . venv/bin/activate
   ```

   O prompt mudará para mostrar que seu ambiente virtual está ativo.

   ```
   (venv) $ 
   ```

------
#### [ Windows ]

   ```
   > venv\Scripts\activate
   ```

   O prompt mudará para mostrar que seu ambiente virtual está ativo.

   ```
   (venv) > 
   ```

------

1. Instale a AWS SAMCLI em seu ambiente virtual.

   ```
   (venv) $ pip install --upgrade aws-sam-cli
   ```

1. Verifique se o AWS SAMCLI está instalado corretamente.

   ```
   (venv) $ sam --version
   SAM CLI, version 1.94.0
   ```

1. Use o comando `deactivate` para sair do ambiente virtual. Sempre que você iniciar uma nova sessão, deverá ativar novamente o ambiente.

## Gerenciamento o AWS SAM CLI com o Homebrew
<a name="manage-sam-cli-versions-homebrew"></a>

**nota**  
A partir de setembro de 2023, não AWS manterá mais o Homebrew instalador AWS gerenciado do AWS SAMCLI (`aws/tap/aws-sam-cli`). Para continuar usando o Homebrew, use o instalador gerenciado pela comunidade (`aws-sam-cli`). A partir de setembro de 2023, qualquer comando Homebrew que faça referência a `aws/tap/aws-sam-cli` será redirecionado para o `aws-sam-cli`.  
Recomendamos que você use nossos métodos de [instalação](install-sam-cli.md) e [atualização](#manage-sam-cli-versions-upgrade) compatíveis.

### Instalar a AWS SAMCLI usando o Homebrew
<a name="manage-sam-cli-versions-homebrew-install"></a>

**nota**  
Essas instruções usam o AWS SAMCLI Homebrew instalador gerenciado pela comunidade. Para obter mais suporte, consulte o repositório *[homebrew-core](https://github.com/Homebrew/homebrew-core/issues)*.

**Para instalar o AWS SAM CLI**

1. Execute o seguinte:

   ```
   $ brew install aws-sam-cli
   ```

1. Verifique a instalação:

   ```
   $ sam --version
   ```

   Após a instalação bem-sucedida do AWS SAMCLI, você deverá ver uma saída como a seguinte:

   ```
   SAM CLI, version 1.94.0
   ```

### Atualizando o uso do AWS SAMCLI Homebrew
<a name="manage-sam-cli-versions-homebrew-upgrade"></a>

Para atualizar a AWS SAM CLI usando o Homebrew, execute este comando:

```
$ brew upgrade aws-sam-cli
```

### Desinstalando uma CLI Homebrew instalada AWS SAM
<a name="manage-sam-cli-versions-homebrew-uninstall"></a>

Se a AWS SAMCLI foi instalada usando o Homebrew, siga estas etapas para desinstalá-la.

**Para desinstalar o AWS SAM CLI**

1. Execute o seguinte:

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Verifique se o AWS SAMCLI está desinstalado executando o seguinte:

   ```
   $ sam --version
   command not found: sam
   ```

### Como mudar para o instalador Homebrew gerenciado pela comunidade
<a name="manage-sam-cli-versions-homebrew-switch"></a>

Se você estiver usando o Homebrew instalador AWS gerenciado (`aws/tap/aws-sam-cli`) e preferir continuar usandoHomebrew, recomendamos mudar para o Homebrew instalador gerenciado pela comunidade (`aws-sam-cli`).

Para alternar em um único comando, execute o seguinte:

```
$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli
```

Siga estas instruções para executar cada comando individualmente.

**Para mudar para o Homebrew instalador gerenciado pela comunidade**

1. Desinstale a Homebrew versão AWS gerenciada do AWS SAMCLI:

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Verifique se o AWS SAMCLI foi desinstalado:

   ```
   $ which sam
   sam not found
   ```

1. Remova o AWS SAMCLI toque AWS gerenciado:

   ```
   $ brew untap aws/tap
   ```

   Se você receber um erro como o seguinte, adicione a opção `--force` e tente novamente.

   ```
   Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
   aws-sam-cli-nightly
   ```

1. Remova os arquivos em cache do instalador AWS gerenciado:

   ```
   $ brew cleanup aws/tap
   ```

1. Atualize o Homebrew e todas as fórmulas:

   ```
   $ brew update
   ```

1. Instale a versão gerenciada pela comunidade do AWS SAMCLI:

   ```
   $ brew install aws-sam-cli
   ```

1. Verifique se a instalação do AWS SAM CLI foi bem-sucedida.

   ```
   $ sam --version
   SAM CLI, version 1.94.0
   ```

## Solução de problemas
<a name="manage-sam-cli-versions-troubleshoot"></a>

Se você encontrar erros ao instalar ou usar o AWS SAMCLI, consulte[AWS SAM CLI solução de problemas](sam-cli-troubleshooting.md).

# Configurando AWS credenciais
<a name="serverless-getting-started-set-up-credentials"></a>

A interface de linha de AWS SAM comando (CLI) exige que você defina AWS credenciais para que ela possa fazer chamadas para AWS serviços em seu nome. Por exemplo, ele AWS SAMCLI faz chamadas para o Amazon S3 e. CloudFormation

Talvez você já tenha definido AWS credenciais para trabalhar com AWS ferramentas, como uma das AWS SDKs ou a. AWS CLI Caso contrário, este tópico mostra as abordagens recomendadas para definir AWS credenciais.

Para definir AWS as credenciais, você deve ter o *ID da chave de acesso* e a *chave de acesso secreta* do usuário do IAM que você deseja configurar. Para obter informações sobre chaves de acesso IDs e chaves de acesso secretas, consulte [Gerenciamento de 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*.

Em seguida, determine se você tem o AWS CLI instalado. Em seguida, siga as instruções em uma das seguintes seções:

## Usando o AWS CLI
<a name="serverless-getting-started-set-up-credentials-cli"></a>

Se você tiver o AWS CLI instalado, use o `aws configure` comando e siga as instruções:

```
$ aws configure
AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: 
Default output format [None]:
```

Para obter mais informações, sobre o comando `aws configure` consulte [Configuração rápida do comando AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-quick-configuration) no *AWS Command Line Interface Guia do usuário do*.

## Não usando o AWS CLI
<a name="serverless-getting-started-set-up-credentials-no-cli"></a>

Se você não tiver o AWS CLI instalado, poderá criar um arquivo de credenciais ou definir variáveis de ambiente:
+ **Arquivo de credenciais** — Você pode definir as credenciais no arquivo de AWS credenciais do seu sistema local. Esse arquivo deve estar localizado em uma das localizações a seguir:
  + `~/.aws/credentials` no Linux ou macOS
  + `C:\Users\USERNAME\.aws\credentials` no Windows

  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
  ```

   
+ **Variáveis de ambiente** — Você pode definir as variáveis de ambiente `AWS_ACCESS_KEY_ID` e `AWS_SECRET_ACCESS_KEY`.

  Para definir essas variáveis no Linux ou no macOS, use o comando **exportar**:

  ```
  export AWS_ACCESS_KEY_ID=your_access_key_id
  export AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

  Para definir essas variáveis no Windows, use o comando **configurar**:

  ```
  set AWS_ACCESS_KEY_ID=your_access_key_id
  set AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

# Telemetria no AWS SAMCLI
<a name="serverless-sam-telemetry"></a>

Na AWS, desenvolvemos e lançamos serviços com base no que aprendemos com as interações com os clientes. Usamos o feedback dos clientes para iterar nosso produto. A telemetria é uma informação adicional que nos ajuda a compreender melhor as necessidades dos nossos clientes, diagnosticar problemas e fornecer recursos que melhoram a experiência do cliente.

A interface de linha de AWS SAM comando (CLI) coleta telemetria, como métricas genéricas de uso, informações do sistema e do ambiente e erros. Para obter detalhes sobre os tipos de telemetria coletados, consulte [Tipos de informação coletados](#serverless-sam-telemtry-data-collected).

O AWS SAM CLI local **não** coleta informações pessoais, como nomes de usuário ou endereços de e-mail. Ele também não extrai informações sigilosas em nível de projeto.

Os clientes controlam se a telemetria está ativada e podem alterar as configurações a qualquer momento. Se a telemetria permanecer ativada, o AWS SAM CLI local enviará dados de telemetria em segundo plano sem exigir nenhuma interação adicional com o cliente.

## Desative a telemetria para uma sessão
<a name="serverless-sam-telemtry-opt-out"></a>

Nos sistemas operacionais macOS e Linux, você pode desativar a telemetria de uma única sessão. Para desativar a telemetria da sessão atual, execute o comando a seguir a fim de definir a variável de ambiente `SAM_CLI_TELEMETRY` como `false`. Repita o comando para cada novo terminal ou sessão.

```
export SAM_CLI_TELEMETRY=0
```

## Desative a telemetria do seu perfil em todas as sessões
<a name="serverless-sam-telemtry-opt-out-profile"></a>

Execute os comandos a seguir para desativar a telemetria em todas as sessões quando você estiver executando o AWS SAMCLI no seu sistema operacional.

### Para desabilitar a telemetria no Linux
<a name="w2aac28c19c16c15b5"></a>

1. Execute:

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Execute:

   ```
   source ~/.profile
   ```

### Para desabilitar a telemetria no macOS
<a name="w2aac28c19c16c15b7"></a>

1. Execute:

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Execute:

   ```
   source ~/.profile
   ```

### Para desabilitar a telemetria no Windows
<a name="w2aac28c19c16c15b9"></a>

Você pode definir a variável de ambiente temporariamente durante a vida útil da janela do terminal com o seguinte comando:

Se estiver usando o prompt de comando:

```
set SAM_CLI_TELEMETRY=0
```

Se estiver usando PowerShell:

```
$env:SAM_CLI_TELEMETRY=0
```

Para definir a variável de ambiente permanentemente no prompt de comando ou PowerShell, use o seguinte comando:

```
setx SAM_CLI_TELEMETRY 0
```

**nota**  
As alterações não entrarão em vigor até que o terminal tenha sido fechado e reaberto.

## Tipos de informação coletados
<a name="serverless-sam-telemtry-data-collected"></a>
+ **Informações de uso** — Os comandos e subcomandos genéricos que os clientes executam.
+ **Erros e informações de diagnóstico** — O status e a duração dos comandos que os clientes executam, incluindo códigos de saída, nomes de exceções internas e falhas na conexão com o Docker.
+ **Informações do sistema e do ambiente** — A versão do Python, o sistema operacional (Windows, Linux ou macOS), o ambiente no qual AWS SAMCLI ele é executado (por exemplo AWS CodeBuild, um kit de ferramentas do AWS IDE ou um terminal) e os valores de hash dos atributos de uso.

## Saiba mais
<a name="serverless-sam-telemtry-learn-more"></a>

Os dados de telemetria que eles AWS SAMCLI coletam seguem as políticas de privacidade de dados. AWS Para saber mais, consulte:
+ [AWS Termos de serviço](https://aws.amazon.com/service-terms/)
+ [Perguntas frequentes sobre privacidade de dados](https://aws.amazon.com/compliance/data-privacy-faq/)

# AWS SAM CLI solução de problemas
<a name="sam-cli-troubleshooting"></a>

Esta seção fornece detalhes sobre como solucionar mensagens de erro ao usar, instalar e gerenciar a interface de linha de AWS Serverless Application Model comando (AWS SAMCLI).

**Topics**
+ [Solução de problemas](#install-sam-cli-troubleshooting)
+ [Mensagens de erro](#sam-cli-troubleshoot-messages)
+ [Mensagens de aviso](#sam-cli-troubleshoot-warning)

## Solução de problemas
<a name="install-sam-cli-troubleshooting"></a>

Para obter orientações sobre solução de problemas relacionadas a AWS SAMCLI, consulte[Solução de problemas de erros de instalação do](install-sam-cli.md#sam-cli-troubleshoot-install).

## Mensagens de erro
<a name="sam-cli-troubleshoot-messages"></a>

### Erro de curl: “curl: (6) Não foi possível resolver: ...”
<a name="sam-cli-troubleshoot-messages-curl"></a>

Ao tentar invocar o endpoint do API Gateway, você receberá o seguinte erro:

```
curl: (6) Could not resolve: endpointdomain (Domain name not found)
```

Isso significa que você tentou enviar uma solicitação para um domínio que não é válido. Isso pode acontecer se o aplicativo com tecnologia sem servidor falhar na implantação bem-sucedida ou se você tiver um erro de digitação no comando. **curl** Verifique se o aplicativo foi implantado com êxito usando o CloudFormation console ou o AWS CLI e verifique se o **curl** comando está correto.

### Erro: não é possível encontrar informações exatas do recurso com o nome da pilha fornecido
<a name="sam-cli-troubleshoot-messages-exact-resource"></a>

Ao executar o comando `sam remote invoke` em um aplicativo que contém um único recurso de função do Lambda, você vê o seguinte erro:

```
Error: Can't find exact resource information with given <stack-name>. Please provide full resource ARN or --stack-name to resolve the ambiguity.
```

**Possível causa: você não forneceu a opção `--stack-name`.**  
Se o ARN de uma função não for fornecido como argumento, o comando `sam remote invoke` exigirá que a opção `--stack-name` seja fornecida.

**Solução: forneça a opção `--stack-name`.**  
Veja um exemplo a seguir.  

```
$ sam remote invoke --stack-name sam-app

Invoking Lambda Function HelloWorldFunction                                                                                                                                                                                                                     
START RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82 Version: $LATEST
END RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82
REPORT RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82  Duration: 11.31 ms      Billed Duration: 12 ms  Memory Size: 128 MB     Max Memory Used: 67 MB  Init Duration: 171.71 ms
{"statusCode":200,"body":"{\"message\":\"hello world\"}"}%
```

### Erro: não é possível encontrar informações do recurso com o nome da pilha
<a name="sam-cli-troubleshoot-messages-stack-name"></a>

Ao executar o comando `sam remote invoke` e passar o ARN de uma função do Lambda como argumento, você vê o seguinte erro:

```
Error: Can't find resource information from stack name (<stack-name>) and resource id (<function-id>)
```

**Possível causa: você tem o valor do nome da pilha definido em seu `samconfig.toml` arquivo.**  
A AWS SAMCLI primeiro verifica o nome da pilha em seu arquivo `samconfig.toml`. Se especificado, o argumento é passado como um valor lógico de ID.

**Solução: em vez disso, passe o ID lógico da função.**  
Você pode passar o ID lógico da função como argumento em vez do ARN da função.

**Solução: remova o valor do nome da pilha do seu arquivo de configuração.**  
Você pode remover o valor do nome da pilha do seu arquivo de configuração. Isso impede que o AWS SAMCLI transmita o ARN da função como um valor lógico de ID.  
Execute `sam build` depois de modificar seu arquivo de configuração.

### Erro: "Falha ao criar recursos gerenciados: não é possível localizar credenciais
<a name="sam-cli-troubleshoot-messages-credentials"></a>

Ao executar o comando **sam deploy**, você vê o seguinte erro:

```
Error: Failed to create managed resources: Unable to locate credentials
```

Isso significa que você não configurou AWS credenciais para permitir que o AWS SAMCLI faça chamadas AWS de serviço. Para corrigir isso, você deve configurar AWS as credenciais. Para obter mais informações, consulte [Configurando AWS credenciais](serverless-getting-started-set-up-credentials.md).

### Erro: FileNotFoundError no Windows
<a name="sam-cli-troubleshoot-messages-filenotfound-win"></a>

Ao executar comandos na CLI do AWS SAM no Windows, você pode ver o seguinte erro:

```
Error: FileNotFoundError
```

Possível causa: Eles AWS SAMCLI podem interagir com caminhos de arquivo que excedam o limite máximo de caminhos do Windows.

Solução: para solucionar esse problema, o novo comportamento de caminhos longos deverá ser habilitado. Para fazer isso, consulte [Habilitar caminhos longos no Windows 10, versão 1607 e posterior](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later) na *Documentação para desenvolvimento de aplicações do Windows*.

### Erro: resolvedor de dependências do pip...
<a name="sam-cli-troubleshoot-messages-pip"></a>

*Exemplo de texto de erro:*

```
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. 
aws-sam-cli 1.58.0 requires aws-sam-translator==1.51.0, but you have aws-sam-translator 1.58.0 which is incompatible. 
aws-sam-cli 1.58.0 requires typing-extensions==3.10.0.0, but you have typing-extensions 4.4.0 which is incompatible.
```

**Possível causa: Se você usa pip para instalar pacotes, as dependências entre os pacotes podem entrar em conflito.**  
Cada versão do pacote `aws-sam-cli` depende de uma versão do pacote `aws-sam-translator`. Por exemplo, a v1.58.0 do `aws-sam-cli` pode depender da v1.51.0 do `aws-sam-translator`.  
Se você instalar o AWS SAMCLI usando pip, e, em seguida, instalar outro pacote que dependa de uma versão mais recente do `aws-sam-translator`, ocorrerá o seguinte:  
+ A versão mais recente do `aws-sam-translator` será instalada.
+ A versão atual do `aws-sam-cli` e a versão mais recente do `aws-sam-translator` podem não ser compatíveis.
+ Quando você usa o AWS SAMCLI, o erro do resolvedor de dependências ocorrerá.

**Soluções:**

1. Use o instalador de pacotes AWS SAMCLI nativo.

   1. Desinstalar a AWS SAM CLI usando pip. Para obter instruções, consulte [Desinstalando o AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall).

   1. Instale o AWS SAMCLI usando o instalador de pacote nativo. Para obter instruções, consulte [Instale o AWS SAM CLI](install-sam-cli.md).

   1. Quando necessário, atualize o AWS SAMCLI usando o instalador de pacotes nativo. Para obter instruções, consulte [Atualizar o AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

1. Se você precisar usar o pip, recomendamos que você instale a AWS SAM CLI em um ambiente virtual. Isso garante um ambiente de instalação limpo e um ambiente isolado caso ocorram erros. Para obter instruções, consulte [Instalar a AWS SAM CLI em um ambiente virtual usando o pip](manage-sam-cli-versions.md#manage-sam-cli-versions-install-virtual).

### Erro: Esse comando 'remoto' não existe
<a name="sam-cli-troubleshoot-messages-command-remote"></a>

Ao executar o comando `sam remote invoke`, você vê o seguinte erro:

```
$ sam remote invoke ...
2023-06-20 08:15:07 Command remote not available
Usage: sam [OPTIONS] COMMAND [ARGS]...
Try 'sam -h' for help.

Error: No such command 'remote'.
```

**Possível causa: Sua versão do AWS SAMCLI está desatualizada.**  
O AWS SAMCLI `sam remote invoke` comando foi lançado com a AWS SAMCLI versão 1.88.0. Você pode verificar sua versão executando o comando `sam --version`.

**Solução: atualize seu AWS SAMCLI para a versão mais recente.**  
Para obter instruções, consulte [Atualizar o AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

### Erro: é necessário executar projetos AWS SAM localmenteDocker. Você o instalou?
<a name="sam-cli-troubleshoot-messages-docker"></a>

Ao executar o comando **sam local start-api**, você vê o seguinte erro:

```
Error: Running AWS SAM projects locally requires Docker. Have you got it installed?
```

Isso significa que você não instalou o Docker corretamente Docker é necessário testar seu aplicativo localmente. Para corrigir isso, siga as instruções para instalar o Docker para seu host de desenvolvimento. Para obter mais informações, consulte [Instalação do Docker](install-docker.md).

### Erro: restrições de segurança não satisfeitas
<a name="sam-cli-troubleshoot-messages-security-constraints"></a>

Ao executar o **sam deploy --guided**, você recebe a pergunta `Function may not have authorization defined, Is this okay? [y/N]`. Se responder a essa solicitação com **N** (a resposta padrão), você receberá o seguinte erro:

```
Error: Security Constraints Not Satisfied
```

O aviso está informando que o aplicativo que você está prestes a implantar pode ter uma API do Amazon API Gateway acessível ao público configurada sem autorização. Ao responder **N** a essa solicitação, você está dizendo que isso não está certo.

Para corrigir isso, você tem as seguintes opções:
+ Configurar seu aplicativo com autorização. Para obter informações sobre como configurar a autorização, consulte [Controle o acesso à API com seu AWS SAM modelo](serverless-controlling-access-to-apis.md).
+ Se sua intenção é ter um endpoint de API acessível ao público sem autorização, reinicie sua implantação e responda a essa pergunta com **Y** para indicar que você concorda com a implantação.

### mensagem: Token de autenticação ausente
<a name="sam-cli-troubleshoot-messages-auth-token"></a>

Ao tentar invocar o endpoint do API Gateway, você receberá o seguinte erro:

```
{"message":"Missing Authentication Token"}
```

Isso significa que você tentou enviar uma solicitação para o domínio correto, mas o URI não é reconhecível. Para corrigir isso, verifique o URL completo e atualize o comando **curl** com o URL correto.

## Mensagens de aviso
<a name="sam-cli-troubleshoot-warning"></a>

### Aviso:... AWS não manterá mais o Homebrew instalador por AWS SAM ...
<a name="sam-cli-troubleshoot-warning-homebrew"></a>

Ao instalar o AWS SAMCLI usando o Homebrew, você verá a seguinte mensagem de aviso:

```
Warning: ... AWS will no longer maintain the Homebrew installer for AWS SAM (aws/tap/aws-sam-cli). 
				For AWS supported installations, use the first party installers ...
```

**Causa potencial: AWS não manter mais o Homebrew suporte.**  
A partir de setembro de 2023, não AWS manterá mais o Homebrew instalador do AWS SAMCLI.  

**Solução: use um método de instalação AWS compatível.**
+ Você pode encontrar métodos de instalação AWS compatíveis em[Instale o AWS SAM CLI](install-sam-cli.md).

**Solução: para continuar usando o Homebrew, use o instalador gerenciado pela comunidade.**
+ Você pode usar o instalador gerenciado pela comunidade Homebrew a seu critério. Para obter instruções, consulte [Gerenciamento o AWS SAM CLI com o Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew).

# AWS SAM referência do conector
<a name="reference-sam-connector"></a>

Esta seção contém informações de referência para o tipo de recurso do conector AWS Serverless Application Model (AWS SAM). Para obter uma introdução aos conectores, consulte [Gerenciando permissões de recursos com AWS SAM conectores](managing-permissions-connectors.md).

## Tipos de recursos de origem e destino suportados para conectores
<a name="supported-connector-resource-types"></a>

O tipo de recurso `AWS::Serverless::Connector` oferece suporte a um número selecionado de conexões entre os recursos de origem e destino. Ao configurar conectores em seu AWS SAM modelo, use a tabela a seguir para referenciar as conexões suportadas e as propriedades que precisam ser definidas para cada tipo de recurso de origem e destino. Para obter mais informações sobre como configurar conectores no seu modelo, consulte [AWS::Serverless::Connector](sam-resource-connector.md).

Para recursos de origem e destino, quando definidos no mesmo modelo, use a propriedade `Id`. Opcionalmente, um `Qualifier` pode ser adicionado para restringir o escopo do seu recurso definido. Quando o recurso não estiver no mesmo modelo, use uma combinação de propriedades compatíveis.

 Para solicitar novas conexões, [envie um novo problema](https://github.com/aws/serverless-application-model/issues/new?assignees=&labels=area%2Fconnectors,stage%2Fneeds-triage&template=other.md&title=%28New%20Connector%20Profile%29) no *serverless-application-model AWS GitHubrepositório.*


| Source type (Tipo de origem) | Tipo de destino | Permissões | Propriedades da fonte | Propriedades de Destino | 
| --- | --- | --- | --- | --- | 
| `AWS::ApiGateway::RestApi` | `AWS::Lambda::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::ApiGateway::RestApi` | `AWS::Serverless::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Lambda::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Serverless::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Read` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Events::EventBus` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Lambda::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Read` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Lambda::Function` | `Write` | `Id`ou `ResourceId` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Serverless::Function` | `Write` | `Id`ou `ResourceId` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Lambda::Function` | `Read` | `Id`ou `Arn` e `Type` | `Id`ou `RoleName` e `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Serverless::Function` | `Read` | `Id`ou `Arn` e `Type` | `Id`ou `RoleName` e `Type` | 
| `AWS::Events::Rule` | `AWS::Events::EventBus` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::Lambda::Function` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::Function` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::StateMachine` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::SNS::Topic` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::SQS::Queue` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn``QueueUrl`, e `Type` | 
| `AWS::Events::Rule` | `AWS::StepFunctions::StateMachine` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Events::EventBus` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Lambda::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Location::PlaceIndex` | `Read` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn``Name`, e `Type` | 
| `AWS::Lambda::Function` | `AWS::SNS::Topic` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn``Name`, e `Type` | 
| `AWS::S3::Bucket` | `AWS::Lambda::Function` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::S3::Bucket` | `AWS::Serverless::Function` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Api` | `AWS::Lambda::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Api` | `AWS::Serverless::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Events::EventBus` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Lambda::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn``Name`, e `Type` | 
| `AWS::Serverless::Function` | `AWS::SNS::Topic` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn``Name`, e `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Lambda::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Serverless::Function` | `Write` | `Id`ou `Qualifier``ResourceId`, e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Lambda::Function` | `Read` | `Id`ou `Arn` e `Type` | `Id`ou `RoleName` e `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Serverless::Function` | `Read` | `Id`ou `Arn` e `Type` | `Id`ou `RoleName` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn``Name`, e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn``Name`, e `Type` | 
| `AWS::SNS::Topic` | `AWS::Lambda::Function` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::SNS::Topic` | `AWS::Serverless::Function` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::SNS::Topic` | `AWS::SQS::Queue` | `Write` | `Id`ou `Arn` e `Type` | `Id`ou `Arn``QueueUrl`, e `Type` | 
| `AWS::SQS::Queue` | `AWS::Lambda::Function` | `Read`, `Write` | `Id`ou `Arn` e `Type` | `Id`ou `RoleName` e `Type` | 
| `AWS::SQS::Queue` | `AWS::Serverless::Function` | `Read`, `Write` | `Id`ou `Arn` e `Type` | `Id`ou `RoleName` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn``Name`, e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id`ou `RoleName` e `Type` | `Id`ou `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`ou `RoleName` e `Type` | `Id` ou `Arn`, `Name` e `Type` | 

## Políticas do IAM criadas por conectores
<a name="reference-sam-connector-policies"></a>

Esta seção documenta as políticas AWS Identity and Access Management (IAM) que são criadas AWS SAM ao usar conectores.

`AWS::DynamoDB::Table` para `AWS::Lambda::Function`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:DescribeStream",
        "dynamodb:GetRecords",
        "dynamodb:GetShardIterator",
        "dynamodb:ListStreams"
      ],
      "Resource": [
        "%{Source.Arn}/stream/*"
      ]
    }
  ]
}
```

`AWS::Events::Rule` para `AWS::SNS::Topic`  
**Tipo de política**  
[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topicpolicy.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topicpolicy.html) associado ao `AWS::SNS::Topic`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sns:Publish",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Events::Rule` para `AWS::Events::EventBus`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Events::Rule`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` para `AWS::StepFunctions::StateMachine`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Events::Rule`.   
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` para `AWS::Lambda::Function`  
**Tipo de política**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` associado ao `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "events.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::Events::Rule` para `AWS::SQS::Queue`  
**Tipo de política**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)` associado ao `AWS::SQS::Queue`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::Lambda::Function`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::S3::Bucket`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectAcl",
        "s3:GetObjectLegalHold",
        "s3:GetObjectRetention",
        "s3:GetObjectTorrent",
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAcl",
        "s3:GetObjectVersionForReplication",
        "s3:GetObjectVersionTorrent",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads",
        "s3:ListBucketVersions",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:DeleteObject",
        "s3:DeleteObjectVersion",
        "s3:PutObject",
        "s3:PutObjectLegalHold",
        "s3:PutObjectRetention",
        "s3:RestoreObject"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::DynamoDB::Table`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::SQS::Queue`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:ReceiveMessage",
        "sqs:GetQueueAttributes"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:DeleteMessage",
        "sqs:SendMessage",
        "sqs:ChangeMessageVisibility",
        "sqs:PurgeQueue"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::SNS::Topic`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::StepFunctions::StateMachine`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution",
        "states:StartSyncExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:StopExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    }
  ]
}
```
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeStateMachine",
        "states:ListExecutions"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeExecution",
        "states:DescribeStateMachineForExecution",
        "states:GetExecutionHistory"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::Events::EventBus`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` para `AWS::Location::PlaceIndex`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "geo:DescribePlaceIndex",
        "geo:GetPlace",
        "geo:SearchPlaceIndexForPosition",
        "geo:SearchPlaceIndexForSuggestions",
        "geo:SearchPlaceIndexForText"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::ApiGatewayV2::Api` para `AWS::Lambda::Function`  
**Tipo de política**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` associado ao `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "apigateway.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:execute-api:${AWS::Region}:${AWS::AccountId}:%{Source.ResourceId}/%{Source.Qualifier}"
}
```

`AWS::ApiGateway::RestApi` para `AWS::Lambda::Function`  
**Tipo de política**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` associado ao `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "apigateway.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:execute-api:${AWS::Region}:${AWS::AccountId}:%{Source.ResourceId}/%{Source.Qualifier}"
}
```

`AWS::SNS::Topic` para `AWS::SQS::Queue`  
**Tipo de política**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)` associado ao `AWS::SQS::Queue`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::SNS::Topic` para `AWS::Lambda::Function`  
**Tipo de política**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` associado ao `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "sns.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::SQS::Queue` para `AWS::Lambda::Function`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:DeleteMessage"
      ],
      "Resource": [
        "%{Source.Arn}"
      ]
    }
  ]
}
```
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:ReceiveMessage",
        "sqs:GetQueueAttributes"
      ],
      "Resource": [
        "%{Source.Arn}"
      ]
    }
  ]
}
```

`AWS::S3::Bucket` para `AWS::Lambda::Function`  
**Tipo de política**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` associado ao `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "s3.amazonaws.com",
  "SourceArn": "%{Source.Arn}",
  "SourceAccount": "${AWS::AccountId}"
}
```

`AWS::StepFunctions::StateMachine` para `AWS::Lambda::Function`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::StepFunctions::StateMachine`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` para `AWS::SNS::Topic`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::StepFunctions::StateMachine`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` para `AWS::SQS::Queue`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::StepFunctions::StateMachine`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:SendMessage"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` para `AWS::S3::Bucket`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::StepFunctions::StateMachine`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectAcl",
        "s3:GetObjectLegalHold",
        "s3:GetObjectRetention",
        "s3:GetObjectTorrent",
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAcl",
        "s3:GetObjectVersionForReplication",
        "s3:GetObjectVersionTorrent",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads",
        "s3:ListBucketVersions",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:DeleteObject",
        "s3:DeleteObjectVersion",
        "s3:PutObject",
        "s3:PutObjectLegalHold",
        "s3:PutObjectRetention",
        "s3:RestoreObject"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` para `AWS::DynamoDB::Table`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::StepFunctions::StateMachine`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` para `AWS::StepFunctions::StateMachine`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::StepFunctions::StateMachine`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:DescribeRule"
      ],
      "Resource": [
        "arn:${AWS::Partition}:events:${AWS::Region}:${AWS::AccountId}:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:StopExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:PutTargets",
        "events:PutRule"
      ],
      "Resource": [
        "arn:${AWS::Partition}:events:${AWS::Region}:${AWS::AccountId}:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` para `AWS::Events::EventBus`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::StepFunctions::StateMachine`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` para `AWS::DynamoDB::Table`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::AppSync::DataSource`.  
**Categorias de acesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` para `AWS::Lambda::Function`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::AppSync::DataSource`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}:*"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` para `AWS::Events::EventBus`  
**Tipo de política**  
[Política gerenciada pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) associada à função `AWS::AppSync::DataSource`.  
**Categorias de acesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::GraphQLApi` para `AWS::Lambda::Function`  
**Tipo de política**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` associado ao `AWS::Lambda::Function`.  
**Categorias de acesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "appsync.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:appsync:${AWS::Region}:${AWS::AccountId}:apis/%{Source.ResourceId}"
}
```

# Instalando o Docker para usar com o AWS SAMCLI
<a name="install-docker"></a>

O Docker é um aplicativo que executa contêineres em sua máquina. ComDocker, AWS SAM pode fornecer um ambiente local semelhante a AWS Lambda um contêiner para criar, testar e depurar seus aplicativos sem servidor.

**nota**  
O Docker é necessário somente para testar seus aplicativos localmente e para criar pacotes de implantação usando a opção `--use-container`.

**Topics**
+ [Instalação do Docker](#install-docker-instructions)
+ [Próximas etapas](#install-docker-next-steps)

## Instalação do Docker
<a name="install-docker-instructions"></a>

Siga essas instruções para instalar a Docker, siga as instruções para seu sistema operacional.

### Linux
<a name="install-docker-instructions-linux"></a>

O Docker está disponível em muitos sistemas operacionais diferentes, incluindo a maioria das distribuições modernas do Linux, como o CentOS, o Debian, e o Ubuntu. Para obter informações sobre a instalação Docker em seu sistema operacional específico, consulte [Obtenha o Docker](https://docs.docker.com/get-docker/) no site Docker Docs.

**Para instalar o Docker no Amazon Linux 2 ou Amazon Linux 2023**

1. Atualize os pacotes instalados e o cache de pacotes em sua instância.

   ```
   $ sudo yum update -y
   ```

1. Instale o pacote do Docker Community Edition mais recente.
   + No Amazon Linux 2, execute o seguinte:

     ```
     $ sudo amazon-linux-extras install docker
     ```
   + No Amazon Linux 2023, execute o seguinte:

     ```
     $ sudo yum install -y docker
     ```

1. Inicie o serviço Docker.

   ```
   $ sudo service docker start
   ```

1. Adicione o `ec2-user` ao grupo `docker`, para que você possa executar comandos Docker sem usar o **sudo**.

   ```
   $ sudo usermod -a -G docker ec2-user
   ```

1. Obtenha as novas permissões de grupo `docker` efetuando logout e login novamente. Para fazer isso, feche a janela do terminal SSH atual e reconecte-se à sua instância em uma nova. Sua nova sessão SSH deverá ter as permissões de grupo `docker` apropriadas.

1. Verifique se o `ec2-user` pode executar comandos do Docker sem usar o **sudo**.

   ```
   $ docker ps
   ```

   Você deverá ver a saída a seguir, confirmando que o Docker está instalado e em execução:

   ```
    CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
   ```

**nota**  
No Linux, para criar e executar funções do Lambda com uma arquitetura de conjunto de instruções diferente da sua máquina host, há etapas adicionais para configurar o Docker. Por exemplo, para executar funções `arm64` em uma máquina `x86_64`, você pode executar o seguinte comando para configurar o Docker daemon: `docker run --rm --privileged multiarch/qemu-user-static --reset -p yes`.

Se você tiver problemas ao instalar o Docker, consulte [Solução de problemas de erros de instalação do](install-sam-cli.md#sam-cli-troubleshoot-install). Ou consulte a seção [Solução](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting) de problemas das **etapas de pós-instalação para Linux** no site do Docker Docs.

### macOS
<a name="install-docker-instructions-macos"></a>

**nota**  
Docker O desktop é oficialmente suportado, mas a partir da versão 1.47.0 do AWS SAMCLI, você pode usar alternativas, desde que elas usem o tempo de execução do Docker.

1. Instalar o Docker

   O AWS SAMCLI tem suporte para a execução do Docker no macOS Sierra 10.12 ou posterior. Para saber como instalar o Docker, consulte [Instalar o Docker Desktop para Mac](https://docs.docker.com/docker-for-mac/install/) no site do Docs Docker.

1. Como configurar seus drives compartilhados

   Isso AWS SAMCLI exige que o diretório do projeto, ou qualquer diretório principal, esteja listado em um drive compartilhado. Isso pode exigir o compartilhamento de arquivos. Para obter mais informações, consulte o tópico de solução de problemas [de montagem de volumes requer compartilhamento de arquivos](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home) na documentação*Docker.*

1. Verificar a instalação

   Depois que o Docker estiver instalado, verifique se está funcionando. Confirme também se você pode executar comandos Docker na linha de comando (por exemplo, `docker ps`). Você não precisa instalar, buscar ou retirar nenhum contêiner. O AWS SAMCLI faz isso automaticamente conforme necessário.

Se você tiver problemas na instalação do Docker, para obter mais dicas de solução de problemas, consulte a seção [Solução de problemas e diagnóstico](https://docs.docker.com/docker-for-mac/troubleshoot/) do site do Docs Docker.

### Windows
<a name="install-docker-instructions-windows"></a>

**nota**  
AWS SAM suporta oficialmente o Docker Desktop. No entanto, a partir da versão 1.47.0 do AWS SAMCLI, você pode usar alternativas, desde que elas usem o tempo de execução do Docker.

1. Instalar o Docker.

   O Docker desktop é compatível com o sistema operacional Windows mais recente. Para versões antigas do Windows, a caixa de ferramentas Docker está disponível. Escolha sua versão do Windows para as etapas corretas de instalação do Docker:
   + Para instalar o Docker no Windows 10, consulte [Instalar o Docker Desktop para Windows](https://docs.docker.com/docker-for-windows/install/) no site do Docker Documentos.
   + DockerPara instalar em versões anteriores do Windows, consulte [A caixa de Docker ferramentas no repositório da Docker caixa](https://github.com/docker-archive/toolbox) de ferramentas GitHub .

1. Como configurar seus drives compartilhados.

   Isso AWS SAMCLI exige que o diretório do projeto, ou qualquer diretório principal, esteja listado em um drive compartilhado. Em alguns casos, você deve compartilhar sua unidade para o Docker funcionar corretamente.

1. Verifique a instalação.

   Depois que o Docker estiver instalado, verifique se está funcionando. Confirme também se você pode executar comandos Docker na linha de comando (por exemplo, **docker ps**). Você não precisa instalar, buscar ou retirar nenhum contêiner. O AWS SAMCLI faz isso automaticamente conforme necessário.

Se você tiver problemas na instalação do Docker, para obter mais dicas de solução de problemas, consulte a seção [Solução de problemas e diagnóstico](https://docs.docker.com/docker-for-mac/troubleshoot/) do site do Docs Docker.

## Próximas etapas
<a name="install-docker-next-steps"></a>

Para saber como instalar o AWS SAMCLI, consulte[Instale o AWS SAM CLI](install-sam-cli.md).

# Instalando Finch para usar com a AWS SAM CLI
<a name="install-finch"></a>

Finch AWSé a ferramenta de desenvolvimento de contêineres que fornece uma alternativaDocker, particularmente benéfica em sistemas macOS e Linux. Para obter mais informações, consulte [Finch on. GitHub](https://github.com/runfinch) ComFinch, AWS SAM pode fornecer um ambiente local semelhante a AWS Lambda um contêiner para criar, testar e depurar seus aplicativos sem servidor.

**nota**  
Você precisa do Finch para testar suas aplicações localmente, para criar pacotes de implantação usando a opção `--use-container` e para criar funções de imagem OCI. A partir da versão 1.145.0 da AWS SAM CLI, a AWS SAM CLI Finch oferece suporte como um tempo de execução de contêiner alternativo ao. Docker

**Topics**
+ [Instalação do Finch](#install-finch-instructions)
+ [Configurando Finch com CLI AWS SAM](#install-finch-configuration)
+ [Verificar a instalação](#install-finch-verification)
+ [Interrupção do Finch](#install-finch-stopping)
+ [Solução de problemas](#install-finch-troubleshooting)
+ [Próximas etapas](#install-finch-next-steps)

## Instalação do Finch
<a name="install-finch-instructions"></a>

Siga essas instruções para instalar a Finch, siga as instruções para seu sistema operacional.

### Pré-requisitos
<a name="install-finch-prerequisites"></a>

**nota**  
Fincha integração na AWS SAM CLI está disponível nos sistemas macOS e Linux. Para usuários do Windows, considere usar uma máquina virtual ou um ambiente Linux para obter a funcionalidade Finch.

**Versões do macOS:**
+ macOS 15 Sequoia
+ macOS 14 Sonoma

**nota**  
O Finch oferece suporte para as duas versões mais recentes do macOS.

**Linux**
+ Linux Kernel v4.x\$1

### Instalar o Finch
<a name="install-finch"></a>

#### macOS
<a name="install-finch-instructions-macos"></a>

**Para instalar o Finch no MacOS**

1. Instale o Finch usando a CLI do `brew`. Se solicitado, digite sua senha do macOS.

   ```
   $ brew install finch
   ```

1. Verifique a versão instalada do Finch.

   ```
   $ finch --version
   ```

1. Inicialize a máquina virtual do Finch (primeira configuração).

   ```
   $ finch vm init
   ```

1. Inicie a máquina virtual do Finch.

   ```
   $ finch vm start
   ```

1. Verifique o status da máquina virtual do Finch.

   ```
   $ finch vm status
   ```

1. Verifique se o Finch está funcionando corretamente.

   ```
   $ finch --info
   $ finch ps
   ```

Para obter mais informações, consulte [Installing Finch on macOS](https://runfinch.com/docs/managing-finch/macos/installation/).

#### Linux
<a name="install-finch-instructions-linux"></a>

Você pode instalar o Finch no Amazon Linux, Ubuntu ou usando um método de instalação genérico. Para obter mais informações, consulte [Installing Finch on Linux](https://runfinch.com/docs/managing-finch/linux/installation/).

## Configurando Finch com CLI AWS SAM
<a name="install-finch-configuration"></a>

Depois da instalaçãoFinch, a AWS SAM CLI detecta e usa automaticamente Finch como tempo de execução do contêiner quando Docker não é executada.

**nota**  
O Finch atua como um substituto para o Docker. Se você tiver ambos Finch instalados Docker e em execução, a AWS SAM CLI Docker prioriza por padrão.

### Configuração de preferência do administrador (macOS)
<a name="install-finch-configuration-preference"></a>

Você pode configurar a AWS SAM CLI para usar um tempo de execução de contêiner específico como padrão criando um arquivo de preferências do administrador. Essa preferência de todo o sistema substitui o comportamento de fallback padrão.

**Opções de configuração disponíveis**
+ **Defina o Finch como runtime do contêiner preferencial:**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string finch" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **Defina o Docker como runtime do contêiner preferencial:**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string docker" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **Remover preferência (retornar ao comportamento padrão):**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Remove :DefaultContainerRuntime" /Library/Preferences/com.amazon.samcli.plist
  ```

**nota**  
Quando nenhuma preferência do administrador é definida, a AWS SAM CLI usa Docker por padrão quando disponível, Finch como alternativa quando não Docker está em execução.

### Diferenças de montagem de diretórios (macOS)
<a name="install-finch-differences"></a>

No macOS, os comandos AWS SAM locais falharão se você localizar seu projeto fora do diretório inicial (`~`) ou. `/Volumes` Esse design restringe a montagem automática de diretórios por motivos de segurança sem o seu conhecimento.

**Opções de mitigação**
+ **Opção 1:** abra a configuração do Finch em um editor de texto `~/.finch/finch.yaml`, adicione o caminho do projeto na seção `additional_directories` e reinicie a máquina virtual do Finch. Para obter informações adicionais, consulte [Finch documentation](https://runfinch.com/docs/managing-finch/macos/disk-management/#adding-additional-disk-mounts).

  ```
  $ finch vm stop
  $ finch vm start
  ```
+ **Opção 2:** mova seu projeto para o diretório inicial.

## Verificar a instalação
<a name="install-finch-verification"></a>

Depois de instalar e iniciarFinch, verifique se ele funciona com a AWS SAM CLI.

### Verificação bancária
<a name="install-finch-verification-basic"></a>

Execute o comando a seguir para verificar se a AWS SAM CLI pode usar: Finch

```
$ sam build --use-container
```

Você deve ver a AWS SAM CLI sendo usada Finch para criar seu aplicativo em um ambiente de contêiner.

**nota**  
O Finch atua como um substituto para o Docker. Se Docker estiver em execução, a AWS SAM CLI Docker priorizará por padrão.

### Testar o Finch como alternativa
<a name="install-finch-verification-fallback"></a>

Para testar o Finch como alternativa quando o Docker estiver em execução, você precisa interromper o Docker primeiro.

**Para testar a funcionalidade de alternativa do Finch**

1. Interrompa o Docker usando os comandos apropriados para o seu sistema operacional.

   **macOS:**

   ```
   $ docker stop $(docker ps -q)
   $ pkill -f "Docker Desktop"
   ```

   A verificação do Docker foi interrompida.

   ```
   $ docker ps
   ```

   **Linux**

   ```
   $ docker stop $(docker ps -q)
   $ sudo systemctl stop docker
   ```

   A verificação do Docker foi interrompida.

   ```
   $ sudo systemctl status docker
   ```

1. Execute o `sam build --use-container` comando para verificar se a AWS SAM CLI é usada automaticamente Finch como alternativa.

## Interrupção do Finch
<a name="install-finch-stopping"></a>

Se você precisar interromper o Finch, use os comandos a seguir:

**macOS:**

```
$ finch vm stop
$ sudo pkill -f finch
```

A verificação do Finch foi interrompida.

```
$ finch vm status
```

**Linux**

```
$ sudo systemctl stop finch
$ sudo pkill -f finch
```

A verificação do Finch foi interrompida.

```
$ sudo systemctl status finch
```

## Solução de problemas
<a name="install-finch-troubleshooting"></a>

Se você encontrar problemas com o Finch:
+ Verifique se o sistema operacional atende aos pré-requisitos.
+ Verifique se você habilitou a virtualização no seu sistema.
+ Para macOS, verifique se você tem espaço em disco suficiente para a máquina virtual.
+ Para Linux, verifique se você tem as permissões adequadas para executar os comandos `systemctl`.
+ Se você encontrar falhas de CloudFormation implantação com erros de “tipo de mídia não suportado” ao enviar imagens de várias arquiteturas para o Amazon Elastic Container Registry (Amazon ECR), crie um único artefato de imagem em vez de usar imagens de várias arquiteturas. Isso ocorre porque o Finch envia o índice e a imagem da imagem para o Amazon ECR, enquanto o Docker envia somente a imagem.
+ Se a construção multiplataforma falhar quando a arquitetura da função de destino não corresponder à arquitetura da máquina host no Linux, habilite a emulação multiplataforma executando `sudo finch run --privileged --rm tonistiigi/binfmt:master --install all`.

Para solução de problemas adicionais, consulte [Finch documentation](https://runfinch.com/docs/) ou o [AWS SAM CLI solução de problemas](sam-cli-troubleshooting.md).

## Próximas etapas
<a name="install-finch-next-steps"></a>

Agora que você Finch instalou, você pode usá-lo com a AWS SAM CLI para:
+ Crie aplicações com tecnologia sem servidor usando contêineres com `sam build --use-container`. Para obter mais informações, consulte [sam build](sam-cli-command-reference-sam-build.md).
+ Teste as funções do Lambda localmente com `sam local invoke`. Para obter mais informações, consulte [sam local invoke](sam-cli-command-reference-sam-local-invoke.md).
+ Inicie um API Gateway local com `sam local start-api`. Para obter mais informações, consulte [sam local start-api](sam-cli-command-reference-sam-local-start-api.md).
+ Inicie um endpoint do Lambda local com `sam local start-lambda`. Para obter mais informações, consulte [sam local start-lambda](sam-cli-command-reference-sam-local-start-lambda.md).

Para obter mais informações sobre o uso da AWS SAM CLI com contêineres, consulte. [Compilação padrão com AWS SAM](serverless-sam-cli-using-build.md)

# Repositórios de imagens para AWS SAM
<a name="serverless-image-repositories"></a>

AWS SAM simplifica as tarefas de integração contínua e entrega contínua (CI/CD) para aplicativos sem servidor com a ajuda da criação de imagens de contêiner. As imagens AWS SAM fornecidas incluem a interface de linha de AWS SAM comando (CLI) e ferramentas de construção para vários tempos de execução compatíveis AWS Lambda . Isso facilita a criação e o empacotamento de aplicativos sem servidor usando o AWS SAM CLI. Você pode usar essas imagens com CI/CD sistemas para automatizar a criação e a implantação de AWS SAM aplicativos. Para obter exemplos, consulte [Implemente com CI/CD sistemas e pipelines](deploying-options.md#serverless-deploying-ci-cd).

AWS SAM URIs as imagens do contêiner de construção são marcadas com a versão AWS SAMCLI incluída nessa imagem. Se for especificada a URI não marcada, a versão mais recente será usada. Por exemplo, `public.ecr.aws/sam/build-nodejs20.x` usa a imagem mais recente. No entanto, `public.ecr.aws/sam/build-nodejs20.x:1.24.1` usa a imagem que contém a versão 1.24.1 da AWS SAM CLI.

A partir da versão 1.33.0 do AWS SAMCLI, tanto as imagens `x86_64` quanto as de `arm64` contêiner estão disponíveis para tempos de execução compatíveis. Para obter mais informações, consulte [Cotas do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) no *AWS Lambda Guia do desenvolvedor do e*.

**nota**  
Antes da versão 1.22.0 do AWS SAMCLI, DockerHub era o repositório padrão do qual AWS SAMCLI extraía a imagem do contêiner. A partir da versão 1.22.0, o repositório padrão mudou para Amazon Elastic Container Registry Public (Amazon ECR Public). Para extrair uma imagem de contêiner de um repositório diferente do padrão atual, você pode usar o comando **[sam build](sam-cli-command-reference-sam-build.md)** com a opção **--build-image**. Os exemplos no final deste tópico mostram como criar aplicativos usando imagens de DockerHub repositório.

## Repositório de imagens URIs
<a name="serverless-image-repository-uris"></a>

A tabela a seguir lista as imagens URIs de contêiner de compilação [pública do Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html) que você pode usar para criar e empacotar aplicativos sem servidor. AWS SAM

**nota**  
O Amazon ECR Public foi substituído DockerHub a partir da versão 1.22.0 AWS SAMCLI. Se você estiver usando uma versão anterior do AWS SAMCLI, recomendamos que você atualize.


| Runtime |  Amazon ECR Public | 
| --- | --- | 
| Tempo de execução personalizado (AL2023) | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-provided.al2023)- fornecido em 2023 | 
| Tempo de execução personalizado (AL2) | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-provided.al2)-fornecido.al2 | 
| Runtime personalizado | [public.ecr. aws/sam/build-fornecido](https://gallery.ecr.aws/sam/build-provided) | 
| Java 25 | [public.ecr. aws/sam/build-java 25](https://gallery.ecr.aws/sam/build-java25) | 
| Java 21 | [public.ecr. aws/sam/build-java 21](https://gallery.ecr.aws/sam/build-java21) | 
| Java 17 | [public.ecr. aws/sam/build-java 17](https://gallery.ecr.aws/sam/build-java17) | 
| Java 11 | [public.ecr. aws/sam/build-java 11](https://gallery.ecr.aws/sam/build-java11) | 
| Java 8 | [public.ecr. aws/sam/build-java 8](https://gallery.ecr.aws/sam/build-java8) | 
| .NET 9 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet9)-dotnet 9 | 
| .NET 8 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet8)-dotnet 8 | 
| .NET 7 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet7)-dotnet 7 | 
| .NET 6 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet6)-dotnet 6 | 
| Node.js 24 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs24.x)-nodejs24.x | 
| Node.js 22 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs22.x)-nodejs22.x | 
| Node.js 20 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs20.x)-nodejs 20.x | 
| Node.js 18 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs18.x)-nodejs 18.x | 
| Node.js 16 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs16.x)-nodejs 16.x | 
| Python 3.14 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.14)-python 3.14 | 
| Python 3.13 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.13)-python 3.13 | 
| Python 3.12 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.12)-python 3.12 | 
| Python 3.11 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.11)-python 3.11 | 
| Python 3.10 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.10)-python 3.10 | 
| Python 3.9 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.9)-python 3.9 | 
| Python 3.8 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.8)-python 3.8 | 
| Ruby 3.4 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-ruby3.4)- rubi 3.4 | 
| Ruby 3.3 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-ruby3.3)- rubi 3.3 | 
| Ruby 3.2 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-ruby3.2)-rubi 3.2 | 

## Exemplos
<a name="serverless-image-repository-example-commands"></a>

Os dois exemplos de comandos a seguir criam aplicações usando imagens de contêiner do repositório de imagens:

**Crie uma aplicação Node.js 24 usando uma imagem de contêiner extraída do Amazon ECR**:

```
$ sam build --use-container --build-image public.ecr.aws/sam/build-nodejs24.x
```

**Crie um recurso de função usando a imagem do contêiner Python 3.14 extraída do Amazon ECR**:

```
$ sam build --use-container --build-image Function1=public.ecr.aws/sam/build-python3.14
```

# Implantando aplicativos sem servidor gradualmente com AWS SAM
<a name="automating-updates-to-serverless-apps"></a>

AWS Serverless Application Model (AWS SAM) vem embutido [CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/welcome.html)para fornecer AWS Lambda implantações graduais. Com apenas algumas linhas de configuração, AWS SAM faz o seguinte para você:
+ Implanta novas versões da sua função do Lambda e cria automaticamente aliases que apontam para a nova versão.
+ Mude gradualmente o tráfego do cliente para a nova versão até que você esteja satisfeito com o funcionamento esperado. Se uma atualização não funcionar corretamente, você poderá reverter as alterações.
+ Define funções de teste pré-tráfego e pós-tráfego para verificar se o código recém-implantado está configurado corretamente e se seu aplicativo opera conforme o esperado.
+ Reverte automaticamente a implantação se CloudWatch os alarmes forem acionados.

**nota**  
Se você habilitar implantações graduais por meio do seu AWS SAM modelo, um CodeDeploy recurso será criado automaticamente para você. Você pode visualizar o CodeDeploy recurso diretamente por meio do Console de gerenciamento da AWS.

**Exemplo**

O exemplo a seguir demonstra o uso da função Lambda CodeDeploy para transferir gradualmente os clientes para sua versão recém-implantada da função Lambda:

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live

    DeploymentPreference:
      Type: Canary10Percent10Minutes 
      Alarms:
        # A list of alarms that you want to monitor
        - !Ref AliasErrorMetricGreaterThanZeroAlarm
        - !Ref LatestVersionErrorMetricGreaterThanZeroAlarm
      Hooks:
        # Validation Lambda functions that are run before & after traffic shifting
        PreTraffic: !Ref PreTrafficLambdaFunction
        PostTraffic: !Ref PostTrafficLambdaFunction
```

Essas revisões do AWS SAM modelo fazem o seguinte:
+ `AutoPublishAlias`: Ao adicionar essa propriedade e especificar um nome de alias,: AWS SAM
  + Detecta quando um novo código está sendo implantado, com base em alterações no URI do Amazon S3 da função do Lambda.
  + Cria e publica uma versão atualizada dessa função com o código mais recente.
  + Cria um alias com um nome fornecido por você (a menos que já exista um alias) e aponta para a versão atualizada da função do Lambda. As invocações de função devem usar o qualificador de alias para aproveitar isso. Se você não estiver familiarizado com o controle de versão e os aliases da função do Lambda, consulte [AWS Lambda Controle de versão e aliases de funções](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html).
+ `Deployment Preference Type`: No exemplo anterior, 10% do seu tráfego de clientes é imediatamente transferido para sua nova versão. Após 10 minutos, todo o tráfego é transferido para a nova versão. No entanto, se seus testes de pré-tráfego ou pós-tráfego falharem, ou se um CloudWatch alarme for acionado, CodeDeploy reverte sua implantação. É possível especificar como o tráfego deve ser transferido entre versões das seguintes maneiras:
  + `Canary`: o tráfego é deslocado em dois incrementos. É possível escolher entre opções de canário predefinidas. As opções especificam a porcentagem de tráfego que é transferida para a versão atualizada da função do Lambda no primeiro incremento e o intervalo, em minutos, antes que o tráfego restante seja transferido no segundo incremento. 
  + `Linear`: o tráfego é deslocado em incrementos iguais com um número igual de minutos entre cada incremento. Você pode escolher entre opções lineares predefinidas que especificam a porcentagem de tráfego deslocado em cada incremento e o número de minutos entre cada incremento. 
  + `AllAtOnce`: todo o tráfego é deslocado da função do Lambda original para a versão da função do Lambda atualizada de uma única vez. 

  A tabela a seguir descreve outras opções de mudança de tráfego que estão disponíveis além da usada no exemplo.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/automating-updates-to-serverless-apps.html)
+ `Alarms`: são CloudWatch alarmes acionados por quaisquer erros gerados pela implantação. Quando encontrados, eles revertem automaticamente sua implantação. Por exemplo, se o código atualizado que você está implantando causar erros no aplicativo. Outro exemplo é se alguma CloudWatch métrica personalizada especificada por você [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-functions-metrics.html)violou o limite de alarme.
+ `Hooks`: são funções de teste pré e pós-tráfego que executam verificações antes do início da mudança de tráfego para a nova versão e após a conclusão da mudança de tráfego.
  + `PreTraffic`: Antes do início da mudança de tráfego, CodeDeploy invoca a função Lambda do gancho de pré-tráfego. Essa função Lambda deve retornar CodeDeploy e indicar sucesso ou falha. Se a função falhar, ela aborta e reporta uma falha para o. CloudFormation Se a função for bem-sucedida, CodeDeploy prossiga com a mudança de tráfego.
  + `PostTraffic`: após a conclusão da mudança de tráfego, CodeDeploy invoca a função Lambda do gancho pós-tráfego. Isso é semelhante ao gancho pré-tráfego, em que a função deve retornar para CodeDeploy relatar um sucesso ou uma falha. Use ganchos de pós-tráfego para executar testes de integração ou outras ações de validação.

  Para obter mais informações, consulte [Referência do SAM para implantações seguras](https://github.com/aws/serverless-application-model/blob/master/docs/safe_lambda_deployments.rst). 

## Implantação gradual de uma função do Lambda pela primeira vez
<a name="automating-updates-to-serverless-apps-first-time"></a>

 Ao implantar uma função Lambda gradualmente CodeDeploy , é necessária uma versão de função implantada anteriormente para transferir o tráfego. Portanto, sua primeira implantação deve ser realizada em duas etapas: 
+ **Etapa 1**: implante sua função do Lambda e crie aliases automaticamente com o `AutoPublishAlias`.
+ **Etapa 2**: Execute sua implantação gradual com o `DeploymentPreference`.

Executar sua primeira implantação gradual em duas etapas fornece CodeDeploy uma versão anterior da função Lambda da qual transferir o tráfego.

### Etapa 1: Implantação da função do Lambda
<a name="automating-updates-to-serverless-apps-first-time-step1"></a>

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live
```

### Etapa 2: Execute sua implantação gradual
<a name="automating-updates-to-serverless-apps-first-time-step2"></a>

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live

    DeploymentPreference:
      Type: Canary10Percent10Minutes 
      Alarms:
        # A list of alarms that you want to monitor
        - !Ref AliasErrorMetricGreaterThanZeroAlarm
        - !Ref LatestVersionErrorMetricGreaterThanZeroAlarm
      Hooks:
        # Validation Lambda functions that are run before and after traffic shifting
        PreTraffic: !Ref PreTrafficLambdaFunction
        PostTraffic: !Ref PostTrafficLambdaFunction
```

## Saiba mais
<a name="automating-updates-to-serverless-apps-learn"></a>

Para ver um exemplo prático de configuração de uma implantação gradual, consulte o [Módulo 5 - Implantações canário](https://s12d.com/sam-ws-en-canaries) no *The Complete AWS SAM Workshop*.

# Notas de referência importantes para AWS SAM
<a name="important-notes"></a>

Esta seção contém notas e anúncios importantes para AWS Serverless Application Model ()AWS SAM.

**Topics**
+ [Observações importantes para 2023](#important-notes-2023)

## Observações importantes para 2023
<a name="important-notes-2023"></a>

### Outubro de 2023
<a name="important-notes-2023-10"></a>

#### AWS SAMCLI descontinuando o suporte para Python 3.7
<a name="important-notes-2023-10-python"></a>

*Publicado em 20/10/2023*

Python 3.7recebeu end-of-life o status em junho de 2023. O suporte AWS SAM CLI será interrompido Python 3.7 em 24 de outubro de 2023. Para obter mais informações, consulte o [anúncio](https://github.com/aws/aws-sam-cli/issues/5889) no *aws-sam-cli GitHubrepositório.*

Essa alteração afeta os seguintes usuários:
+ Se você usar Python 3.7 e instalar o AWS SAM CLI Through`pip`.
+ Se você usa `aws-sam-cli` como uma biblioteca e cria seu aplicativo com Python 3.7.

Se você instalar e gerenciar o AWS SAM CLI por meio de outro método, você não será afetado.

Para usuários afetados, recomendamos que você atualize seu ambiente de desenvolvimento para Python 3.8 ou mais recente.

Essa alteração não afeta o suporte ao ambiente Python 3.7 AWS Lambda de tempo de execução. Para obter mais informações, consulte [Política de descontinuação de runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy) no *Guia do desenvolvedor do AWS Lambda *.