教程：使用 Lambda 代理集成构建 Hello World REST API

创建“Hello, World!” Lambda 控制台中的 Lambda 函数

1. 通过以下网址登录 Lambda 控制台：https://console.aws.amazon.com/lambda。

2. 在 Amazon 导航栏中，选择一个区域（例如，美国东部 (弗吉尼亚北部)）。

   注意

   请注意您创建 Lambda 函数时所在的区域。在创建 API 时，会需要它。

3. 在导航窗格中，选择 Functions (函数)。

4. 选择创建函数。

5. 选择 Author from scratch (从头开始创作)。

6. 在 Basic information (基本信息) 中，执行以下操作：

   1. 在 Function name (函数名称) 中，输入 GetStartedLambdaProxyIntegration。

   2. 从 Runtime (运行时) 下拉列表中，选择受支持的 Node.js 运行时。

   3. 在 Permissions (权限) 下，展开 Choose or create an execution role (选择或创建执行角色)。从 Execution role (执行角色) 下拉列表中，选择 Create new role from Amazon policy templates (从亚马逊云科技策略模板创建新角色)。

   4. 在 Role Name (角色名称) 中，输入 GetStartedLambdaBasicExecutionRole。

   5. 将 Policy templates (策略模板) 字段留空。

   6. 选择创建函数。

7. 在 Function code (函数代码) 下，在内联代码编程中，复制/粘贴以下代码：

   'use strict';
   console.log('Loading hello world function');
    
   exports.handler = async (event) => {
       let name = "you";
       let city = 'World';
       let time = 'day';
       let day = '';
       let responseCode = 200;
       console.log("request: " + JSON.stringify(event));
       
       if (event.queryStringParameters && event.queryStringParameters.name) {
           console.log("Received name: " + event.queryStringParameters.name);
           name = event.queryStringParameters.name;
       }
       
       if (event.queryStringParameters && event.queryStringParameters.city) {
           console.log("Received city: " + event.queryStringParameters.city);
           city = event.queryStringParameters.city;
       }
       
       if (event.headers && event.headers['day']) {
           console.log("Received day: " + event.headers.day);
           day = event.headers.day;
       }
       
       if (event.body) {
           let body = JSON.parse(event.body)
           if (body.time) 
               time = body.time;
       }
    
       let greeting = `Good ${time}, ${name} of ${city}.`;
       if (day) greeting += ` Happy ${day}!`;
   
       let responseBody = {
           message: greeting,
           input: event
       };
       
       // The output from a Lambda proxy integration must be 
       // in the following JSON object. The 'headers' property 
       // is for custom response headers in addition to standard 
       // ones. The 'body' property  must be a JSON string. For 
       // base64-encoded payload, you must also set the 'isBase64Encoded'
       // property to 'true'.
       let response = {
           statusCode: responseCode,
           headers: {
               "x-custom-header" : "my custom header value"
           },
           body: JSON.stringify(responseBody)
       };
       console.log("response: " + JSON.stringify(response))
       return response;
   };

8. 选择 Deploy (部署)。

构建“Hello, World!” API

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

2. 如果您是第一次使用 API Gateway，您会看到一个介绍服务功能的页面。在 REST API 下，选择 Build (生成)。当 Create Example API (创建示例 API) 弹出框出现时，选择 OK (确定)。

   如果这不是您首次使用 API Gateway，请选择创建 API。在 REST API 下，选择 Build (生成)。

3. 创建一个空的 API，如下所示：

   1. 在 Create a new API (创建新 API) 下，选择 New API (新建 API)。

   2. 在 Settings (设置) 下：

      • 对于 API Name (API 名称)，请输入 LambdaSimpleProxy。

      • 如果需要，在 Description (说明) 字段中输入说明；否则，将其保留为空。

      • 将终端节点类型设置为区域。

   3. 选择 Create API (创建 API)。

4. 创建 helloworld 资源，如下所示：

   1. 在 Resources (资源) 树下选择根资源 (/)。

   2. 从 Actions (操作) 下拉菜单中，选择 Create Resource (创建资源)。

   3. 取消选中 Configure as proxy resource (作为代理资源进行配置)。

   4. 对于资源名称，输入 helloworld。

   5. 将资源路径设置为 /helloworld。

   6. 取消选中 Enable API Gateway CORS (启用 API Gateway CORS)。

   7. 选择 Create Resource (创建资源)。

5. 在代理集成中，整个请求将通过表示任何 HTTP 方法的“捕获全部”ANY 方法按原样发送到后端 Lambda 函数。实际的 HTTP 方法由客户端在运行时指定。ANY 方法可让您对所有支持的 HTTP 方法使用单个 API 方法设置：DELETE、GET、HEAD、OPTIONS、PATCH、POST 和 PUT。

   要设置 ANY 方法，请执行以下操作：

   1. 在 Resources (资源) 列表中，选择 /helloworld。

   2. 在 Actions (操作) 菜单中，选择 Create method (创建方法)。

   3. 从下拉菜单中选择任何，然后选中复选标记图标

   4. 将集成类型设置为 Lambda 函数。

   5. 选择 Use Lambda Proxy integration (使用 Lambda 代理集成)。

   6. 对于 Lambda 区域下拉菜单，选择您在其中创建 GetStartedLambdaProxyIntegration Lambda 函数的区域。

   7. 在 Lambda 函数字段中，键入任何字符并从下拉菜单中选择 GetStartedLambdaProxyIntegration。

   8. 将 Use Default Timeout (使用默认超时) 保持选中状态。

   9. 选择 Save。

   10. 在出现 Add Permission to Lambda Function (向 Lambda 函数添加权限) 提示时，选择 OK (确定)。

在 API Gateway 控制台中部署 API

1. 从 Actions (操作) 下拉菜单中选择 Deploy API (部署 API)。

2. 对于部署阶段，选择[新阶段]。

3. 对于 Stage name (阶段名称)，输入 test。

4. 如果需要，输入一个 Stage description (阶段说明)。

5. 如果需要，输入一个 Deployment description (部署说明)。

6. 选择 Deploy (部署)。

7. 请记下 API 的 Invoke URL (调用 URL)。

使用 cURL 测试已部署的 API：

1. 打开终端窗口。

2. 复制以下 cURL 命令将其粘贴到终端窗口中，同时将 r275xc9bmd 替换为您的 API 的 API ID 并将 us-east-1 替换为部署您的 API 的区域。

   curl -v -X POST \
     'https://r275xc9bmd.execute-api.us-east-1.amazonaws.com/test/helloworld?name=John&city=Seattle' \
     -H 'content-type: application/json' \
     -H 'day: Thursday' \
     -d '{ "time": "evening" }'

   注意

   如果您在 Windows 上运行命令，请改用以下语法：

   curl -v -X POST "https://r275xc9bmd.execute-api.us-east-1.amazonaws.com/test/helloworld?name=John&city=Seattle" -H "content-type: application/json" -H "day: Thursday" -d "{ \"time\": \"evening\" }"