更新IP组协议
更新时间：2026-07-15
更新应用型BLB IP组的后端策略，包括健康检查相关配置。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1PUT /v{version}/appblb/{blbId}/ipgroup/backendpolicy?clientToken={clientToken} HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "ipGroupId":ipGroupId,
7 "id":id,
8 "healthCheck":healthCheck
9 "healthCheckPort":healthCheckPort,
10 "healthCheckUrlPath":healthCheckUrlPath,
11 "healthCheckTimeoutInSecond":healthCheckTimeoutInSecond,
12 "healthCheckIntervalInSecond":healthCheckIntervalInSecond,
13 "healthCheckDownRetry":healthCheckDownRetry,
14 "healthCheckUpRetry":healthCheckUpRetry,
15 "healthCheckNormalStatus":healthCheckNormalStatus,
16 "healthCheckHost":healthCheckHost,
17 "udpHealthCheckString":udpHealthCheckString
18}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| blbId | String | 是 | URL参数 | 所属LoadBalancer的标识符 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串 |
| ipGroupId | String | 是 | RequestBody参数 | IP组的id |
| id | String | 是 | RequestBody参数 | IP组协议的id |
| healthCheck | String | 否 | RequestBody参数 | 健康检查协议类型(HTTPS、HTTP、TCP、UDP、ICMP)监听端口协议type和健康检查协议healthCheck对应关系如下：(type)TCP->(healthCheck)TCP(type)UDP->(healthCheck)UDP、ICMP(type)HTTP->(healthCheck)TCP、HTTP(type)HTTPS->(healthCheck)TCP、HTTP、HTTPS |
| healthCheckPort | int | 否 | RequestBody参数 | 健康检查端口 |
| healthCheckUrlPath | String | 否 | RequestBody参数 | 健康检查路径，默认/，当健康检查协议为"HTTP"时生效 |
| healthCheckTimeoutInSecond | int | 否 | RequestBody参数 | 健康检查超时（单位：秒），默认为3，需为1-60间的整数 |
| healthCheckIntervalInSecond | int | 否 | RequestBody参数 | 健康检查间隔（单位：秒），默认为3，需为1-10间的整数 |
| healthCheckDownRetry | int | 否 | RequestBody参数 | 不健康阈值，即连续多少次健康检查失败后，屏蔽该后端服务器。默认为3，需为2-5间的整数 |
| healthCheckUpRetry | int | 否 | RequestBody参数 | 健康阈值，即连续多少次健康检查成功后，重新将该后端服务器置为可用。默认为3，需为2-5间的整数 |
| healthCheckNormalStatus | String | 否 | RequestBody参数 | 健康检查正常时的HTTP状态码，支持5类状态码的组合，例如"http_1xx |
| healthCheckHost | String | 否 | RequestBody参数 | 发往后端服务器的健康检查请求的Host头域，例如"localhost"，默认为空，当健康检查协议为"HTTP"时生效 |
| udpHealthCheckString | String | 否 | RequestBody参数 | udp健康检查字符串，当健康检查协议为"UDP"时生效 |
返回头域
除公共头域，无其它特殊头域。
返回参数
无返回参数
请求示例
Plain Text
1PUT /v1/appblb/lb-a7942975/ipgroup/backendpolicy
2Host: blb.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "ipGroupId":"ip_group-45661177",
7 "id":"policy-ecef4bf0",
8 "healthCheckTimeoutInSecond": 2,
9 "healthCheckDownRetry": 3,
10 "healthCheckUpRetry": 3,
11 "healthCheckIntervalInSecond":3
12}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Thu, 16 Mar 2017 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS评价此篇文章