服务发布点

更新时间：2024-01-11

获取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进行配置，具体配置方法如下：

String ak = "Your Ak";
String sk = "Your Sk";
String endpoint = "blb.bj.baidubce.com";

BceClientConfiguration config = new BceClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
config.setEndpoint(endpoint);
UserserviceClient userserviceClient = new UserserviceClient(config);

创建服务发布点

函数声明

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

参数含义

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

返回值

操作成功

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

操作失败

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

代码示例

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

更新服务发布点

函数声明

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

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

服务发布点绑定实例

函数声明

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

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

服务发布点解绑实例

函数声明

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

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

新增服务发布点鉴权信息

函数声明

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

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

修改服务发布点鉴权信息

函数声明

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

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

删除服务发布点鉴权信息

函数声明

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

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

查询服务发布点列表

函数声明

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

参数含义

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

返回值

操作成功

{
    "metadata":具体信息参考附录metadata部分,
    "services": [
        {
            "serviceId': "uservice-a223vc",
            "name": "name",
            "description": "",
            "serviceName": "serviceName",
            "bindType": "blb",
            "instanceId": "lb-d3e2cf75",
            "status": "inService",
            "service": "xxx.baidubce.com",
            "createTime": "2019-03-07T02:35:31Z",
            "endpointCount": 1,
            "endpointList": [
                {
                    "endpointId': "endpoint-a223vc",
                    "uid': "e8deba4d81d3435bb4591ce97288f296",
                    "attachTime': "2019-03-07T02:35:31Z",
                }
            ],
            "authList": [
                {
                    "uid": "*",
                    "auth" : "allow"
                }
            ]
            
        }
    ],
    "marker": "uservice-a032va",
    "nextMarker": null,
    "isTruncated": false,
    "maxKeys": 100
}

操作失败

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

代码示例

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

查询服务发布点详情

函数声明

public GetUserServiceResponse getUserService(String service) {
}

参数含义

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

返回值

操作成功

{
    "metadata":具体信息参考附录metadata部分,
    "serviceId': "uservice-a223vc",
    "name": "name",
    "description": "",
    "serviceName": "serviceName",
    "bindType": "blb",
    "instanceId": "lb-d3e2cf75",
    "status": "inService",
    "service": "xxx.baidubce.com",
    "createTime": "2019-03-07T02:35:31Z",
    "endpointCount": 1,
    "endpointList": [
        {
            "endpointId': "endpoint-a223vc",
            "uid': "e8deba4d81d3435bb4591ce97288f296",
            "attachTime': "2019-03-07T02:35:31Z",
        }
    ],
    "authList": [
        {
            "uid": "*",
            "auth" : "allow"
        }
    ]
}

操作失败

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

代码示例

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

删除服务发布点

函数声明

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

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

附录

公共返回信息metadata格式

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

负载均衡专属集群LBDC

版本更新说明

百度智能云

负载均衡 BLB

负载均衡 BLB

服务发布点

获取Endpoint

获取AK/SK

新建UserserviceClient

创建服务发布点

更新服务发布点

服务发布点绑定实例

服务发布点解绑实例

新增服务发布点鉴权信息

修改服务发布点鉴权信息

删除服务发布点鉴权信息

查询服务发布点列表

查询服务发布点详情

删除服务发布点

附录