在本地调用 Lambda 函数 - Amazon Serverless Application Model
环境变量文件层了解更多信息
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在本地调用 Lambda 函数

您可以使用sam 本地调用Amazon SAM CLI 命令并提供Amazon Lambda函数的逻辑 ID 和事件文件，在本地调用您的函数。或者，sam local invoke也可以接受stdin为事件。有关事件的更多信息，请参阅Amazon Lambda开发者指南中的事件。有关来自不同Amazon服务的事件消息格式的信息，请参阅Amazon Lambda开发者指南中的Amazon Lambda与其他服务一起使用。

注意

该sam local invoke命令对应于Amazon Command Line Interface (Amazon CLI) 命令aws lambda invoke。您可以使用任一命令调用 Lambda 函数。

必须在要调用的函数的项目目录中运行sam local invoke命令。

示例：

# Invoking function with event file
$ sam local invoke "Ratings" -e event.json

# Invoking function with event via stdin
$ echo '{"message": "Hey, are you there?" }' | sam local invoke --event - "Ratings"

# For more options
$ sam local invoke --help

环境变量文件

要在本地声明环境变量以覆盖模板中定义的值，请执行以下操作：

  1. 创建一个 JSON 文件，其中包含要覆盖的环境变量。

  2. 使用--env-vars参数覆盖模板中定义的值。

声明环境变量

要声明全局应用于所有资源的环境变量，请指定如下所示的Parameters对象：

{
    "Parameters": {
        "TABLE_NAME": "localtable",
        "BUCKET_NAME": "testBucket",
        "STAGE": "dev"
    }
}

要为每种资源声明不同的环境变量，请为每个资源指定对象，如下所示：

{
    "MyFunction1": {
        "TABLE_NAME": "localtable",
        "BUCKET_NAME": "testBucket",
    },
    "MyFunction2": {
        "TABLE_NAME": "localtable",
        "STAGE": "dev"
    }
}

为每种资源指定对象时，您可以使用以下标识符，按优先级从高到低的顺序列出：

  1. logical_id

  2. function_id

  3. function_name

  4. 完整路径标识符

您可以使用上述两种方法在单个文件中一起声明环境变量。这样做时，您为特定资源提供的环境变量优先于全局环境变量。

将您的环境变量保存在 JSON 文件中，例如env.json。

重写环境变量值

要使用 JSON 文件中定义的环境变量替换环境变量，请将--env-vars参数与invoke或start-api命令一起使用。例如：

sam local invoke --env-vars env.json

层

如果您的应用程序包含层，有关如何调试本地主机上层问题的信息，请参阅使用图层。

了解更多信息

有关在本地调用函数的实践示例，请参阅 “完整Amazon SAM研讨会” 中的模块 2-本地运行。