查询设备网络检测任务的结果
调用该接口查询设备网络检测任务的结果。接口仅限于客户端网络问题排查的低频场景使用,不能用于其他产品功能。
路径 | /vision/customer/network/detect/get |
版本号 | 1.0.0 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
iotId | String | 是 | bZGD54swRgqo8d******000101 | 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。 |
networkDetectType | Int | 是 | 1 | 网络检测类型。1:端口连通性;2:MTU;4:网络带宽;8:网络延时。 |
networkDetectTaskId | String | 是 | 4ece4c9f01ce40c89e8d5d418dfa**** | 设备网络检测任务ID。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
code | Int | 接口返回码。200表示成功。 |
|
message | String | 调用失败时,返回的出错信息。 |
|
localizedMsg | String | 本地语言的错误消息。 |
|
data | JSON | 响应结果。 |
|
networkDetectType | Int | 网络检测类型。1: 端口连通性;2: MTU;4: 网络带宽;8: 网络延时。 |
|
networkDetectTaskId | String | 网络检测任务ID。 |
|
createTime | Long | 网络检测任务创建时间。 |
|
status | String | 任务状态。RUNNING:运行中;FAIL:失败;SUCCESS:成功。 |
|
result | String | 任务执行结果描述。 |
|
portResult | JSON | 端口检测结果。 |
|
ip | String | 服务IP。 |
|
port | Int | 服务端口。 |
|
reachable | Boolean | 是否可连接。 |
|
mtuResult | JSON | MTU检测结果。 |
|
ip | String | 服务IP。 |
|
mtu | Int | MTU大小。 |
|
bandwidthResult | JSON | 网络带宽检测结果。 |
|
uploadSpeed | JSON | 网络上传速度。单位Mbps。 |
|
downloadSpeed | JSON | 网络下载速度。单位Mbps。 |
|
pingResult | JSON | 网络延时检测结果。 |
|
ip | String | 服务IP。 |
|
delay | JSON | 网络延时。单位ms。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.0",
"iotToken": "token"
},
"params":{
"iotId": "bZGD54swRgqo8d******000101",
"networkDetectType":1,
"networkDetectTaskId": "4ece4c9f01ce40c89e8d5d418dfa****"
}
}
正常返回示例
JSON
格式
{
"id": "4de2c367-c1db-417c-aa15-8c585e595d92",
"code": 200,
"message": null,
"localizedMsg": null,
"data": {
"networkDetectType": 1,
"networkDetectTaskId": "cef5e617-2ed9-4bdd-9de2-f01df59805cd",
"craeteTime": 1644478817,
"status": "RUNNING",
"result": "",
"portResult": [],
"mtuResult": [],
"bandwidthResult": {},
"pingResult": []
}
}
异常返回示例
JSON
格式
{
"id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
"code": 403,
"message": "request forbidden.",
"localizedMsg": "请求被禁止",
"data": null
}