# Tắt điện thoại đám mây

Tắt một cloud phone.
- **Điều kiện tiên quyết**: cloud phone phải đang khởi động hoặc đang bật. Không thể tắt khi máy đang bị thành viên khác chiếm giữ, hoặc khi đang có tác vụ đổi thiết bị một cú nhấp, khởi động lại hay khôi phục cài đặt.
- **Tác động**: dừng tính phí, giải phóng suất đồng thời, chốt mức sử dụng, và vô hiệu hóa thông tin xác thực kết nối đã phát hành cho phiên. Tắt một cloud phone vẫn đang khởi động sẽ ngắt quá trình khởi động thay vì tắt máy.
- **Hoàn tất**: phần tính phí và trạng thái nội bộ được chốt đồng bộ; quá trình tắt phía dịch vụ thiết bị vẫn tiếp tục sau đó, nên hãy xác nhận bằng `/cloudphone/info`.
- **Thử lại**: lệnh gọi thứ hai sẽ báo cloud phone không đang chạy. Lô dừng lại ở lỗi đầu tiên, nên hãy đọc lại trạng thái trước khi thử lại.

Các mã lỗi nghiệp vụ đã ghi nhận: `33300`, `33301`, `33308`, `33331`, `33332`, `33333`. Xem [Error Codes](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Endpoint: POST /api/cloudphone/powerOff
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã trả về 0: Bình thường. Các mã khác là ngoại lệ.

  - `msg` (string | null, required)
    Thông báo lỗi

  - `requestId` (string, required)
    ID yêu cầu vận hành