# 上传文件

把本地文件直接上传到云手机（旧版分片流程）。
- **前置条件**：云手机必须已开机且未被其他成员占用。从签名地址步骤取得的上传码是一次性的。
- **完成信号**：响应仅表示 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.