# 关闭云手机

关闭云手机。
- **前置条件**：云手机必须处于启动中或已开机。被其他成员占用时，或正在一键新机、重启、重置时，无法关机。
- **副作用**：停止计费、释放并发额度、结算用量，并让本次会话签发的连接凭据失效。对仍在启动中的云手机执行关机，会改为中断启动。
- **完成信号**：计费与本地状态在同步事务内结算完成；设备关机随后进行，请用 `/cloudphone/info` 确认。
- **重试**：第二次调用会报云手机未运行。批量遇到第一个失败即中止，重试前请重新读取状态。

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

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)

## Response 200:

  - `200` (unknown)
    好的

## Response 200 fields (application/json):

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

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

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