为 API Gateway 中的 REST API 设置阶段变量

通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

创建 API，然后在 API 的根资源上创建 GET 方法。将集成类型设置为 HTTP，并将端点 URL 设置为 http://${stageVariables.url}。

将 API 部署到名为 beta 的新阶段。

在主导航窗格中，选择阶段，然后选择 beta 阶段。

在阶段变量选项卡上，选择编辑。

选择添加阶段变量。

对于名称，请输入 url。对于值，输入 httpbin.org/get。

选择添加阶段变量，然后执行以下操作：

对于名称，请输入 stageName。对于值，输入 beta。

选择添加阶段变量，然后执行以下操作：

对于名称，请输入 function。对于值，输入 HelloWorld。

选择保存。

现在创建第二个阶段。从阶段导航窗格中，选择创建阶段。对于阶段名称，输入 prod。从部署中选择一个新近部署，然后选择创建阶段。

与 beta 阶段一样，将相同的三个阶段变量（url、stageName 和 function）分别设置为不同的值（petstore-demo-endpoint.execute-api.com/petstore/pets、prod 和 HelloEveryone）。

在阶段导航窗格中，选择 beta 阶段。在阶段详细信息下，选择复制图标以复制 API 的调用 URL，然后在 Web 浏览器中输入 API 的调用 URL。这将启动 API 根资源上的 beta 阶段 GET 请求。

beta 阶段 GET 请求的响应如下所示。您还可以使用浏览器导航到 http://httpbin.org/get，以验证结果。此值已分配到 beta 阶段中的 url 变量。这两个响应完全相同。

在阶段导航窗格中，选择 prod 阶段。在阶段详细信息下，选择复制图标以复制 API 的调用 URL，然后在 Web 浏览器中输入 API 的调用 URL。这将启动 API 根资源上的 prod 阶段 GET 请求。

prod 阶段 GET 请求的响应如下所示。您可以使用浏览器导航到 http://petstore-demo-endpoint.execute-api.com/petstore/pets，以验证结果。此值已分配到 prod 阶段中的 url 变量。这两个响应完全相同。

在资源导航窗格中，选择 GET 方法。

要向方法的 URL 添加查询字符串参数，请选择方法请求选项卡，然后在方法请求设置部分中选择编辑。

选择 URL 查询字符串参数并执行以下操作：

1. 选择添加查询字符串。

2. 在名称中，输入 stageName。

3. 保持必填和缓存为已关闭状态。

选择保存。

选择集成请求选项卡，然后在集成请求设置部分中，选择编辑。

对于端点 URL，将 ?stageName=${stageVariables.stageName} 附加到先前定义的 URL 值，因此整个端点 URL 为 http://${stageVariables.url}?stageName=${stageVariables.stageName}。

选择部署 API，然后选择 beta 阶段。

在主导航窗格中，选择阶段。在阶段导航窗格中，选择 beta 阶段。在阶段详细信息下，选择复制图标以复制 API 的调用 URL，然后在 Web 浏览器中输入 API 的调用 URL。

您将收到以下响应。注意，分配给 beta 阶段变量的 stageName 作为 stageName 参数传递到后端。

使用默认 Node.js 运行时系统创建名为 HelloWorld 的 Lambda 函数。代码必须包含以下内容：

export const handler = function(event, context, callback) {
    if (event.stageName)
        callback(null, 'Hello, World! I\'m calling from the ' + event.stageName + ' stage.');
    else
        callback(null, 'Hello, World! I\'m not sure where I\'m calling from...');
};

有关如何创建 Lambda 函数的更多信息，请参阅 REST API 控制台入门。

在资源窗格中，选择创建资源，然后执行以下操作：

1. 对于资源路径，选择 /。

2. 对于资源名称，输入 lambdav1。

3. 选择创建资源。

选择 /lambdav1 资源，然后选择创建方法。

然后执行以下操作：

1. 对于方法类型，选择 GET。

2. 对于集成类型，选择 Lambda 函数。

3. 保持 Lambda 代理集成处于关闭状态。

4. 对于 Lambda 函数，输入 ${stageVariables.function}。

   提示

   当提示使用添加权限命令时，复制 Amazon CLI 命令。对将分配给 function 阶段变量的每个 Lambda 函数运行此命令。例如，如果 $stageVariables.function 值为 HelloWorld，则运行以下 Amazon CLI 命令：

   aws lambda add-permission --function-name arn:aws:lambda:us-east-1:account-id:function:HelloWorld --source-arn arn:aws:execute-api:us-east-1:account-id:api-id/*/GET/lambdav1 --principal apigateway.amazonaws.com --statement-id statement-id-guid --action lambda:InvokeFunction

   否则会导致在调用该方法时出现 500 Internal Server Error 响应。将 ${stageVariables.function} 替换为已分配给阶段变量的 Lambda 函数名称。

5. 选择创建方法。

将 API 部署到 prod 和 beta 阶段。

在主导航窗格中，选择阶段。在阶段导航窗格中，选择 beta 阶段。在阶段详细信息下，选择复制图标以复制 API 的调用 URL，然后在 Web 浏览器中输入 API 的调用 URL。在按 Enter 之前，将 /lambdav1 附加到 URL。

您将收到以下响应。

"Hello, World! I'm not sure where I'm calling from..."

选择 /lambdav1 资源，然后选择创建方法。

然后执行以下操作：

1. 对于方法类型，选择 POST。

2. 对于集成类型，选择 Lambda 函数。

3. 保持 Lambda 代理集成处于关闭状态。

4. 对于 Lambda 函数，输入 ${stageVariables.function}。

5. 当提示使用添加权限命令时，复制 Amazon CLI 命令。对将分配给 function 阶段变量的每个 Lambda 函数运行此命令。

6. 选择创建方法。

选择集成请求选项卡，然后在集成请求设置部分中，选择编辑。

选择映射模板，然后选择添加映射模板。

对于内容类型，输入 application/json。

对于模板正文，输入以下模板：

#set($inputRoot = $input.path('$'))
{
    "stageName" : "$stageVariables.stageName"
}

选择保存。

将 API 部署到 beta 和 prod 阶段。

要使用 REST API 客户端传递特定于阶段的元数据，请执行以下操作：

1. 在阶段导航窗格中，选择 beta 阶段。在阶段详细信息下，选择复制图标以复制 API 的调用 URL，然后在 REST API 客户端的输入字段中输入 API 的调用 URL。在提交请求之前附加 /lambdav1。

   您将收到以下响应。

   "Hello, World! I'm calling from the beta stage."

2. 在阶段导航窗格中，选择 prod。在阶段详细信息下，选择复制图标以复制 API 的调用 URL，然后在 REST API 客户端的输入字段中输入 API 的调用 URL。在提交请求之前附加 /lambdav1。

   您将收到以下响应。

   "Hello, World! I'm calling from the prod stage."

要使用测试特征传递特定于阶段的元数据，请执行以下操作：

1. 在资源导航窗格中，选择测试选项卡。您可能需要选择右箭头按钮以显示该选项卡。

2. 对于 function，请输入 HelloWorld。

3. 对于 stageName，请输入 beta。

4. 选择测试。您无需将正文添加到您的 POST 请求。

   您将收到以下响应。

   "Hello, World! I'm calling from the beta stage."

5. 您可以重复前面的步骤来测试 Prod 阶段。对于 stageName，请输入 Prod。

   您将收到以下响应。

   "Hello, World! I'm calling from the prod stage."