API 网关支持对接火山引擎的云服务器 ECS，将多个云服务器抽象为一个 Upstream，作为网关的路由后端。业务采用 ECS 部署，希望通过网关将服务能力开放出来，需创建 ECS 类型 Upstream。本文为您介绍如何创建 ECS 类型 Upstream。

前提条件

• 已创建实例，具体操作可参见 创建实例。
• 在 API 网关实例所在地域，已购买 ECS，已完成业务部署。具体操作可参见 购买云服务器。

使用限制

• Upstream 属于实例级别资源。同一实例下，相同的 Upstream 只能创建一次。
• 仅支持添加与网关实例处于同一 VPC 下的 ECS。
• 一个 Upstream 最多支持关联 20 个 ECS，每个 ECS 最多支持配置 5 个访问端口。

操作步骤

1. 登录 API 网关控制台。

2. 在顶部导航栏，选择目标地域。

3. 在左侧导航栏选择 后端管理 > Upstream 列表。

4. 在 Upstream 列表页面，单击 创建 Upstream。

5. 在创建 Upstream 页面，按要求填写参数信息。

   • 基本信息

     配置项	说明
     所属实例	Upstream 属于实例级别的资源，请选择当前 Upstream 所属的网关实例。
     Upstream 名称	自定义 Upstream 名称。同一实例下的 Upstream 名称唯一。
     备注	填写当前 Upstream 的备注信息，可以为空。

   • 后端配置

     配置项	说明
     后端服务	选择 Upstream 对接的后端服务类型。本场景选择 云服务器。 添加云服务器：单击 添加服务器，弹出 添加服务器 抽屉，勾选目标 ECS 名称，最多支持添加 20 个 ECS。 配置端口：单击 下一步，为每个 ECS 配置访问端口。API 网关只能通过您配置的端口访问对应的 ECS。单个 ECS 最多支持配置 5 个端口。配置完成后，单击 确定。 说明 仅支持选择与网关实例处于同一 VPC 下的 ECS。 仅支持选择状态为运行中的 ECS。
     协议	选择协议类型。支持 HTTP1.1、HTTP2 和 HTTP2/GRPC。
     TLS 设置	配置 TLS。支持 关闭 TLS 和 单向 TLS。 关闭 TLS：网关访问后端 Upstream 使用 HTTP 协议。 单向 TLS：网关访问后端 Upstream 使用 HTTPS 协议，需要选择对应证书。
     负载均衡算法	选择负载均衡算法，默认为轮询。 轮询：将所有请求依次分发到每个 ECS，适合 ECS 硬件配置相同的场景。 随机：请求随机分配到各个 ECS。 最小连接数：将请求分配到目前处理请求数最少的 ECS。 一致性哈希：基于 header/querystring 信息进行负载均衡，在后端服务数量不变的情况下，确保携带信息相同的用户可固定访问同一 ECS。
     服务熔断	选择是否开启熔断。开启后，API 网关可以通过设置熔断器以提高路由的命中率，不消耗额外流量。详情请参见 配置服务熔断策略。

6. 单击 确定，创建完成 ECS 类型 Upstream。

后续操作

• 创建路由
• 放行 APIG 安全组
  您需要为对应的 ECS 访问端口放行 APIG 安全组（命名为apig-sg-<accountID>），确保网关可以正常访问 ECS 对应端口中的资源。
  例如：假设您设置的 ECS 访问端口为 8090。登录云服务器控制台，选择目标 ECS 实例主网卡关联的安全组，添加一条入方向规则，为 8090 端口放行 APIG 安全组。