设备控制权操作
POST
/openapi/v0.9/manage/api/v1/organizations/{org_uuid}/manage-devices/cmds/control
es-management-service
请求参数
Path 参数
org_uuid
string
必需
Header 参数
x-user-token
string
必需
默认值:
{{x-user-token}}
X-Request-Id
string
可选
默认值:
{% mock 'uuid' %}
Body 参数application/json
control_operation_method
string
必需
apply_control 申请控制权
apply_control_pre_preemptive_queue 申请进入控制权队列
cancel_application 取消申请控制权
approve_application 同 意抢占申请
refuse_application 拒绝抢占申请
release_control 已有控制权用户主动释放控制权
device_control_method
string
必需
required: true
example: flight_control
device_sn
string
必需
required: true
example: ABCD1234567890
pre_preemptive_queue_id
string
可选
取消申请控制权、释放控制权、拒绝释放控制权均需要携带
example: queue-123456
示例
{
"control_operation_method": "string",
"device_control_method": "string",
"device_sn": "string",
"pre_preemptive_queue_id": "string"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/openapi/v0.9/manage/api/v1/organizations//manage-devices/cmds/control' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
"control_operation_method": "string",
"device_control_method": "string",
"device_sn": "string",
"pre_preemptive_queue_id": "string"
}'返回响应
🟢200成功
application/json
Body
HTTP响应模板
code
integer
响应码
message
string
响应消息
data
object | null
响应数据
device_control_status
integer
设备状态
210241 该用户已经拥有设备控制权
210242 该用户无法抢夺控制权，但是可以进入等待队列
210243 该用户无法抢夺控制权，已经进入等待队列
210244 该用户无法抢夺控制权，也无法进入等待队列，直接拒绝
210245 该用户没有设备控制权，所以无法拒绝其他用户的抢占申请
210246 该用户没有设备控制权，所以无法同意其他用户的抢占申请
210247 该用户没有设备控制权，所以无法主动释放控制权
210248 设备控制状态检查失败
device_control_user_id
string
控制设备的用户id
device_control_user_project_callsign
string
用户项目呼号
device_control_user_organization_callsign
string
用户组织呼号
示例
{
"code": 0,
"message": "string",
"data": {
"device_control_status": 0,
"device_control_user_id": "string",
"device_control_user_project_callsign": "string",
"device_control_user_organization_callsign": "string"
}
}修改于 2025-07-01 03:12:14