网络探测
获取Endpoint
在确认您使用SDK配置Endpoint时,可先阅读开发人员指南中关于 VPC服务域名的部分,理解Endpoint相关的概念。 百度智能云目前开放了多区域支持,请参考区域选择说明中网络产品VPC的部分,网络探测服务是VPC服务的一部分,使用VPC服务域名。
获取AK/SK
要使用百度云产品,您需要拥有一个百度云账号和一个有效的 AK(Access Key ID)、SK(Secret Access Key)用来进行签名认证。可以通过如下步骤获得并了解您的AK/SK信息:
新建ProbeClient
ProbeClient是网络探测服务的客户端,为开发者与网络探测服务进行交互提供了一系列的方法。新建ProbeClient时,需要先使用Endpoint、AK、SK对BceClientConfiguration类型的config实例进行配置,再使用config实例对ProbeClient进行配置,具体配置方法如下:
1static final String HOST = "";
2static final String AK = "";
3static final String SK = "";
4BceClientConfiguration config = new BceClientConfiguration();
5config.setCredentials(new DefaultBceCredentials(ak, sk));
6config.setEndpoint(endpoint);
7ProbeClient probeClient = new ProbeClient(config);
创建网络探测
函数声明
1public CreateProbeResponse createProbe(CreateProbeRequest request)
2 ......
3}
参数含义
请参考OpenAPI文档:创建网络探测请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "probeId": "probe-s2kyrsdnvk287ziu"
4}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCreateProbe.java
查询网络探测列表
函数声明
1public ListProbeResponse listProbes(ListProbeRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询网络探测列表请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "nextMarker": "probe-68sfxk5ihf85hjs",
4 "marker": "probe-6gfqbgfypumvmyh0",
5 "maxKeys": 1,
6 "isTruncated": true,
7 "probes": [
8 {
9 "description":"dsdsds",
10 "destIp":"1.2.3.4",
11 "destPort":11,
12 "frequency":20,
13 "name":"probe1",
14 "payload":"qqqqqqwwwww",
15 "probeId":"probe-6gfqbgfypumvmyh0",
16 "protocol":"UDP",
17 "sourceIps":[
18 "192.168.0.4"
19 ],
20 "status":"active",
21 "subnetId":"sbn-qz55vemw0n40",
22 "vpcId":"vpc-2pa2x0bjt26i"
23 }
24 ]
25}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleListProbe.java
查询网络探测详情
函数声明
1public GetProbeResponse getProbe(String probeId) {
2 ......
3}
参数含义
请参考OpenAPI文档:查询网络探测详情请求参数
返回值
- 操作成功
1{
2 "metadata":具体信息参考附录metadata部分,
3 "probeId":"probe-6gfqbgfypumvmyh0",
4 "description":"dsdsds",
5 "destIp":"1.2.3.4",
6 "destPort":11,
7 "frequency":20,
8 "name":"probe1",
9 "payload":"qqqqqqwwwww",
10 "protocol":"UDP",
11 "sourceIps":[
12 "192.168.0.4"
13 ],
14 "status":"active",
15 "subnetId":"sbn-qz55vemw0n40",
16 "vpcId":"vpc-2pa2x0bjt26i"
17}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleGetProbe.java
更新网络探测
函数声明
1public void updateProbe(UpdateProbeRequest request) {
2 ......
3}
参数含义
请参考OpenAPI文档:更新网络探测请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleUpdateProbe.java
删除网络探测
函数声明
1// 不指定clientToken删除网络探测,不支持幂等
2public void deleteProbe(String probeId) {
3 ......
4}
5// 指定clientToken删除网络探测,支持幂等
6public void deleteProbe(String probeId, String clientToken) {
7 ......
8}
参数含义
请参考OpenAPI文档:删除网络探测请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDeleteProbe.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 }