# Desligue o telefone na nuvem

Desliga um Cloud Phone.
- **Pré-requisitos**: o telefone precisa estar inicializando ou ligado. Ele não pode ser desligado enquanto estiver reservado por outro membro, nem enquanto houver em andamento uma troca de dispositivo em um clique, um reinício ou uma redefinição.
- **Efeito**: interrompe a cobrança, libera a vaga de concorrência, fecha o consumo e invalida as credenciais de conexão emitidas para a sessão. Desligar um telefone que ainda estava inicializando interrompe a inicialização em vez de desligá-lo.
- **Conclusão**: a cobrança e o estado local são fechados de forma sincrônica; o desligamento do lado do serviço continua depois, então confirme com `/cloudphone/info`.
- **Nova tentativa**: uma segunda chamada informa que o telefone não está em execução. Os lotes são interrompidos na primeira falha, então releia o estado antes de repetir.

Erros de negócio documentados: `33300`, `33301`, `33308`, `33331`, `33332`, `33333`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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)
    Código de resultado retornado: 0: Normal. Outros códigos são exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `requestId` (string, required)
    ID da solicitação de operação