创建IP组协议
更新时间：2026-07-15
接口描述
为指定应用型负载均衡实例的IP组创建后端策略。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/appblb/{blbId}/ipgroup/backendpolicy?clientToken={clientToken} HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4 {
5 "ipGroupId":ipGroupId,
6 "type":type,
7 "healthCheck":healthCheck,
8 "healthCheckPort":healthCheckPort,
9 "healthCheckUrlPath":healthCheckUrlPath,
10 "healthCheckTimeoutInSecond":healthCheckTimeoutInSecond,
11 "healthCheckIntervalInSecond":healthCheckIntervalInSecond,
12 "healthCheckDownRetry":healthCheckDownRetry,
13 "healthCheckUpRetry":healthCheckUpRetry,
14 "healthCheckNormalStatus":healthCheckNormalStatus,
15 "healthCheckHost":healthCheckHost,
16 "udpHealthCheckString":udpHealthCheckString
17 }请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| blbId | String | 是 | URL参数 | 所属LoadBalancer的标识符 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串 |
| ipGroupId | String | 是 | RequestBody参数 | 所属IP组的标识符 |
| type | String | 是 | RequestBody参数 | IP组开放协议类型，"TCP"/"HTTP"/"HTTPS"/"UDP" |
| healthCheck | String | 否 | RequestBody参数 | 健康检查类型，默认与IP组协议类型相同，"TCP"/"HTTP"/"UDP"/"ICMP"/"HTTPS"监听端口协议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参数 | 健康检查端口，IP组协议为HTTP协议时必传 |
| 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
1POST /v1/appblb/lb-a7942975/ipgroup/backendpolicy HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "ipGroupId":"ip_group-45661177",
7 "type":"TCP",
8 "healthCheck":"TCP",
9 "healthCheckTimeoutInSecond": 2,
10 "healthCheckDownRetry": 3,
11 "healthCheckUpRetry": 3,
12 "healthCheckIntervalInSecond":3
13 }返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Tus, 14 Jul 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS评价此篇文章