# スタートアップのクラウドフォン

クラウドフォンを起動します。
- **前提条件**：クラウドフォンが現在電源オフであること。次の場合は拒否されます — SKU が販売終了またはメンテナンス中、他のメンバーに占有されている、プロキシの検査が完了していない、アカウントが未払いまたはクラウドフォンが無効化されている、月額期間が満了している、そして無料時間・同時実行枠・残高のいずれも利用できない場合です。一部の機種では最新版の Windows クライアントも必要です。
- **副作用**：クラウドフォンを起動中としてマークし、呼び出しメンバーに占有させ、同時実行枠を確保するか時間の消費を開始します。どちらが使われたかはレスポンスで示されます。
- **完了シグナル**：**受理されただけで、完了ではありません。** `/cloudphone/info` をポーリングし、`envStatus` が起動済みになるまで待ちます。失敗した場合はそこに `errorCode` と `errorMsg` が現れます。コールバックホストを設定しているメンバーには Webhook も届きます。
- **リトライ**：同時に発行された 2 回目の呼び出しはキューに入らず即座に拒否されます。タイムアウト後は再送信せず `/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 /api/cloudphone/powerOn
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)

  - `headless` (boolean)
    クラウド電話ウィンドウを表示します。false:表示、true:表示しない、デフォルト:true

  - `disableMoneySavingMode` (boolean)
    省電力モードを無効にする（デフォルト：false）

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    戻り結果コード0：正常。その他のコードは例外です。

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

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