# 启动云手机

启动云手机。
- **前置条件**：云手机当前必须处于已关机状态。以下情况会被拒绝：SKU 已下架或处于维护、云手机被其他成员占用、代理仍在检测中、账户欠费或云手机已停用、包月已到期，以及免费时长、并发额度、正余额三者都不可用。部分机型还要求使用最新版 Windows 客户端。
- **副作用**：把云手机标记为启动中、占用给调用成员，并预留一个并发额度或开始消耗时长。响应会说明用的是哪一种。
- **完成信号**：**已受理，未完成。** 请轮询 `/cloudphone/info` 直到 `envStatus` 为已开机；失败时会在那里以 `errorCode` 和 `errorMsg` 呈现。配置了回调地址的成员还会收到 webhook。
- **重试**：并发的第二次调用会被直接拒绝而不是排队。超时后请读 `/cloudphone/info`，不要重发。

已记录的业务错误码：`33300`, `33309`, `33315`, `33316`, `33317`, `33318`, `33321`, `33322`, `33323`, `33324`, `33325`, `33346`, `33347`, `33367`, `33376`, `33407`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)

  - `disableMoneySavingMode` (boolean)
    禁用省电模式，默认值：false

## Response 200:

  - `200` (unknown)
    好的

## Response 200 fields (application/json):

  - `code` (integer, required)
    返回结果代码 0：正常；其他代码均为例外情况。

  - `msg` (string | null, required)
    错误信息

  - `requestId` (string, required)
    操作请求 ID