Acquire (Occupy) Cloud Control Permission

POST

/openapi/v2.0/drc/api/v1/projects/{uuid}/cloud_controls

Current user directly occupies cloud control authority for specified aircraft (at control_keys granularity; can simultaneously occupy flight + multiple payload_{index}); no remote controller approval required. After successful occupation, all related users immediately receive WebSocket real-time change notification (reason=Acquire). Difference from "Apply for Cloud Control Authorization" (POST /cloud_control_auth): this API directly forces occupation; the latter uses remote-controller request-approve flow.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "drone_sn": "1ZNBHJD0010012",
    "control_keys": [
        "flight",
        "payload_53-0-0"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/drc/api/v1/projects//cloud_controls' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "drone_sn": "1ZNBHJD0010012",
    "control_keys": [
        "flight",
        "payload_53-0-0"
    ]
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "drone_sn": "1ZNBHJD0010012",
        "controls": [
            {
                "key": "flight",
                "type": "flight",
                "version": 1717890200111,
                "gateway": {
                    "sn": "8UNDOCK0010002",
                    "id": "Drone",
                    "auth_control_keys": [],
                    "device_model_class": "dock"
                },
                "user": {
                    "call_sign": "Cloud Operator Jane Smith",
                    "user_id": "user-002",
                    "type": "cloud"
                },
                "spec": {
                    "is_locked": false
                }
            },
            {
                "key": "payload_53-0-0",
                "type": "payload",
                "version": 1717890200111,
                "gateway": {
                    "sn": "8UNDOCK0010002",
                    "id": "Drone",
                    "auth_control_keys": [],
                    "device_model_class": "dock"
                },
                "user": {
                    "call_sign": "Cloud Operator Jane Smith",
                    "user_id": "user-002",
                    "type": "cloud"
                },
                "spec": {
                    "payload_index": "53-0-0"
                }
            }
        ]
    }
}

🟠400

🔴500

Modified at 2026-06-15 13:36:31

Batch Query Aircraft Cloud Control Authority Status

Release Cloud Control Permission