# ワンクリックで新しいクラウドフォン

クラウドフォンの端末アイデンティティをその場で入れ替えます（ワンクリック新端末）。
- **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。ブランドと機種を指定する場合は、そのクラウドフォンの SKU が対応するものでなければなりません。**この操作はクラウドフォンの当日作成上限を消費します** — `/cloudphone/create` と同じ枠です。
- **副作用**：新しいブランドと機種を端末へ送信し、そのクラウドフォンのインストール済みアプリ記録を消去し、電話番号をリセットし、動作中の AI タスクを中断します。デバイスサービスが再生成する識別子の正確な範囲は MoreLogin では定義されていません。
- **完了シグナル**：**受理されただけで、完了ではありません。** クラウドフォンはワンクリック新端末の状態になります。`/cloudphone/info` をポーリングし、その状態を抜けるまで待ってください。
- **同時実行**：実行中は起動、停止、および起動状態を必要とするすべてのコマンドが拒否されます。同時に発行された 2 回目の呼び出しはキューに入らず拒否されます。

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

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

## Request fields (application/json):

  - `id` (string)
    クラウド電話ID

  - `brand` (string)
    ブランド

  - `modelId` (integer)
    モデルID

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    応答コード：0は成功、>0は失敗を示します

  - `msg` (string | null, required)

  - `requestId` (string)
    リクエストの一意な識別子。サポートへの問い合わせ時に提示してください