# Cloud Phone Management

Cloud Phone Management に関する API。

 - [POST /cloudphone/page](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/pageusingpost.md): 認証済みチームから見えるクラウドフォンをページ単位で一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **補足**：すべてのデバイスサービスのクラウドフォンが返されます。プラットフォームプロキシとダイナミックプロキシのパスワードはレスポンスから除去されます。 - **用途**：これと `/cloudphone/info` が、非同期の電源操作、
 - [POST /cloudphone/link](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/createcloudphoneremotelink.md): クラウドフォンにブラウザでアクセスするための一時リンクを作成します（Open API のみ）。 - **前提条件**：端末が現在のチームに属し、呼び出すメンバーにアクセス権限があり、起動済みで、他のメンバーに使用されていないことが必要です。自動起動は行いません。 - **効果**：呼び出すたびに新しいリンクを作成します。接続認証情報の取得や現在の接続の変更は行いません。ブラウザで `data.ur
 - [POST /cloudphone/create](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/createusingpost.md): クラウドフォンを 1 台以上購入してプロビジョニングします。 - **前提条件**：プランに残容量があり、当日の作成上限を使い切っていないこと。`country`、`timezone`、`language` は選択したデバイスサービスの対応リストに対して検証されるため、非対応の組み合わせは暗黙に調整されるのではなく拒否されます。座標は経度 ±180、緯度 ±90 に制限されます。選択した SKU
 - [POST /cloudphone/powerOn](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/poweronusingpost.md): クラウドフォンを起動します。 - **前提条件**：クラウドフォンが現在電源オフであること。次の場合は拒否されます — SKU が販売終了またはメンテナンス中、他のメンバーに占有されている、プロキシの検査が完了していない、アカウントが未払いまたはクラウドフォンが無効化されている、月額期間が満了している、そして無料時間・同時実行枠・残高のいずれも利用できない場合です。一部の機種では最新版の Wind
 - [POST /cloudphone/restart](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/restartcloudphone.md): クラウドフォン全体を再起動します。実行中の AI タスクを終了し、進行中のアプリインストール記録を削除します。 `id` で指定した 1 台のクラウドフォンを操作します。操作権限が必要です。有効化済みで、解放済みでも転送中でもなく、起動中（`envStatus=4`）で、他のメンバーに占有されていないことが条件です。成功時は `data: null` を返し、タスク ID は返しません。操作の完了
 - [POST /cloudphone/reset](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/resetcloudphone.md): **データ削除の警告：** リセットは端末データとアプリインストール記録を削除し、実行中の AI タスクを終了します。必要なデータを先にバックアップしてください。ワンクリック新規端末とは異なる操作です。 `id` で指定した 1 台のクラウドフォンを操作します。操作権限が必要です。有効化済みで、解放済みでも転送中でもなく、起動中（`envStatus=4`）で、他のメンバーに占有されていないことが
 - [POST /cloudphone/powerOff](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/poweroffusingpost.md): クラウドフォンを停止します。 - **前提条件**：クラウドフォンが起動中または起動済みであること。他のメンバーに占有されている間、またはワンクリック新端末、再起動、リセットが進行中の間は停止できません。 - **副作用**：課金を止め、同時実行枠を解放し、使用量を確定し、そのセッションに対して発行された接続資格情報を無効化します。起動中のクラウドフォンを停止した場合は、停止ではなく起動処理の中断
 - [POST /cloudphone/edit/batch](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/editbatchusingpost.md): クラウドフォン 1 台以上の設定を更新します。 - **前提条件**：クラウドフォンがチームのものであること。地域、言語、座標の値は作成時とまったく同様にデバイスサービス単位で検証されます。権限のないグループへ移動しようとすると拒否されます。 - **副作用**：クラウドフォンの設定を上書きし、GPS 設定を再適用します。タグの紐付けを作成する場合があります。課金は発生せず、同時実行枠にも影響しま
 - [POST /cloudphone/setProxy](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/setproxy.md): 1 台以上のクラウドフォンにプロキシを紐付けます。 - **前提条件**：`ids` または `uniqueIds` の少なくとも一方を指定します。クラウドフォンは自チームのものである必要がありますが、起動済みである必要は**ありません**。`proxyId` を指定する場合、それが存在しなければ呼び出しは拒否されます。 - **副作用**：`proxyId` を省略または `0` にした場合、接
 - [POST /cloudphone/delete/batch](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/deleteusingpost.md): クラウドフォンを 1 台以上解放します。 - **前提条件**：クラウドフォンが移管中でなく、チームに未払いの注文がないこと。電源が入っていても構いません。 - **副作用**：デバイスサービス側のインスタンスは即座に解放されます。一度もアクティベートされていないクラウドフォンは完全に削除され、アクティベート済みのものは無効化レコードとして保持されるため、無効化ステータスで一覧に残り続けます。 -
 - [POST /cloudphone/newMachine](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/onenewusingpost.md): クラウドフォンの端末アイデンティティをその場で入れ替えます（ワンクリック新端末）。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。ブランドと機種を指定する場合は、そのクラウドフォンの SKU が対応するものでなければなりません。**この操作はクラウドフォンの当日作成上限を消費します** — `/cloudphone/create` と同じ枠です。 - **副
 - [POST /cloudphone/info](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/infousingpost.md): 単一のクラウドフォンの詳細を、グループ名とタグ名を含めて返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **用途**：非同期操作の主要なステータス確認エンドポイントです。`envStatus` は新規、作成失敗、電源オフ、起動中、起動済み、リセット中、再起動中、ワンクリック新端末の処理中を区別します。非同期操作が失敗した場合は `errorCo
 - [POST /cloudphone/queryByAndroidId](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/querybyandroidid.md): 端末が報告する Android ID からクラウドフォンを検索します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。クラウドフォンは起動している必要はありません。 - **返却**：`/cloudphone/info` と同じ詳細構造です。 - **境界ケース**：`androidId` が空の場合、バリデーションエラーではなく `data` が null
 - [POST /cloudphone/enableRoot](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/enableroot.md): クラウドフォンのグローバル ROOT スイッチを ON / OFF します。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。対応機種で対応。非対応の機種では呼び出しは成功しますが効果はありません。 - **副作用**：`/cloudphone/app/openRoot` と異なり、この設定はクラウドフォンの設定レコードに**永続化され**、その後端末全体のス
 - [POST /cloudphone/screenCap](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/screencap.md): クラウドフォンの画面をキャプチャし、ダウンロード URL を返します。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。対応機種でのみ対応。非対応の機種では呼び出しが拒否されます。 - **副作用**：一部の機種ではキャプチャ後にスクリーンショットファイルが端末から削除されます。 - **完了シグナル**：同期的です。レスポンスに画像の一時ダウンロード URL
 - [POST /cloudphone/screenCapBase64](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/screencapbase64.md): クラウドフォンの画面をキャプチャし、画像を base64 でインラインに返します。 - **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。**対応機種でのみ対応** — 非対応の機種はすべて呼び出しを拒否します。 - **完了シグナル**：同期的です。失敗時は画像データではなくエラーメッセージが返るため、デコードする前に `success` を確認してください。 -
 - [POST /cloudphone/brand/models](https://guide.morelogin.com/ja/api-reference/cloud-phone/open-api/cloud-phone-management/cloudphonebrandmodelspost.md): クラウドフォンの SKU が対応する端末ブランドと機種を一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。クラウドフォンは関与しません。 - **用途**：`/cloudphone/create` または `/cloudphone/newMachine` を呼ぶ前に、有効な `brand` と `modelId` を選ぶために使います。どちらもこのエ