# ファイルのアップロード

ローカルファイルをクラウドフォンへ直接アップロードします（旧来の multipart 方式）。
- **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。署名付き URL 手順で取得したアップロードコードは 1 回限り有効です。
- **完了シグナル**：レスポンスは Local API が転送を受理したことのみを示します。**タスク ID もポーリング用の状態も公開されない**ため、進捗を観測できません。
- **代替手段**：進捗の観測とリトライ処理が必要な場合は `/api/cloudphone/upload/file/signedUrl` → `PUT` → `/api/cloudphone/upload/file` → `/api/cloudphone/upload/file/result` を使ってください。
- **補足**：このパスは、アップロード済みオブジェクトを登録する Open API の `/cloudphone/uploadFile` とは同じ操作ではありません。

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

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

## Request fields (multipart/form-data):

  - `id` (string, required)
    Cloud phone ID
    Example: 1661515884160372

  - `file` (string, required)
    File to upload
    Example: file://D:\application\apifox\LICENSE.electron.txt

  - `uploadDest` (string, required)
    Upload destination directory
    Example: /Download

## Response 200:

  - `200` (unknown)
    The Local API accepted the direct upload and returns an empty JSON object.