负载均衡BLB

    应用型BLB服务器组相关接口

    CreateaAppServerGroup创建应用型服务器组

    • 在指定应用型BLB下,创建一个服务器组,用来绑定后端服务器,以及为监听器开放相应的端口

    请求结构

    POST /v{version}/appblb/{blbId}/appservergroup?clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "name":name,
        "desc":desc,
        "backendServerList": [
            {
                "instanceId": instanceId,
                "weight": weight
            },
            {
                "instanceId": instanceId,
                "weight": weight
            }
        ]
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    clientToken String Query参数 幂等性Token,长度不超过64位
    name String RequestBody参数 服务器组的名称,方便记忆。长度1~65个字节,字母开头,_可包含字母数字-/.字符。若不传该参数,会自动生成
    desc String RequestBody参数 服务器组的描述,便于用户添加更详细的描述信息。长度0~450个字节,支持中文。默认为空。
    backendServerList List<AppBackendServer> RequestBody参数 服务器组绑定的后端服务器列表

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    id String 服务器组id
    name String 服务器组的名称
    desc String 服务器组的描述
    status String 服务器组状态,详见blbStatus

    请求示例

    POST /v1/appblb/lb-j8UqijYf/appservergroup?clientToken=asdfg HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "name": "name1",
        "desc": "aaa",                         
        "backendServerList":[                    
            {
                "instanceId": "BCC_UUID",       
                "weight": 20
            }
        ]
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    {
        "id": "sg_short_id",
        "name": "name",
        "desc": "aaa",
        "status": "available"                 
    }

    UpdateAppServerGroup更新服务器组

    • 更新指定LoadBalancer下的TCP监听器参数,所有请求参数中指定的域都会被更新,未指定的域保持不变,监听器通过端口指定。

    请求结构

    PUT /v{version}/appblb/{blbId}/appservergroup?clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId":sgId,
        "name":name,
        "desc":desc
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 要更新的服务器组的id
    name String RequestBody参数 服务器组的名称,方便记忆。长度1~65个字节,字母开头,可包含字母数字-_/.字符。若不传该参数,会自动生成
    desc String RequestBody参数 服务器组的描述,便于用户添加更详细的描述信息。长度0~450个字节,支持中文。默认为空

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    请求示例

    PUT /v1/appblb/lb-j8UqijYf/appservergroup?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "sgId": "sgId",
        "name": "name1",
        "desc": "aaa"
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    DescribeAppServerGroup查询服务器组

    • 查询指定LoadBalancer下所有服务器组的信息
    • 结果支持marker分页,分页大小默认为1000,可通过maxKeys参数指定

    请求结构

    GET /v{version}/appblb/{blbId}/appservergroup?name={name}&marker={marker}&maxKeys={maxKeys}&exactlyMatch={exactlyMatch} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    name String Query参数 要查询的服务器组名称
    exactlyMatch boolean Query参数 设置name是否全局匹配
    marker String Query参数 批量获取列表的查询的起始位置,是一个由系统生成的字符串
    maxKeys int Query参数 每页包含的最大数量,最大数量不超过1000。缺省值为1000

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    appServerGroupList List<AppServerGroup> 包含查询结果的列表
    marker String 标记查询的起始位置,若结果列表为空,此项不存在
    isTruncated boolean true表示后面还有数据,false表示已经是最后一页
    nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现
    maxKeys int 每页包含的最大数量

    请求示例

    GET /v1/appblb/lb-j8UqijYf/appservergroup?maxKeys=2 HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/ae4780f344774daa832f34caadd4d7de/2016-06-03T06:42:31Z/1800/host/3f26e5a322d41fa0f3315e906342c2691fe5ee35d21c7e66e425b4ee0f67ced3

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Fri, 03 Jun 2016 06:42:44 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    
    {
        "appServerGroupList":[
        {
            "id": "sg_short_id",
            "name": "name",
            "desc": "bbb",
            "status": "available",
            "portList":
            [{
                "id": "port_id"
                "port": BACKEND_PORT,
                "type": "TCP",
                "healthCheck": "TCP",
                "healthCheckNormalStatus": "^[1-5][0-9]*$",
                "healthCheckPort": 90,
                "healthCheckTimeoutInSecond": 2,
                "healthCheckDownRetry": 3,
                "healthCheckUpRetry": 3,
                "healthCheckIntervalInSecond": 1,
                "healthCheckUrlPath": "HEALTH_CHECK_URL_PATH",
                "healtchCheckHost": www.xxx,                         
                "status": "available"                   
            }]
        }
             ],
        "marker": "sg-012310",         
        "isTruncated": false,
        "maxKeys": 1000,
        "nextMarker": "sg-013214"      
    }

    DeleteAppServerGroup删除服务器组

    • 删除服务器组,通过服务器组id指定

    请求结构

    PUT /v{version}/appblb/{blbId}/appservergroup?{action}&clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId": sgId 
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    action String Query参数 必须为delete
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 要删除的服务器组id

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    请求示例

    PUT /v1/appblb/lb-j8UqijYf/appservergroup?delete&clientToken=be31b98c-5e41-4838-9830-9be700de5a20
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/ae4780f344774daa832f34caadd4d7de/2016-06-03T03:26:45Z/1800/host/c863c8b9f75ff307eb1a3c564307b0833acb9d857c65de108258c3edd4cd0118
    
    {
        "sgId":"abc"
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Fri, 03 Jun 2016 03:54:29 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    CreateAppServerGroupPort创建应用型服务器组端口

    • 在指定应用型BLB下,创建一个服务器组后端端口,将发往该端口的所有流量按权重轮询分发到其绑定的对应服务器列表中的服务器

    请求结构

    POST /v{version}/appblb/{blbId}/appservergroupport?clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId":sgId,
        "port":port,
        "type":type,
        "healthCheck":healthCheck,
        "healthCheckPort":healthCheckPort,
        "healthCheckUrlPath":healthCheckUrlPath,
        "healthCheckTimeoutInSecond":healthCheckTimeoutInSecond,
        "healthCheckIntervalInSecond":healthCheckIntervalInSecond,
        "healthCheckDownRetry":healthCheckDownRetry,
        "healthCheckUpRetry":healthCheckUpRetry,
        "healthCheckNormalStatus":healthCheckNormalStatus
        "udpHealthCheckString":udpHealthCheckString
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 端口所属服务器组标识符
    port int RequestBody参数 端口号,需为1-65535间的整数
    type String RequestBody参数 监听端口的协议类型,"TCP"/"UDP"/"HTTP"
    healthCheck String RequestBody参数 健康检查协议,支持"HTTP"/"TCP"/"UDP", TCP默认TCP,UDP默认UDP,HTTP默认HTTP
    healthCheckPort int RequestBody参数 健康检查端口,默认为port的取值
    healthCheckUrlPath String RequestBody参数 健康检查URI,默认/。当健康检查协议为"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|http_2xx",默认"http_2xx|http_3xx"。当健康检查协议为"HTTP"时生效
    udpHealthCheckString String RequestBody参数 UDP服务的健康检查字段。如果type为"UDP"时,则必传

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    id String 服务器组端口id
    status String 服务器组端口状态,详见blbStatus

    请求示例

    POST /v1/appblb/lb-j8UqijYf/appservergroupport?clientToken=asdfg HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "sgId":"sgid",
        "type":"TCP",
        "port": 80,
        "healthCheck":"TCP",                     
        "healthCheckPort": 90,                              
        "healthCheckTimeoutInSecond": 2,                    
        "healthCheckDownRetry": 3,                          
        "healthCheckUpRetry": 3,                            
        "healthCheckIntervalInSecond":3                   
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    {
        "id": "sg_port_id",
        "status": "available"                 
    }

    UpdateAppServerGroupPort更新服务器组端口

    • 根据id更新服务器组端口。

    请求结构

    PUT /v{version}/appblb/{blbId}/appservergroupport?clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId":sgId,
        "portId":portId,
        "healthCheck":healthCheck,
        "healthCheckPort":healthCheckPort,
        "healthCheckUrlPath":healthCheckUrlPath,
        "healthCheckTimeoutInSecond":healthCheckTimeoutInSecond,
        "healthCheckIntervalInSecond":healthCheckIntervalInSecond,
        "healthCheckDownRetry":healthCheckDownRetry,
        "healthCheckUpRetry":healthCheckUpRetry,
        "healthCheckNormalStatus":healthCheckNormalStatus,
        "udpHealthCheckString":udpHealthCheckString
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 端口所属服务器组标识符
    portId String RequestBody参数 要更新的服务器组端口的标识符
    healthCheck String RequestBody参数 健康检查协议,支持"HTTP"/"TCP"/"UDP", TCP默认TCP,UDP默认UDP,HTTP默认HTTP
    healthCheckPort int RequestBody参数 健康检查端口,默认为port的取值
    healthCheckUrlPath String RequestBody参数 健康检查URI,默认/。当健康检查协议为"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|http_2xx",默认"http_2xx|http_3xx"。当健康检查协议为"HTTP"时生效
    udpHealthCheckString String RequestBody参数 UDP服务的健康检查字段。如果type为"UDP"时,则必传

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    请求示例

    PUT /v1/appblb/lb-j8UqijYf/appservergroupport?clientToken=abc HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "sgId":“abc”,
        "portId":"dbd",
        "healthCheck":"TCP",                     
        "healthCheckPort": 90,
        "healthCheckTimeoutInSecond": 2,
        "healthCheckDownRetry": 3,
        "healthCheckUpRetry": 3,
        "healthCheckIntervalInSecond": 1 
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    DeleteAppServerGroupPort删除服务器组端口

    • 删除服务器组端口,通过服务器组id指定

    请求结构

    PUT /v{version}/appblb/{blbId}/appservergroupport?{action}&clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId": sgId,
        "portIdList":[portid1,portid2] 
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    action String Query参数 必须为batchdelete
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 要删除的端口所在服务器组id
    portIdList List\<String> RequestBody参数 所有待释放的端口id,一起组成一个数组

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    请求示例

    PUT /v1/appblb/lb-j8UqijYf/appservergroupport?batchdelete&clientToken=asdfg
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/ae4780f344774daa832f34caadd4d7de/2016-06-03T03:26:45Z/1800/host/c863c8b9f75ff307eb1a3c564307b0833acb9d857c65de108258c3edd4cd0118
    
    {
        "sgId":"abc",
        "portIdList":["a","b"]
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Fri, 03 Jun 2016 03:54:29 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    CreateBlbRs添加应用型BLB后端RS

    • 在指定应用型BLB和服务器组下绑定后端服务器RS

    请求结构

    POST /v{version}/appblb/{blbId}/blbrs?clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId":sgId,
        "backendServerList": [
            {
                "instanceId": instanceId,
                "weight": weight
            },
            {
                "instanceId": instanceId,
                "weight": weight
            }
            
        ]
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 RS所属服务器组id
    backendServerList List<AppBackendServer> RequestBody参数 后端服务器列表

    成功返回200,失败返回见错误码

    返回状态码

    成功返回200,失败返回见错误码 返回头域

    除公共头域外,无其他特殊头域

    返回参数

    请求示例

    POST /v1/appblb/lb-j8UqijYf/blbrs?clientToken=asdfg HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "sgId": "sg-db3975dc",                          
        "backendServerList":[                    
            {
                "instanceId": "i-b3Dq3ea3",       
                "weight": 20
            }
        ]
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    UpdateBlbRs更新服务器组下挂载的RS权重

    • 更新指定服务器组下的RS信息

    请求结构

    PUT /v{version}/appblb/{blbId}/blbrs?clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId": sgId,                          
        "backendServerList":[                    
            {
                "instanceId": instanceId,     
                "weight": weight
            }
        ]
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 RS所属服务器组id
    backendServerList List<AppBackendServer> RequestBody参数 后端服务器列表

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    请求示例

    PUT /v1/appblb/lb-j8UqijYf/blbrs?clientToken=asdfg  HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    
    {
        "sgId": "sg-db3975dc",                          
        "backendServerList":[                    
            {
                "instanceId": "i-b3Dq3ea3",       
                "weight": 20
            }
        ]
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    DescribeBlbRs查询服务器组下的RS列表信息

    • 查询指定LoadBalancer下所有服务器组的信息
    • 支持按监听器端口进行匹配查询
    • 结果支持marker分页,分页大小默认为1000,可通过maxKeys参数指定

    请求结构

    GET /v{version}/appblb/{blbId}/blbrs?marker={marker}&maxKeys={maxKeys}&sgId={sgId} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    sgId String Query参数 RS所属服务器组id
    marker String Query参数 批量获取列表的查询的起始位置,是一个由系统生成的字符串
    maxKeys int Query参数 每页包含的最大数量,最大数量不超过1000。缺省值为1000

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    backendServerList List<AppBackendServer> 包含查询结果的列表
    marker String 标记查询的起始位置,若结果列表为空,此项不存在
    isTruncated boolean true表示后面还有数据,false表示已经是最后一页
    nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现
    maxKeys int 每页包含的最大数量

    请求示例

    GET /v1/appblb/lb-j8UqijYf/blbrs?maxKeys=2&sgId=sg-db3975dc HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/ae4780f344774daa832f34caadd4d7de/2016-06-03T06:42:31Z/1800/host/3f26e5a322d41fa0f3315e906342c2691fe5ee35d21c7e66e425b4ee0f67ced3

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Fri, 03 Jun 2016 06:42:44 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    
    {
        "marker": "rs-012310",          
        "isTruncated": false,
        "maxKeys": 1000,
        "nextMarker": "rs-013214",      
        "backendServerList": [
        {
            "instanceId": "BCC_UUID",
            "privateIp": "192.168.0.1",              
            "weight": "WEIGHT",
            "portList": [                            
            {
                "listenerPort": "LISTENER_PORT1",
                "backendPort": "BACKEND_PORT1",
                "portType": "HTTP",
                “healthCheckPortType”: "HTTP",
                "portId": "port_xxx",             
                "policyId": "policy_xxx",             
                "status": "Alive"
            },
            {
                "listenerPort": "LISTENER_PORT2",
                "backendPort": "BACKEND_PORT2",
                "portType": "HTTP",
                “healthCheckPortType”: "HTTP",
                "portId": "port_xxx",             
                "policyId": "policy_xxx",             
                "staus": "Alive"
            }
            ]
        }
        ]
    }

    DeleteBlbRs删除服务器组下挂载的rs

    • 删除服务器组,通过服务器组id指定

    请求结构

    PUT /v{version}/appblb/{blbId}/blbrs?{action}&clientToken={clientToken} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string
    
    {
        "sgId": sgId,
         backendServerIdList: ["Serverid1", "Serverid2", "Serverid3"]
    }

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    action String Query参数 描述要进行的操作,本接口取batchdelete
    clientToken String Query参数 幂等性Token,长度不超过64位
    sgId String RequestBody参数 要删除的RS所属服务器组id
    backendServerIdList List\<String> RequestBody参数 所有待释放的后端服务器标识符,一起组成一个数组

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    请求示例

    PUT /v1/appblb/lb-j8UqijYf/blbrs?batchdelete&clientToken=be31b98c-5e41-4838-9830-9be700de5a20
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/ae4780f344774daa832f34caadd4d7de/2016-06-03T03:26:45Z/1800/host/c863c8b9f75ff307eb1a3c564307b0833acb9d857c65de108258c3edd4cd0118
    
    {
        "sgId":"abc",
        "backendServerIdList": ["ab48bbe", "2520741", "a78e04"]
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Fri, 03 Jun 2016 03:54:29 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    DescribeRsMount查询服务器组下绑定的server

    • 查询服务器组下绑定的server

    请求结构

    GET /v{version}/appblb/{blbId}/blbrsmount?sgId={sgId} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    sgId String Query参数 RS所属服务器组id

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    backendServerList List<AppBackendServer> 包含查询结果的列表

    请求示例

    GET /v1/appblb/lb-j8UqijYf/blbrsmount?sgId=abc HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/ae4780f344774daa832f34caadd4d7de/2016-06-03T06:42:31Z/1800/host/3f26e5a322d41fa0f3315e906342c2691fe5ee35d21c7e66e425b4ee0f67ced3

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Fri, 03 Jun 2016 06:42:44 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    
    {     
        "backendServerList": [
        {
            "instanceId": "BCC_UUID",
            "privateIp": "192.168.0.1",              
            "weight": "WEIGHT",
            "portList": [                            
            {
                "listenerPort": "LISTENER_PORT1",
                "backendPort": "BACKEND_PORT1",
                "portType": "HTTP",
                “healthCheckPortType”: "HTTP",
                "portId": "port_xxx",             
                "policyId": "policy_xxx",             
                "status": "Alive"
            },
            {
                "listenerPort": "LISTENER_PORT2",
                "backendPort": "BACKEND_PORT2",
                "portType": "HTTP",
                “healthCheckPortType”: "HTTP",
                "portId": "port_xxx",             
                "policyId": "policy_xxx",             
                "staus": "Alive"
            }
            ]
        }
        ]
    }

    DescribeRsUnMount查询服务器组下未绑定的RS

    • 查询服务器组下未绑定的RS

    请求结构

    GET /v{version}/appblb/{blbId}/blbrsunmount?sgId={sgId} HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其他特殊头域

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号,当前取值1
    blbId String URL参数 所属LoadBalancer的标识符
    sgId String Query参数 RS所属服务器组id

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    backendServerList List<AppBackendServer> 包含查询结果的列表

    请求示例

    GET /v1/appblb/lb-j8UqijYf/blbrsunmount?sgId=abc HTTP/1.1
    Host: blb.bj.baidubce.com
    Authorization: bce-auth-v1/ae4780f344774daa832f34caadd4d7de/2016-06-03T06:42:31Z/1800/host/3f26e5a322d41fa0f3315e906342c2691fe5ee35d21c7e66e425b4ee0f67ced3

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Fri, 03 Jun 2016 06:42:44 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    
    {     
        "backendServerList": [
        {
            "instanceId": "BCC_UUID",
            "privateIp": null,              
            "weight": null,
            "portList": []
        }
        ]
    }
    上一篇
    应用型BLB监听器相关接口
    下一篇
    附录