

# 使用 API Gateway 控制台设置 API 集成请求
<a name="how-to-method-settings-console"></a>

 API 方法设置定义该方法并描述其行为。要设置方法，您必须指定一个包含根 (“/”) 的资源以便在其中公开该方法，并指定 HTTP 方法（`GET`、`POST` 等）以及该方法如何与目标后端集成。方法请求和响应指定与调用应用程序的协定，其中规定 API 可以接收哪些参数以及响应是什么样子。

 以下过程介绍如何使用 API Gateway 控制台创建集成请求。

**Topics**
+ [设置 Lambda 集成](#how-to-method-settings-console-lambda)
+ [设置 HTTP 集成](#how-to-method-settings-console-http)
+ [设置 AWS 服务集成](#how-to-method-settings-console-aws)
+ [设置模拟集成](#how-to-method-settings-console-mock)

## 设置 Lambda 集成
<a name="how-to-method-settings-console-lambda"></a>

使用 Lambda 函数集成，来将您的 API 与 Lambda 函数集成。在 API 级别，如果您创建非代理集成，则这是 `AWS` 集成类型；如果您创建代理集成，则这是 `AWS_PROXY` 集成类型。

**设置 Lambda 集成**

1. 在**资源**窗格中，选择**创建方法**。

1. 对于**方法类型**，选择一种 HTTP 方法。

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

1. 要使用 Lambda 代理集成，请开启 **Lambda 代理集成**。要了解有关 Lambda 代理集成的更多信息，请参阅[了解 API Gateway Lambda 代理集成](set-up-lambda-proxy-integrations.md#api-gateway-create-api-as-simple-proxy)。

1. 对于 **Lambda 函数**，输入函数 Lambda 的名称。

    如果您在与您的 API 不同的区域中使用 Lambda 函数，请从下拉菜单中选择该区域并输入 Lambda 函数的名称。如果您使用的是跨账户 Lambda 函数，请输入函数 ARN。

1. 要使用默认超时值 29 秒，请保持**默认超时**处于开启状态。要设置自定义超时，请选择**默认超时**，然后输入一个介于 `50` 到 `29000` 毫秒之间的超时值。

1. （可选）您可以使用以下下拉菜单配置方法请求设置。选择**方法请求设置**并配置您的方法请求。有关更多信息，请参阅[在 API Gateway 控制台中编辑 API Gateway 方法请求](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console)的步骤 3。

   您也可以在创建方法后配置方法请求设置。

1. 选择**创建方法**。

## 设置 HTTP 集成
<a name="how-to-method-settings-console-http"></a>

使用 HTTP 集成将您的 API 与 HTTP 端点集成。在 API 级别，这是 `HTTP` 集成类型。

**设置 HTTP 集成**

1. 在**资源**窗格中，选择**创建方法**。

1. 对于**方法类型**，选择一种 HTTP 方法。

1. 对于**集成类型**，选择 **HTTP**。

1. 要使用 HTTP 代理集成，请开启 **HTTP 代理集成**。要了解有关 HTTP 代理集成的更多信息，请参阅[在 API Gateway 中设置 HTTP 代理集成](setup-http-integrations.md#api-gateway-set-up-http-proxy-integration-on-proxy-resource)。

1. 对于 **HTTP 方法**，选择与 HTTP 后端中的方法最匹配的 HTTP 方法类型。

1. 对于**端点 URL**，输入您希望此方法使用的 HTTP 后端的 URL。

1. 对于**内容处理**，请选择内容处理行为。

1. 要使用默认超时值 29 秒，请保持**默认超时**处于开启状态。要设置自定义超时，请选择**默认超时**，然后输入一个介于 `50` 到 `29000` 毫秒之间的超时值。

1. （可选）您可以使用以下下拉菜单配置方法请求设置。选择**方法请求设置**并配置您的方法请求。有关更多信息，请参阅[在 API Gateway 控制台中编辑 API Gateway 方法请求](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console)的步骤 3。

   您也可以在创建方法后配置方法请求设置。

1. 选择**创建方法**。

## 设置 AWS 服务集成
<a name="how-to-method-settings-console-aws"></a>

使用 AWS 服务集成将您的 API 直接与 AWS 服务集成。在 API 级别，这是 `AWS` 集成类型。

设置 API Gateway API 执行以下任一操作：
+ 新建 Lambda 函数。
+ 设置 Lambda 函数的资源权限。
+ 执行任何其它 Lambda 服务操作。

您必须选择 **AWS 服务**。

**设置 AWS 服务集成**

1. 在**资源**窗格中，选择**创建方法**。

1. 对于**方法类型**，选择一种 HTTP 方法。

1. 对于**集成类型**，选择 **AWS 服务**。

1. 对于 **AWS 区域**，选择您希望此方法用于调用操作的 AWS 区域。

1. 对于 **AWS 服务**，选择您希望此方法调用的 AWS 服务。

1.  对于 **AWS 子域**，请输入 AWS 服务使用的子域。通常，您会将此项保留为空。某些 AWS 服务可以支持子域作为主机的一部分。有关可用性和详细信息 (如果有)，请参阅服务文档。

1. 对于 **HTTP 方法**，选择与操作对应的 HTTP 方法类型。对于 HTTP 方法类型，请参阅您为 **AWS 服务**选择的 AWS 服务的 API 参考文档。

1. 对于**操作类型**，选择**使用操作名称**以使用 API 操作，或选择**使用路径覆盖**以使用自定义资源路径。有关可用的操作和自定义资源路径，请参阅您为 **AWS 服务**选择的 AWS 服务的 API 参考文档。

1. 输入**操作名称**或**路径覆盖**。

1. 对于**执行角色**，输入该方法将用于调用操作的 IAM 角色的 ARN。

   要创建 IAM 角色，您可以调整[步骤 1：创建 AWS 服务代理执行角色](getting-started-aws-proxy.md#getting-started-aws-proxy-add-roles)中的说明。使用所需数量的操作和资源语句指定访问策略。有关更多信息，请参阅 [Amazon API Gateway 如何与 IAM 配合使用](security_iam_service-with-iam.md)。

   有关操作和资源语句语法，请参阅您为 **AWS 服务**选择的 AWS 服务的文档。

   有关 IAM 角色的信任关系，请指定以下内容，使 API Gateway 代表您的AWS账户采取行动：

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Sid": "",
         "Effect": "Allow",
         "Principal": {
           "Service": "apigateway.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

1. 要使用默认超时值 29 秒，请保持**默认超时**处于开启状态。要设置自定义超时，请选择**默认超时**，然后输入一个介于 `50` 到 `29000` 毫秒之间的超时值。

1. （可选）您可以使用以下下拉菜单配置方法请求设置。选择**方法请求设置**并配置您的方法请求。有关更多信息，请参阅[在 API Gateway 控制台中编辑 API Gateway 方法请求](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console)的步骤 3。

   您也可以在创建方法后配置方法请求设置。

1. 选择**创建方法**。

## 设置模拟集成
<a name="how-to-method-settings-console-mock"></a>

 如果您希望 API Gateway 充当您的后端来返回静态响应，则使用模拟集成。在 API 级别，这是 `MOCK` 集成类型。通常，如果您的 API 尚未最终确定，但您想生成 API 响应以便不妨碍相关团队进行测试，则可使用 `MOCK` 集成。对于 `OPTION` 方法，API Gateway 将 `MOCK` 集成设置为默认值以便为应用的 API 资源返回支持 CORS 的标头。

**设置模拟集成**

1. 在**资源**窗格中，选择**创建方法**。

1. 对于**方法类型**，选择一种 HTTP 方法。

1. 对于**集成类型**，选择**模拟**。

1. （可选）您可以使用以下下拉菜单配置方法请求设置。选择**方法请求设置**并配置您的方法请求。有关更多信息，请参阅[在 API Gateway 控制台中编辑 API Gateway 方法请求](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console)的步骤 3。

   您也可以在创建方法后配置方法请求设置。

1. 选择**创建方法**。