# クラウド電話をシャットダウンする

クラウドフォンを停止します。
- **前提条件**：クラウドフォンが起動中または起動済みであること。他のメンバーに占有されている間、またはワンクリック新端末、再起動、リセットが進行中の間は停止できません。
- **副作用**：課金を止め、同時実行枠を解放し、使用量を確定し、そのセッションに対して発行された接続資格情報を無効化します。起動中のクラウドフォンを停止した場合は、停止ではなく起動処理の中断になります。
- **完了シグナル**：課金とローカル状態は同期的に確定しますが、デバイスサービス側のシャットダウンはその後も続くため、`/cloudphone/info` で確認してください。
- **リトライ**：2 回目の呼び出しはクラウドフォンが動作していないと報告します。バッチは最初の失敗で中断するため、リトライ前に状態を読み直してください。

文書化されたビジネスエラー: `33300`, `33301`, `33308`, `33331`, `33332`, `33333`。 各コードの意味は [Error Codes](../Getting%20Started/error-codes.md) を参照してください。どの操作でも共通コードが返る場合があります。

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)
    戻り結果コード0：正常。その他のコードは例外です。

  - `msg` (string | null, required)
    エラーメッセージ

  - `requestId` (string, required)
    操作リクエストID