服务发布点
获取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进行配置,具体配置方法如下:
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);
创建服务发布点
函数声明
1public CreateUserServiceResponse createUserService(CreateUserServiceRequest body, String clientToken) {
2}
参数含义
请参考OpenAPI文档 创建服务发布点请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "service" : "testService.uservice-3a76ed46.beijing.baidubce.com"
4}
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleCreateUserService.java
更新服务发布点
函数声明
1public void updateUserService(String service, UpdateUserServiceRequest body, String clientToken) {
2}
参数含义
请参考OpenAPI文档 更新服务发布点请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleUpdateUserService.java
服务发布点绑定实例
函数声明
1public void bindInstance(String service, BindInstanceRequest body, String clientToken) {
2}
参数含义
请参考OpenAPI文档 服务发布点绑定实例请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleBindInstance.java
服务发布点解绑实例
函数声明
1public void unbindInstance(String service, String clientToken) {
2}
参数含义
请参考OpenAPI文档 服务发布点解绑实例请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleUnbindInstance.java
新增服务发布点鉴权信息
函数声明
1public void addAuth(String service, AddAuthRequest body, String clientToken) {
2}
参数含义
请参考OpenAPI文档 新增服务发布点鉴权信息请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleAddAuth.java
修改服务发布点鉴权信息
函数声明
1public void editAuth(String service, EditAuthRequest body, String clientToken) {
2}
参数含义
请参考OpenAPI文档 修改服务发布点鉴权信息请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleEditAuth.java
删除服务发布点鉴权信息
函数声明
1public void removeAuth(String service, RemoveAuthRequest body, String clientToken) {
2}
参数含义
请参考OpenAPI文档 删除服务发布点鉴权信息请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleRemoveAuth.java
查询服务发布点列表
函数声明
1public ListUserServiceResponse listUserService(String marker, Integer maxKeys) {
2}
参数含义
请参考OpenAPI文档 查询服务发布点列表请求参数
返回值
- 操作成功
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
查询服务发布点详情
函数声明
1public GetUserServiceResponse getUserService(String service) {
2}
参数含义
请参考OpenAPI文档 查询服务发布点详情请求参数
返回值
- 操作成功
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
删除服务发布点
函数声明
1public void deleteUserService(String service, String clientToken) {
2}
参数含义
请参考OpenAPI文档 删除服务发布点请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考负载均衡BLB异常列表
代码示例
具体代码示例参考:ExampleDeleteUserService.java
附录
公共返回信息metadata格式
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 }