SendFile - 文件上传到云手机

OSS文件或者公网下载链接的文件推送到云手机。

接口说明

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

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

AndroidInstanceIdList

array

实例列表。

string

实例 ID。

acp-34pqe4r0kd9kn****

SourceFilePath

string

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

说明

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

/sdcard/Download

UploadType

string

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

  • OSS 当上传的文件是 OSS 资源,上传文件所在的存储类型是 OSS。

  • DOWNLOAD_URL 当上传的文件是文件的公网下载链接,上传文件所在的存储类型是 DOWNLOAD_URL。

  • OSS_BRIDGED 通过公网下载链接同步到 OSS,再通过 OSS 内网分发到云手机实例。

OSS

UploadEndpoint

string

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

说明

当云手机和 OSS Bucket 处于相同地域,域名可填写内网域名,加快传输速率,不产生公网网络费用,杭州为例: oss-cn-hangzhou-internal.aliyuncs.com 。具体的域名列表映射可参考 OSS 地域和访问域名

oss-cn-hangzhou-internal.aliyuncs.com

UploadUrl

string

  • 当 UploadType 是 OSS,UploadUrl 是文件上传到 OSS 的云端地址。

说明

可使用的 OSS Bucket 名,必须以“cloudphone-saved-bucket-”前缀的 Bucket Bucket,例如“cloudphone-saved-bucket-example”,并创建 OSS 文件夹作为备份目录。UploadUrl 的拼写规则是“oss://”+“Bucket 名”+“/”+“文件夹名称”+“上传的文件名称”。

  • 当 UploadType 是 DOWNLOAD 或者 OSS_BRIDGED,UploadUrl 是文件的公网下载地址。

oss://cloudphone-saved-bucket-example/send/a.txt

TargetFileName

string

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

说明

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

test.txt

AutoInstall

boolean

上传的应用是否自动安装。

true

返回参数

名称

类型

描述

示例值

object

返回参数。

Data

array<object>

返回数据。

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

object

返回结果对象。

AndroidInstanceId

string

实例 ID。

acp-34pqe4r0kd9kn****

TaskId

string

任务 ID

t-4ks224ujixw****

RequestId

string

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

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

TaskId

string

批量任务 ID。

t-ehs0yoedj0xe9****

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息,参考变更详情