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 start-api
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 start-api
subcomando.
-
Para una introducción al AWS SAM CLI, consulte ¿Qué es el AWS SAM CLI?
-
Para obtener documentación sobre el uso del AWS SAM CLI
sam local start-api
subcomando, consulteIntroducción a las pruebas con sam local start-api.
El sam local start-api
subcomando ejecuta AWS Lambda las funciones de forma local para probarlas en un HTTP servidor local.
Uso
$
sam local start-api
<options>
Opciones
--add-host
LIST
-
Transfiere una asignación de nombre de host a dirección IP al archivo de host del contenedor Docker. Este parámetro se puede pasar 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, consulte Archivo de configuración de la CLI de AWS SAM.
--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 predeterminado es “samconfig.toml” en la raíz del directorio del proyecto. Para obtener más información sobre los archivos de configuración, consulte Archivo de configuración de la CLI de AWS SAM.
--container-env-vars
-
Opcional. Al realizar la depuración local, pasa las variables de entorno al contenedor de imágenes.
--container-host
TEXT
-
Host del contenedor Lambda emulado localmente. El valor predeterminado es
localhost
. Si quieres correr AWS SAM CLI en un contenedor Docker en macOS, puede especificarhost.docker.internal
. 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
. Utilice0.0.0.0
para enlazarse a todas las interfaces. --debug
-
Activa el registro de depuración para imprimir el mensaje de depuración generado por el AWS SAM CLI y muestra las marcas de tiempo.
--debug-args
TEXT
-
Los argumentos adicionales que se pasarán al depurador.
--debug-function
-
Opcional. Especifica la función de Lambda a la que se aplicarán las opciones de depuración cuando
--warm-containers
se especifique. Este parámetro se aplica a--debug-port
,--debugger-path
y--debug-args
. --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 que se montará en el contenedor de Lambda.
--docker-network
TEXT
-
Especifica 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 solo se conectan a la red Docker en modo puente predeterminada.
--docker-volume-basedir, -v
TEXT
-
La ubicación del directorio base donde 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.
--force-image-build
-
Especifica si AWS SAM CLI debe reconstruir la imagen utilizada para invocar funciones 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
. --host
TEXT
-
El nombre de host local o la dirección IP a la que se va a vincular (predeterminado: “127.0.0.1”).
--invoke-image
TEXT
-
La imagen URI del contenedor que desea usar para las funciones de Lambda. De forma predeterminada, AWS SAM extrae la imagen del contenedor de Amazon ECR Public. Utilice esta opción para extraer la imagen desde otra ubicación.
Puede especificar esta opción varias veces. Cada instancia de esta opción puede tomar una cadena o un par clave-valor. Si especificas una cadena, será la URI de la imagen del contenedor que se usará en todas las funciones de la aplicación. Por ejemplo,
sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8
. Si especificas un par clave-valor, la clave es el nombre del recurso y el valor es el URI de la imagen del contenedor que se usará para ese recurso. Por ejemplo,sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8
. Con los pares clave-valor, puede especificar distintas imágenes de contenedor para distintos recursos. --layer-cache-basedir
DIRECTORY
-
Especifica la ubicación basada en el lugar 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.
--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
--port, -p
INTEGER
-
El número de puerto local en el que se va a escuchar (valor predeterminado: “3000”).
--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. Ejecute con la opción
--hook-name
. --skip-pull-image
-
Especifica si CLI debe omitir la extracción de la última imagen de Docker para el tiempo de ejecución de Lambda.
--ssl-cert-file
PATH
-
Ruta al archivo SSL de certificado (predeterminada: ninguna). Al usar esta opción, también debe usarse la
--ssl-key-file
opción. --ssl-key-file
PATH
-
Ruta al archivo SSL clave (predeterminada: ninguna). Al usar esta opción, también debe usarse la
--ssl-cert-file
opción. --static-dir, -s
TEXT
-
Todos los archivos de activos estáticos (por ejemplo,CSS/JavaScript/HTML) ubicados en este directorio se presentan en
/
. --template, -t
PATH
-
El archivo AWS SAM de plantilla.
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
. --warm-containers
[EAGER | LAZY]
-
Opcional. Especifica cómo AWS SAM CLI gestiona los contenedores para cada función.
Hay dos opciones disponibles:
EAGER
: los contenedores de todas las funciones se cargan al inicio y se conservan entre las invocaciones.LAZY
: los contenedores solo se cargan cuando se invoca cada función por primera vez. Esos contenedores se conservan para realizar más invocaciones.