最近更新时间:2024.04.11 17:57:13
首次发布时间:2022.09.01 11:30:06
API 名称:UpdateEndpointGroup。
API 域名:open.volcengineapi.com 。
API 描述:更新终端节点组。
在使用该部分 API 提交请求时必须包含以下 URI 参数。
除了 URI 参数,该 API 请求还需要包含签名参数。关于更多签名参数的信息,参见公共请求参数。
名称 | 类型 | 是否必选 | 格式 | 说明 |
---|---|---|---|---|
Action | string | 是 | [a-zA-Z]+ | API 名称。 |
Version | string | 是 | YYYY-MM-DD | API 版本信息。该参数的取值是 2022-03-01 。 |
在使用该 API 提交请求时,请求正文中可以包含的参数如下。
参数 | 类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
Name | string | 否 | 终端节点组名称。 | test |
AcceleratorId | string | 是 | 加速器 ID 。 | ga-344345ggfa |
ListenerId | string | 是 | 监听 ID 。 | lsn-344345ggfa |
EndpointGroupId | string | 是 | 终端节点组 ID 。 | ga-ghdasgh*** |
IsVolcSource | bool | 是 | 后端服务部署是否在火山引擎上。支持取值:
| true |
KeepClientIP | bool | 是 | 是否开启保持客户端源 IP 功能,默认不开启此功能,支持取值:
| true |
KeepClientIPMethod | string | 是 | 获取客户端源 IP 的方法,为空代表关闭,支持取值:
| ProxyProtocolV1 |
Region | string | 是 | 选择终端节点组回源区域,包括:CN_North 。CN_NorthEast、 CN_North、 CN_East、CN_South、CN_Central、CN_NorthWest、CN_SouthWest、AP1。 | CN_Nrorth |
HealthyConfig | array of HealthyConfig | 否 | 健康检查相关配置。 | 见 HealthyConfig |
VolcRegionId | string | 否 | 后端服务部署在火山引擎时,所在的火山地域的 ID。更多信息参见云服务器地域和可用区 | cn-beijing |
EndpointConfigurations | array of EndpointConfiguration | 是 | 配置终端节点。 | 见 EndpointConfiguration |
TrafficPercentage | string | 是 | 终端节点组的流量调配比例,范围为1-100。 | 1 |
HealthyConfig
参数 | 类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
HealthCheckEnable | bool | 是 | 是否开启健康检查,默认不开启,支持取值:
| true |
HealthCheckProtocol | string | 否 | 健康检查协议,当前默认支持TCP协议。 | TCP |
HealthCheckPort | int | 是 | 健康检查端口,开启健康检查后必选字段,端口输入范围为1~65535。 | 22 |
HealthResponseTimeOut | int | 否 | 响应超时时间,默认3s,不支持修改。 | 3 |
HealthCheckInterval | int | 否 | 健康检查时间间隔,开启健康检查后必选字段,输入范围为1~50秒,默认为2秒。 | 2 |
HealthyThreshold | int | 否 | 健康检查健康阈值,即针对健康检查变化所需要的连续健康检查次数,开启健康检查后必选字段,输入范围2~10,默认为3次。 | 3 |
EndpointConfiguration
参数 | 类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
Type
| string
| 是 | 终端节点类型 。
| IP |
Endpoint | string | 否 | 终端节点服务地址。 | 1.1.1.1 |
Weight | int | 是 | 终端节点的流量分配权重,范围为1-100。 | 20 |
VolcResourceId | string | 否 | 后端服务部署在火山引擎时,可填写资源 ID,填写后无需填写 Endpoint。 | eip-gdhsahg |
POST https://open.volcengineapi.com/?Version=2022-03-01&Action=UpdateEndpointGroup&<其他公共请求参数> { "EndpointGroupId": "endpointgroup-SrepziDuvvxyHkWkgjvn5Y", "ListenerId": "listener-yrGx4hbk8kUjENhWtRqKnP", "Name": "mashuo测试", "IsVolcSource": false, "Region": "CN_North", "TrafficPercentage": 100, "KeepClientIP": true, "HealthyConfig": { "HealthCheckEnable": false }, "KeepClientIPMethod": "ProxyProtocolV1", "EndpointConfigurations": [ { "Type": "IP", "Endpoint": "1.1.1.1", "Weight": 20 } ] }