# 开启或关闭全局 ROOT

打开或关闭云手机的全局 ROOT 开关。
- **前置条件**：云手机必须已开机且未被其他成员占用。仅兼容机型支持；不兼容机型调用成功但无效果。
- **副作用**：与 `/cloudphone/app/openRoot` 不同，这个设置**会被持久化**到云手机的设置记录，然后作为设备级开关下发给设备服务。
- **完成信号**：同步。MoreLogin 不会重启云手机；变更何时在设备上生效由设备服务决定。
- **重试**：幂等。

已记录的业务错误码：`33300`, `33301`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /cloudphone/enableRoot
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    云手机 ID
    Example: 1558968155668507

  - `enableRoot` (boolean, required)
    是否开启全局系统级 ROOT 权限
    Example: true

## Response 200:

  - `200` (unknown)
    成功。该接口的 `data` 恒为 null，结果由 `code` 表达。

## Response 200 fields (application/json):

  - `code` (integer)
    响应码：0 = 成功，>0 = 失败

  - `data` (null)

  - `msg` (string | null)
    错误信息；code > 0 时返回

  - `requestId` (string)
    请求唯一标识；联系支持时请提供