sam local invoke

The ID of the Lambda function to invoke.

This argument is optional. If your application contains a single Lambda function, the Amazon SAM CLI will invoke it. If your application contains multiple functions, provide the ID of the function to invoke.

Valid values: The resource's logical ID or resource ARN.

Passes a hostname to IP address mapping to the Docker container's host file. This parameter can be passed multiple times.

Allow or deny beta features.

The environment name specifying the default parameter values in the configuration file to use. The default value is "default". For more information about configuration files, see Amazon SAM CLI configuration file.

The path and file name of the configuration file containing default parameter values to use. The default value is "samconfig.toml" in the root of the project directory. For more information about configuration files, see Amazon SAM CLI configuration file.

(Optional) Pass environment variables to the Lambda function image container when debugging locally.

Host of locally emulated Lambda container. The default value is localhost. If you want to run Amazon SAM CLI in a Docker container on macOS, you can specify host.docker.internal. If you want to run the container on a different host than Amazon SAM CLI, you can specify the IP address of the remote host.

The IP address of the host network interface that container ports should bind to. The default value is 127.0.0.1. Use 0.0.0.0 to bind to all interfaces.

Turns on debug logging to print debug messages that the Amazon SAM CLI generates, and to display timestamps.

Additional arguments to pass to the debugger.

When specified, starts the Lambda function container in debug mode and exposes this port on the local host.

The host path to a debugger that's mounted into the Lambda container.

The name or ID of an existing Docker network that Lambda Docker containers should connect to, along with the default bridge network. If this isn't specified, the Lambda containers connect only to the default bridge Docker network.

The location of the base directory where the Amazon SAM file exists. If Docker is running on a remote machine, you must mount the path where the Amazon SAM file exists on the Docker machine and modify this value to match the remote machine.

The JSON file that contains values for the Lambda function's environment variables. For more information about environment variable files, see Environment variable file.

The JSON file that contains event data that's passed to the Lambda function when it's invoked. If you don't specify this option, no event is assumed. To input JSON from stdin, you must pass in the value '-'. For details about event message formats from different Amazon services, see Working with other services in the Amazon Lambda Developer Guide.

Specifies whether the Amazon SAM CLI should rebuild the image used for invoking Lambda functions with layers.

Shows this message and exits.

The name of the hook that is used to extend Amazon SAM CLI functionality.

Accepted values: terraform.

The URI of the container image that you want to use for the local function invocation. By default, Amazon SAM pulls the container image from Amazon ECR Public (which are listed in Image repositories for Amazon SAM). Use this option to pull the image from another location.

For example, sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8.

Specifies the location of the base directory where the layers that your template uses are downloaded to.

The log file to send runtime logs to.

Ensures the Amazon SAM CLI always mounts symlinks that are present in the files to build or invoke. This applies only to symlinks on the top level directory (that is, symlinks that are directly on the function's root). By default, symlinks are not mounted except for those needed to use build-in-source for node_modules in NodeJS.

Invokes the function with an empty event.

Removes the memory limitation in the container during local invoke, even when memory is configured in the Amazon SAM template.

A string that contains Amazon CloudFormation parameter overrides encoded as key-value pairs. Use the same format as the Amazon Command Line Interface (Amazon CLI). The Amazon SAM CLI format is explicit key and value keywords, each override is separated by a space. Here are two examples:

The specific profile from your credential file that gets Amazon credentials.

The Amazon Region to deploy to. For example, us-east-1.

Uses the specified runtime to invoke a Lambda function locally. This overrides the runtime defined in the template.yml file. This also allows testing Lambda functions with different runtimes without modifying the original function configuration.

Save the parameters that you provide at the command line to the Amazon SAM configuration file.

Emulates a shutdown event after the invoke completes, in order to test extension handling of shutdown behavior.

Skips the preparation stage if no infrastructure changes have been made. Use with the --hook-name option.

By default, the Amazon SAM CLI checks Lambda's latest remote runtime environment and updates your local image automatically to keep in sync.

Specify this option to skip pulling down the latest Docker image for your Lambda runtime environment.

The Amazon SAM template file.

This option is not compatible with --hook-name.

The relative or absolute path to your local Terraform plan file when using the Amazon SAM CLI with Terraform Cloud. This option requires that --hook-name be set to terraform.