所有文档

没有找到结果，请重新输入

负载均衡 BLB

服务发布点

更新时间：2025-08-21

获取Endpoint

在确认您使用SDK配置的Endpoint时，可先阅读开发人员指南中关于服务发布点服务域名的部分，理解Endpoint相关的概念。百度智能云目前开放了多区域支持，请参考区域选择说明中网络产品服务发布点的部分。

注意：服务发布点 API支持HTTP和HTTPS两种调用方式。为了提升数据的安全性，建议通过HTTPS调用

获取AK/SK

要使用百度智能云服务发布点，您需要拥有一个有效的 AK（Access Key ID）和SK(Secret Access Key)用来进行签名认证。AK/SK是由系统分配给用户的，均为字符串，用于标识用户，为访问服务做签名验证。可以通过如下步骤获得并了解您的AK/SK信息：

新建UserserviceClient

UserserviceClient是服务发布点服务的客户端，为开发者与服务发布点服务进行交互提供了一系列的方法。新建UserserviceClient时，需要先使用Endpoint、AK、SK对BceClientConfigurationl类型的config实例进行配置，再使用config实例对LbdcClient进行配置，具体配置方法如下：

Plain Text

1String ak = "Your Ak";
2String sk = "Your Sk";
3String endpoint = "blb.bj.baidubce.com";
4
5BceClientConfiguration config = new BceClientConfiguration();
6config.setCredentials(new DefaultBceCredentials(ak, sk));
7config.setEndpoint(endpoint);
8UserserviceClient userserviceClient = new UserserviceClient(config);

创建服务发布点

函数声明

Plain Text

1public CreateUserServiceResponse createUserService(CreateUserServiceRequest body, String clientToken) {
2}

参数含义

请参考OpenAPI文档创建服务发布点请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "service" : "testService.uservice-3a76ed46.beijing.baidubce.com"
4}

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleCreateUserService.java

更新服务发布点

函数声明

Plain Text

1public void updateUserService(String service, UpdateUserServiceRequest body, String clientToken) {
2}

参数含义

请参考OpenAPI文档更新服务发布点请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleUpdateUserService.java

服务发布点绑定实例

函数声明

Plain Text

1public void bindInstance(String service, BindInstanceRequest body, String clientToken) {
2}

参数含义

请参考OpenAPI文档服务发布点绑定实例请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleBindInstance.java

服务发布点解绑实例

函数声明

Plain Text

1public void unbindInstance(String service, String clientToken) {
2}

参数含义

请参考OpenAPI文档服务发布点解绑实例请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleUnbindInstance.java

新增服务发布点鉴权信息

函数声明

Plain Text

1public void addAuth(String service, AddAuthRequest body, String clientToken) {
2}

参数含义

请参考OpenAPI文档新增服务发布点鉴权信息请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleAddAuth.java

修改服务发布点鉴权信息

函数声明

Plain Text

1public void editAuth(String service, EditAuthRequest body, String clientToken) {
2}

参数含义

请参考OpenAPI文档修改服务发布点鉴权信息请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleEditAuth.java

删除服务发布点鉴权信息

函数声明

Plain Text

1public void removeAuth(String service, RemoveAuthRequest body, String clientToken) {
2}

参数含义

请参考OpenAPI文档删除服务发布点鉴权信息请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleRemoveAuth.java

查询服务发布点列表

函数声明

Plain Text

1public ListUserServiceResponse listUserService(String marker, Integer maxKeys) {
2}

参数含义

请参考OpenAPI文档查询服务发布点列表请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "services": [
4        {
5            "serviceId': "uservice-a223vc",
6            "name": "name",
7            "description": "",
8            "serviceName": "serviceName",
9            "bindType": "blb",
10            "instanceId": "lb-d3e2cf75",
11            "status": "inService",
12            "service": "xxx.baidubce.com",
13            "createTime": "2019-03-07T02:35:31Z",
14            "endpointCount": 1,
15            "endpointList": [
16                {
17                    "endpointId': "endpoint-a223vc",
18                    "uid': "e8deba4d81d3435bb4591ce97288f296",
19                    "attachTime': "2019-03-07T02:35:31Z",
20                }
21            ],
22            "authList": [
23                {
24                    "uid": "*",
25                    "auth" : "allow"
26                }
27            ]
28            
29        }
30    ],
31    "marker": "uservice-a032va",
32    "nextMarker": null,
33    "isTruncated": false,
34    "maxKeys": 100
35}

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleListUserService.java

查询服务发布点详情

函数声明

Plain Text

1public GetUserServiceResponse getUserService(String service) {
2}

参数含义

请参考OpenAPI文档查询服务发布点详情请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "serviceId': "uservice-a223vc",
4    "name": "name",
5    "description": "",
6    "serviceName": "serviceName",
7    "bindType": "blb",
8    "instanceId": "lb-d3e2cf75",
9    "status": "inService",
10    "service": "xxx.baidubce.com",
11    "createTime": "2019-03-07T02:35:31Z",
12    "endpointCount": 1,
13    "endpointList": [
14        {
15            "endpointId': "endpoint-a223vc",
16            "uid': "e8deba4d81d3435bb4591ce97288f296",
17            "attachTime': "2019-03-07T02:35:31Z",
18        }
19    ],
20    "authList": [
21        {
22            "uid": "*",
23            "auth" : "allow"
24        }
25    ]
26}

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleGetUserService.java

删除服务发布点

函数声明

Plain Text

1public void deleteUserService(String service, String clientToken) {
2}

参数含义

请参考OpenAPI文档删除服务发布点请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考：ExampleDeleteUserService.java

附录

公共返回信息metadata格式

Plain Text

1 {
2      "bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
3      "contentLength":28,
4      "contentType":"application/json;charset=UTF-8",
5      "date":1701917695000,
6      "server":"openresty/1.15.8.1"
7 }

IPv6型BLB实例