查询设备排障执行进度和日志
GET
/openapi/v0.9/manage/api/v1/organizations/{org_uuid}/manage-devices/cmds
es-management-service
请求参数
Path 参数
org_uuid
string
必需
Query 参数
device_sn
array[string]
必需
批量查询传参示例:url?device_sn=8xxx200&device_sn=7CTxxx0004&identifiers=device_reboot
示例值:
["8UUDxxxx00A0200"]
identifiers
string
可选
enum:
camera_photo_take: 拍照
cover_force_close:强制关舱盖
fileupload_start:发起日志文件上传
flighttask_execute:执行飞行任务
load_ai_model:装载机载AI模型
unload_ai_model:卸载机载AI模型
ota_create:固件升级
cover_close:关闭舱盖
cover_open:打开舱盖
device_reboot:机场重启
drone_close:飞行器关机
drone_open:飞行器开机
更多枚举详看:https://developer.dji.com/doc/cloud-api-tutorial/cn/api-reference/dock-to-cloud/mqtt/dock/dock3/cmd.html
中的method值
示例值:
device_reboot
Header 参数
x-user-token
string
必需
默认值:
{{x-user-token}}
X-Request-Id
string
可选
默认值:
{% mock 'uuid' %}
Body 参数application/json
object {0}
示例
{}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/openapi/v0.9/manage/api/v1/organizations//manage-devices/cmds?device_sn=8UUDxxxx00A0200&identifiers=device_reboot' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{}'
返回响应
🟢200成功
application/json
Body
HTTP响应模板
code
integer
响应码
message
string
响应消息
data
object
响应数据
list
array [object {2}]
日志列表
示例
{
"code": 0,
"message": "OK",
"data": {
"list": [
{
"sn": "7Cxxx004",
"services": {
"device_reboot": { //重启日志
"bid": "3da20dae-xxxx-91247ef8f26e", //业务id
"status": "ok", //{"canceled":"取消或终止","failed":"失败","in_progress":"执行中","ok":"执行成功","paused":"暂停","rejected":"拒绝","sent":"已下发","timeout":"超时"}
"create_time": 1750215704000,
"update_time": 1750215760000,
"progress": { //进度
"percent": 100, //进度百分比
"current_step": 0 //当前步骤
},
"device_code": 0, //错误码 非0表示错误
"ext": {} //拓展信息
},
"drone_close": { //关机日志
"bid": "81065e35-xxx-66c83dca9e9c",
"status": "failed",
"create_time": 1749199610000,
"update_time": 1749199610000,
"progress": {
"percent": 0,
"current_step": 0
},
"device_code": 514116,
"ext": {}
}
}
}
]
}
}
修改于 2025-06-27 12:01:55