SendFile - 文件上传到云手机

OSS文件推送到云手机。

接口说明

目前仅支持将 OSS 对象存储服务的文件或者文件夹发送到云手机。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AndroidInstanceIdListarray

实例列表。

string

实例 ID。

acp-34pqe4r0kd9kn****
SourceFilePathstring

将文件上传到云手机内部的上传路径。

说明 当 UploadType 是 OSS,云手机内部的上传路径 SourceFilePath 必须是目录,例如:/sdcard/Download;当 UploadType 是 DOWNLOAD_URL,云手机内部的上传路径 SourceFilePath 必须是文件,例如:/sdcard/Download/MyFile.txt。
/sdcard/Download
UploadTypestring

上传文件所在的存储类型。

  • OSS 当上传的文件是 OSS 资源,上传文件所在的存储类型是 OSS。
  • DOWNLOAD_URL 当上传的文件是文件的公网下载链接,上传文件所在的存储类型是 DOWNLOAD_URL。
枚举值:
  • DOWNLOAD_URL文件公网下载链接
  • OSSOSS文件资源
OSS
UploadEndpointstring

文件上传到 OSS 的服务域名,UploadType 为 OSS 时,UploadEndpoint 必填。

说明 当云手机和 OSS Bucket 处于相同地域,域名可填写内网域名,加快传输速率,不产生公网网络费用,杭州为例: oss-cn-hangzhou-internal.aliyuncs.com 。具体的域名列表映射可参考 OSS 地域和访问域名
oss-cn-hangzhou-internal.aliyuncs.com
UploadUrlstring
  • 当 UploadType 是 OSS,UploadUrl 是文件上传到 OSS 的云端地址。
说明 可使用的 OSS Bucket 名,必须以“cloudphone-saved-bucket-”前缀的 Bucket Bucket,例如“cloudphone-saved-bucket-example”,并创建 OSS 文件夹作为备份目录。UploadUrl 的拼写规则是“oss://”+“Bucket 名”+“/”+“文件夹名称”+“上传的文件名称”。
  • 当 UploadType 是 DOWNLOAD,UploadUrl 是文件的公网下载地址。
oss://cloudphone-saved-bucket-example/send/a.txt
TargetFileNamestring

从 OSS 上传到云手机的文件名称。

说明 当 UploadType 是 OSS,TargetFileName 字段选填,如果 TargetFileName 为空,OSS 文件上传到云手机的文件名称保留源文件名称,如果 TargetFileName 不为空,源文件上传到云手机的 SourceFilePath 路径下文件名称为 TargetFileName 的值;当 UploadType 是 DOWNLOAD_URL,TargetFileName 字段不生效。
test.txt

返回参数

名称类型描述示例值
object

返回参数。

Dataarray<object>

返回数据。

425F351C-3F8E-5218-A520-B6311D0D****
InstanceTaskobject

返回结果对象。

AndroidInstanceIdstring

实例 ID。

acp-34pqe4r0kd9kn****
TaskIdstring

任务 ID

t-4ks224ujixw****
RequestIdstring

请求唯一 ID,如果遇到问题请提供这个请求 ID,由工作人员为您排查。

425F351C-3F8E-5218-A520-B6311D0D****
TaskIdstring

批量任务 ID。

t-ehs0yoedj0xe9****

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "AndroidInstanceId": "acp-34pqe4r0kd9kn****",
      "TaskId": "t-4ks224ujixw****"
    }
  ],
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "TaskId": "t-ehs0yoedj0xe9****"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-09-13OpenAPI 返回结构发生变更查看变更详情