网络探测
获取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进行配置,具体配置方法如下:
static final String HOST = "";
static final String AK = "";
static final String SK = "";
BceClientConfiguration config = new BceClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
config.setEndpoint(endpoint);
ProbeClient probeClient = new ProbeClient(config);
创建网络探测
函数声明
public CreateProbeResponse createProbe(CreateProbeRequest request)
......
}
参数含义
请参考OpenAPI文档:创建网络探测请求参数
返回值
- 操作成功
{
"metadata":具体信息参考附录metadata部分,
"probeId": "probe-s2kyrsdnvk287ziu"
}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleCreateProbe.java
查询网络探测列表
函数声明
public ListProbeResponse listProbes(ListProbeRequest request) {
......
}
参数含义
请参考OpenAPI文档:查询网络探测列表请求参数
返回值
- 操作成功
{
"metadata":具体信息参考附录metadata部分,
"nextMarker": "probe-68sfxk5ihf85hjs",
"marker": "probe-6gfqbgfypumvmyh0",
"maxKeys": 1,
"isTruncated": true,
"probes": [
{
"description":"dsdsds",
"destIp":"1.2.3.4",
"destPort":11,
"frequency":20,
"name":"probe1",
"payload":"qqqqqqwwwww",
"probeId":"probe-6gfqbgfypumvmyh0",
"protocol":"UDP",
"sourceIps":[
"192.168.0.4"
],
"status":"active",
"subnetId":"sbn-qz55vemw0n40",
"vpcId":"vpc-2pa2x0bjt26i"
}
]
}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleListProbe.java
查询网络探测详情
函数声明
public GetProbeResponse getProbe(String probeId) {
......
}
参数含义
请参考OpenAPI文档:查询网络探测详情请求参数
返回值
- 操作成功
{
"metadata":具体信息参考附录metadata部分,
"probeId":"probe-6gfqbgfypumvmyh0",
"description":"dsdsds",
"destIp":"1.2.3.4",
"destPort":11,
"frequency":20,
"name":"probe1",
"payload":"qqqqqqwwwww",
"protocol":"UDP",
"sourceIps":[
"192.168.0.4"
],
"status":"active",
"subnetId":"sbn-qz55vemw0n40",
"vpcId":"vpc-2pa2x0bjt26i"
}
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleGetProbe.java
更新网络探测
函数声明
public void updateProbe(UpdateProbeRequest request) {
......
}
参数含义
请参考OpenAPI文档:更新网络探测请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleUpdateProbe.java
删除网络探测
函数声明
// 不指定clientToken删除网络探测,不支持幂等
public void deleteProbe(String probeId) {
......
}
// 指定clientToken删除网络探测,支持幂等
public void deleteProbe(String probeId, String clientToken) {
......
}
参数含义
请参考OpenAPI文档:删除网络探测请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考:异常列表
示例代码
具体代码示例参考:ExampleDeleteProbe.java
附录
公共返回信息metadata格式
{
"bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
"contentLength":28,
"contentType":"application/json;charset=UTF-8",
"date":1701917695000,
"server":"openresty/1.15.8.1"
}