View a markdown version of this page

在控制台中测试 Lambda 函数 - Amazon Lambda
使用测试事件调用函数创建私有测试事件创建可共享测试事件删除可共享测试事件 Schema
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

在控制台中测试 Lambda 函数

您可以在控制台中使用测试事件调用函数，从而测试 Lambda 函数。测试事件是函数的一个 JSON 输入。如果函数不需要输入，则事件可以是空文档 ({})。

在控制台中运行测试时，Lambda 会使用测试事件同步调用您的函数。函数运行时系统将事件 JSON 转换为一个对象，并将该对象传递给代码的处理程序方法以进行处理。

创建测试事件

您需要先创建一个私有或可共享的测试事件，然后才能在控制台中进行测试。

使用测试事件调用函数

测试函数

  1. 打开 Lamba 控制台的函数页面。

  2. 选择要测试的函数的名称。

  3. 选择测试选项卡。

  4. 在测试事件下，选择创建新事件或编辑已保存的事件，然后选择要使用的已保存事件。

  5. 可选：为事件 JSON 选择一个模板。

  6. 选择测试。

  7. 在 Execution result（执行结果）下，展开 Details（详细信息）以查看测试结果。

要在不保存测试事件的情况下调用函数，请在保存之前选择 Test（测试）。这将创建一个未保存的测试事件，Lambda 仅会在会话期间内保存该事件。

对于 Node.js、Python 和 Ruby 运行时，您还可以在代码选项卡上访问现有已保存和未保存的测试事件。使用测试事件部分来创建、编辑和运行测试。

创建私有测试事件

私人测试事件仅供事件创建者使用，并且不需要额外的权限即可使用。每个函数最多可以创建和保存 10 个测试事件。

创建私有测试事件

  1. 打开 Lamba 控制台的函数页面。

  2. 选择要测试的函数的名称。

  3. 选择测试选项卡。

  4. 在 Test event（测试事件）下执行以下操作：

    1. 选择一个 Template（模板）。

    2. 输入测试的 Name（名称）。

    3. 在文本输入框中，输入 JSON 测试事件。

    4. 在 Event sharing settings（事件共享设置）下，选择 Private（私有）。

  5. 选择保存更改。

对于 Node.js、Python 和 Ruby 运行时，您还可以在代码选项卡上创建测试事件。使用测试事件部分来创建、编辑和运行测试。

创建可共享测试事件

可共享测试事件是您可与同一 Amazon 账户中的其他用户共享的测试事件。您可以编辑其他用户的可共享测试事件并使用这些测试事件调用您的函数。

Lambda 将可共享测试事件作为 Schema 保存在一个名为 lambda-testevent-schemas 的 Amazon EventBridge（CloudWatch Events）Schema 注册表中。由于 Lambda 使用此注册表来存储和调用您创建的可共享测试事件，因此我们建议您不要编辑此注册表或使用 lambda-testevent-schemas 名称创建注册表。

要查看、共享和编辑可共享测试事件，您必须拥有以下所有 EventBridge（CloudWatch Events）Schema 注册表 API 操作的权限：

请注意，保存对可共享测试事件所做的编辑将覆盖该事件。

如果您无法创建、编辑或查看可共享测试事件，请检查您的账户是否具有这些操作所需的权限。如果您拥有所需的权限但仍然无法访问可共享测试事件，请检查任何基于资源的策略，因为这些策略可能会限制对 EventBridge（CloudWatch Events）注册表的访问权限。

创建可共享测试事件

  1. 打开 Lamba 控制台的函数页面。

  2. 选择要测试的函数的名称。

  3. 选择测试选项卡。

  4. 在 Test event（测试事件）下执行以下操作：

    1. 选择一个 Template（模板）。

    2. 输入测试的 Name（名称）。

    3. 在文本输入框中，输入 JSON 测试事件。

    4. 在 Event sharing settings（事件共享设置）下，选择 Shareable（可共享）。

  5. 选择保存更改。

通过 Amazon Serverless Application Model 使用可共享的测试事件。

您可以使用 Amazon SAM 调用可共享的测试事件。请参阅《Amazon Serverless Application Model 开发人员指南》https://docs.amazonaws.cn/serverless-application-model/latest/developerguide/using-sam-cli-remote-test-event.html中的 sam remote test-event

删除可共享测试事件 Schema

当您删除可共享测试事件时，Lambda 会将其从 lambda-testevent-schemas 注册表移除。如果您从注册表中移除了最后一个可共享测试事件，Lambda 将删除该注册表。

如果您删除了函数，Lambda 不会删除任何关联的可共享测试事件 Schema。您必须从 EventBridge（CloudWatch Events）控制台手动清除这些资源。