# クラウド電話プロファイルの作成

クラウドフォンを 1 台以上購入してプロビジョニングします。
- **前提条件**：プランに残容量があり、当日の作成上限を使い切っていないこと。`country`、`timezone`、`language` は選択したデバイスサービスの対応リストに対して検証されるため、非対応の組み合わせは暗黙に調整されるのではなく拒否されます。座標は経度 ±180、緯度 ±90 に制限されます。選択した SKU が電話番号に対応していない場合、電話番号は破棄されます。月額 SKU は [`/api/cloudphone/monthly/skus`](./local-api.yaml#operation/listMonthlyCloudPhoneSkus) で返された場合に API から作成でき、現在の期間は 30 日です。
- **副作用**：クラウドフォンのレコードを作成します。従量課金 SKU はプロビジョニング後に利用でき、月額 SKU は非アクティブで作成されます。作成時には課金されません。月額端末は [`/api/cloudphone/monthly/activate`](./local-api.yaml#operation/activateMonthlyCloudPhones) でのみ課金され、従量課金端末は起動時に残高またはクォータの消費を開始します。
- **完了シグナル**：**受理されただけで、完了ではありません。** デバイスサービス側のインスタンスはまだ準備できておらず、早すぎる起動は拒否されます。[`/api/cloudphone/info`](./local-api.yaml#operation/infoUsingPOST) または [`/api/cloudphone/page`](./local-api.yaml#operation/pageUsingPOST) をポーリングし、`envStatus` が電源オフを示すまで待ってください。月額 SKU の場合は、起動前に [`/api/cloudphone/monthly/activate`](./local-api.yaml#operation/activateMonthlyCloudPhones) も完了してください。
- **リトライ**：冪等ではなく、直列化もされません。冪等キーもありません。タイムアウト後に無条件でリトライせず、まず状態を照会してください。

文書化されたビジネスエラー: `19064`, `20018`, `33338`, `33339`, `33340`, `33341`, `33342`, `33343`, `33344`, `33345`, `33398`, `33399`, `33400`, `33408`。 各コードの意味は [Error Codes](../Getting%20Started/error-codes.md) を参照してください。どの操作でも共通コードが返る場合があります。

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

## Request fields (application/json):

  - `skuId` (string, required)
    クラウドフォンの機種
| クラウドフォンの機種 | SKU ID (`skuId`) |
|  --- | --- |
| Android 12 | `10002` |
| Android 13 | `10013` |
| Android 14 | `10005` |
| Android 15 | `10004` |
| Android 15A | `10014` |
| Android 16 | `10015` |
| Android 17 | `10105` |

対応する地域とタイムゾーンの対応関係は[国とタイムゾーン対照表](/api-reference/appendix/country-time-zone)を参照してください

  - `quantity` (integer, required)
    作成するクラウドフォンの台数。指定可能な範囲：[1-10]

  - `envRemark` (string)
    備考（最大 1500 文字）

  - `groupId` (string)
    グループ ID。未分類の場合は `"0"` を指定します。

  - `groupName` (string)
    既存のグループ名。一致するグループがない場合は、その名前で新規作成されます。

  - `automaticGeo` (boolean)
    地理的位置を自動的に一致させるかどうか。デフォルト：true

  - `automaticLanguage` (boolean)
    言語を自動的に一致させるかどうか。デフォルト：true

  - `automaticLocation` (boolean)
    位置（タイムゾーン、国）を自動的に一致させるかどうか。デフォルト：true

  - `country` (string)
    国コード（例：`us`）。全一覧は[国とタイムゾーン対照表](/api-reference/appendix/country-time-zone)を参照してください

  - `timezone` (string)
    タイムゾーン。例：America/New_York

  - `language` (string)
    言語。例：en-US

  - `altitude` (number)
    高度

  - `latitude` (number)
    緯度。例：22.309182

  - `longitude` (number)
    経度。例：114.176817

  - `speed` (number)
    移動速度

  - `bearing` (number)
    移動方向

  - `accuracy` (number)
    水平精度

  - `phoneNumber` (string)
    電話番号のカスタマイズ。形式の要件：先頭は + 記号、国コードは 1〜3 桁（86 を除く）、全体の長さは 8〜14 桁で、+ と数字のみを含むこと。

  - `brand` (string)
    端末ブランド。https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post インターフェースで照会できます。

  - `modelId` (number)
    端末機種 ID。https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post インターフェースで照会できます。

  - `proxyId` (string)
    プロキシ ID

  - `tags` (array)
    タグ名。空の値は無視されます。

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (array)
    これはクラウド電話IDです

  - `requestId` (string, required)

  - `error` (object)