sam local invoke - AWS Serverless Application Model

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

sam local invoke

Esta página fornece informações de referência para a interface de linha de AWS Serverless Application Model comando (AWS SAM CLI) sam local invoke subcomando.

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

Uso

$ 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

ID do recurso

O ID da função do Lambda a ser invocada.

Esse argumento é opcional. Se seu aplicativo contiver uma única função Lambda, ela AWS SAM CLI será invocada. 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 ou o recurso do recursoARN.

Opções

--add-host LIST

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.

Exemplo: --add-host example.com:127.0.0.1

--beta-features | --no-beta-features

Permita ou negue recursos beta.

--config-env TEXT

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 AWS SAM CLI Arquivo de configuração do  .

--config-file PATH

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 AWS SAM CLI Arquivo de configuração do  .

--container-env-vars

(Opcional) Passe variáveis de ambiente para o contêiner de imagem da função do Lambda ao depurar localmente.

--container-host TEXT

Host do contêiner Lambda emulado localmente. O valor padrão é localhost. Se você quiser correr AWS SAM CLI em um contêiner Docker no macOS, você pode especificar. host.docker.internal Se você quiser executar o contêiner em um host diferente do AWS SAM CLI, você pode especificar o endereço IP do host remoto.

--container-host-interface TEXT

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

Ativa o registro de depuração para imprimir mensagens de depuração que o AWS SAM CLI gera e para exibir carimbos de data/hora.

--debug-args TEXT

Argumentos adicionais a serem transmitidos para o depurador.

--debug-port, -d TEXT

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

O caminho do host para um depurador montado no contêiner Lambda.

--docker-network TEXT

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

O JSON arquivo que contém valores para as variáveis de ambiente da função Lambda. Para obter mais informações sobre variáveis de ambiente, consulte Arquivo de variável de ambiente.

--event, -e PATH

O JSON arquivo que contém dados de eventos que são passados para a função Lambda quando ela é invocada. Se você não especificar essa opção, nenhum evento será assumido. Para inserir JSONstdin, 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 no Guia do AWS Lambda desenvolvedor.

--force-image-build

Especifica se o AWS SAM CLI deve reconstruir a imagem usada para invocar funções Lambda com camadas.

--help

Mostra esta mensagem e sai.

--hook-name TEXT

O nome do gancho usado para estender AWS SAM CLI funcionalidade.

Valores aceitos: terraform.

--invoke-image TEXT

A imagem URI 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 (que está listado emRepositórios de imagens para o AWS SAM). 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

Especifica a localização do diretório base onde as camadas que seu modelo usa são baixadas.

--log-file, -l TEXT

O arquivo de log para o qual enviar os registros de tempo de execução.

--no-event

Invoca a função com um evento vazio.

--parameter-overrides

Uma string que contém substituições de AWS CloudFormation parâmetros codificadas como pares de valores-chave. Use o mesmo formato do AWS Command Line Interface (AWS CLI). O AWS SAM CLI formato é uma palavra-chave explícita de chave e valor, 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

O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

--region TEXT

A AWS região para a qual implantar. Por exemplo, us-east-1.

--save-params

Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

--shutdown

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

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

Por padrão, o AWS SAM CLI verifica o ambiente de tempo de execução remoto mais recente do Lambda e atualiza sua imagem local automaticamente para se manter sincronizada.

Especifique essa opção para ignorar a versão mais recente Docker imagem para seu ambiente de execução Lambda.

--template, -t PATH

O arquivo AWS SAM de modelo.

Essa opção não é compatível com o --hook-name.

nota

Se você especificar essa opção, AWS SAM carrega somente o modelo e os recursos locais para os quais ele aponta.

--terraform-plan-file

O caminho relativo ou absoluto até seu local Terraform arquivo de plano ao usar o AWS SAM CLI with Terraform Cloud. Essa opção exige que --hook-name seja definida comoterraform.

Exemplo

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