跳转到内容

获取临时上传文件 URL

Request

申请一个预签名 URL,用于上传将要发送给云手机的文件。

  • 前置条件:云手机必须已开机且未被其他成员占用。
  • 完成信号:同步。预签名 URL 有效期为一小时。 用 PUT 把文件内容上传到该地址,然后调用 /api/cloudphone/upload/file 登记。
  • 说明:临时对象会在 7 天后自动删除。
  • 接口面说明:与 Open API 的 /cloudphone/uploadUrl 是同一套实现。
Bodyapplication/jsonrequired
idstringrequired

Cloud phone ID

fileNamestringrequired

File name

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/upload/file/signedUrl \
  -H 'Content-Type: application/json' \
  -d '{
    "fileName": "icon.png",
    "id": "1666625111121936"
  }'

Responses

Success. data is an object with the fields presignedUrl.

Headers
any
Bodyapplication/json
codeintegerrequired
msgstring or nullrequired
dataobjectrequired
requestIdstringrequired
Response
{ "code": 0, "msg": null, "data": { "presignedUrl": "https://example-bucket.s3.amazonaws.com/prod/cloudPhoneOpenApi/1666625111121936/20260901/demo.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=EXAMPLE" }, "requestId": "d0b850e2c3d54279b524e9540a358e0a" }