Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
sam local invoke
Esta página proporciona información de referencia para la interfaz de línea de AWS Serverless Application Model comandos (AWS SAM CLI) sam local invoke
subcomando.
-
Para una introducción al AWS SAM CLI, consulte ¿Qué es la AWS SAM CLI?
-
Para obtener documentación sobre el uso de AWS SAM CLI
sam local invoke
subcomando, consulteIntroducción a las pruebas con sam local invoke.
El sam local invoke
subcomando inicia una invocación única de una función de forma local. AWS Lambda
Uso
$
sam local invoke
<arguments>
<options>
nota
Si tiene más de una función definida en la AWS SAM plantilla, proporcione el identificador lógico de la función que desee invocar.
Argumentos
- ID de recurso
-
El ID de la función de Lambda que se invocará.
Este argumento es opcional. Si su aplicación contiene una sola función Lambda, la AWS SAM CLI invocará. Si la aplicación contiene varias funciones, proporciones el ID de la función que se va a invocar.
Valores válidos: el ID lógico o el recurso del recurso. ARN
Opciones
--add-host
LIST
-
Pasa un mapeo de nombre de host a dirección IP al archivo de host del contenedor Docker. Este parámetro se puede expresar varias veces.
Ejemplo:
--add-host
example.com:127.0.0.1
--beta-features | --no-beta-features
-
Permitir o denegar las características beta.
--config-env
TEXT
-
El nombre del entorno que especifica los valores de los parámetros predeterminados del archivo de configuración que se va a utilizar. El valor por defecto es «predeterminado». Para obtener más información sobre los archivos de configuración, consulta AWS SAM CLI Archivo de configuración de la de .
--config-file
PATH
-
La ruta y el nombre del archivo de configuración que contiene los valores de parámetros predeterminados que se van a utilizar. El valor por defecto es «
samconfig.toml
» en la raíz del directorio del proyecto. Para obtener más información sobre los archivos de configuración, consulta AWS SAM CLI Archivo de configuración de la de . --container-env-vars
-
(Opcional) Pase las variables de entorno al contenedor de imágenes de la función de Lambda al depurar localmente.
--container-host
TEXT
-
Host del contenedor Lambda emulado localmente. El valor predeterminado es
localhost
. Si quiere ejecutar AWS SAM CLI en un contenedor de Docker en macOS, puedehost.docker.internal
especificarlo. Si desea ejecutar el contenedor en un host diferente al AWS SAM CLI, puede especificar la dirección IP del host remoto. --container-host-interface
TEXT
-
La dirección IP de la interfaz de red del host a la que deben enlazarse los puertos del contenedor. El valor predeterminado es
127.0.0.1
. Utiliza0.0.0.0
para enlazarse a todas las interfaces. --debug
-
Activa el registro de depuración para imprimir los mensajes de depuración que AWS SAM CLI genera y muestra las marcas de tiempo.
--debug-args
TEXT
-
Argumentos opcionales que se pasan al depurador.
--debug-port, -d
TEXT
-
Cuando se especifica, inicia el contenedor de funciones de Lambda en modo de depuración y expone este puerto en el host local.
--debugger-path
TEXT
-
La ruta del host a un depurador montado en el contenedor de Lambda.
--docker-network
TEXT
-
El nombre o el ID de una red de Docker existente a la que deben conectarse los contenedores de Lambda y Docker, junto con la red en modo puente predeterminada. Si esto no se especifica, los contenedores de Lambda se conectan únicamente a la red Docker en modo puente predeterminada.
--docker-volume-basedir, -v
TEXT
-
La ubicación del directorio base en el que se encuentra el AWS SAM archivo. Si Docker se ejecuta en una máquina remota, debe montar la ruta en la que se encuentra el AWS SAM archivo en la máquina Docker y modificar este valor para que coincida con la máquina remota.
--env-vars, -n
PATH
-
El JSON archivo que contiene los valores de las variables de entorno de la función Lambda. Para obtener más información sobre los archivos de variable de entorno, consulta Archivo de variables de entorno.
--event, -e
PATH
-
El JSON archivo que contiene los datos de eventos que se pasan a la función Lambda cuando se invoca. Si no especifica esta opción, no se asume ningún evento. Para introducir datos JSON desde
stdin
, debe introducir el valor «-». Para obtener más información sobre los formatos de los mensajes de eventos de AWS los distintos servicios, consulte Trabajar con otros servicios en la Guía AWS Lambda para desarrolladores. --force-image-build
-
Especifica si el AWS SAM CLI debería reconstruir la imagen utilizada para invocar funciones Lambda con capas.
--help
-
Muestra este mensaje y sale.
--hook-name TEXT
-
El nombre del gancho que se usa para extender AWS SAM CLI funcionalidad.
Valores aceptados:
terraform
. --invoke-image
TEXT
-
La imagen URI del contenedor que desea usar para la invocación de la función local. De forma predeterminada, AWS SAM extrae la imagen del contenedor de Amazon ECR Public (que aparece enRepositorios de imágenes para AWS SAM). Utiliza esta opción para extraer la imagen desde otra ubicación.
Por ejemplo,
sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8
. --layer-cache-basedir
DIRECTORY
-
Especifica la ubicación del directorio base en el que se descargan las capas que utiliza la plantilla.
--log-file, -l
TEXT
-
El archivo de registro al que se van a enviar los registros de tiempo de ejecución.
--no-event
-
Invoca la función con un evento vacío.
--parameter-overrides
-
Una cadena que contiene anulaciones de AWS CloudFormation parámetros codificadas como pares clave-valor. Usa el mismo formato que (). AWS Command Line Interface AWS CLI El AWS SAM CLI El formato son palabras clave y valores explícitas, cada modificación está separada por un espacio. A continuación, se incluyen dos ejemplos:
--parameter-overrides ParameterKey=hello,ParameterValue=world
--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana
--profile
TEXT
-
El perfil específico del archivo de credenciales que recibe AWS las credenciales.
--region
TEXT
-
La AWS región en la que se va a realizar el despliegue. Por ejemplo, us-east-1.
--save-params
-
Guarde los parámetros que proporcione en la línea de comandos en el archivo AWS SAM de configuración.
--shutdown
-
Emula un evento de apagado una vez finalizada la invocación, para probar la forma en que la extensión gestiona el comportamiento del apagado.
--skip-prepare-infra
-
Omite la fase de preparación si no se ha realizado ningún cambio en la infraestructura. Ejecuta con la opción
--hook-name
. --skip-pull-image
-
De forma predeterminada, el AWS SAM CLI comprueba el entorno de ejecución remoto más reciente de Lambda y actualiza la imagen local automáticamente para mantenerla sincronizada.
Especifique esta opción para omitir la búsqueda de la versión más reciente Docker imagen para su entorno de ejecución Lambda.
--template, -t
PATH
-
El archivo AWS SAM de plantilla.
Esta opción no es compatible con
--hook-name
.nota
Si especifica esta opción, AWS SAM carga únicamente la plantilla y los recursos locales a los que apunta.
--terraform-plan-file
-
La ruta relativa o absoluta a su ubicación local Terraform archivo de plan cuando se utiliza el AWS SAM CLI with Terraform Cloud. Esta opción requiere que
--hook-name
esté configurada enterraform
.
Ejemplo
En el siguiente ejemplo, se utiliza un evento generado para realizar pruebas locales mediante un s3.json
evento para invocar una función Lambda de forma local.
$
sam local invoke --event
events/s3.json S3JsonLoggerFunction