将OSS文件推送到云手机。
接口说明
目前仅支持将 OSS 对象存储服务的文件或者文件夹发送到云手机。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
AndroidInstanceIdList | array | 是 | 实例列表。 | |
string | 是 | 实例 ID。 | acp-34pqe4r0kd9kn**** | |
SourceFilePath | string | 是 | 将文件上传到云手机内部的上传路径。 说明
当 UploadType 是 OSS,云手机内部的上传路径 SourceFilePath 必须是目录,例如:/sdcard/Download;当 UploadType 是 DOWNLOAD_URL,云手机内部的上传路径 SourceFilePath 必须是文件,例如:/sdcard/Download/MyFile.txt。
| /sdcard/Download |
UploadType | string | 是 | 上传文件所在的存储类型。
枚举值:
| OSS |
UploadEndpoint | string | 否 | 文件上传到 OSS 的服务域名,UploadType 为 OSS 时,UploadEndpoint 必填。 说明
当云手机和 OSS Bucket 处于相同地域,域名可填写内网域名,加快传输速率,不产生公网网络费用,杭州为例: oss-cn-hangzhou-internal.aliyuncs.com 。具体的域名列表映射可参考 OSS 地域和访问域名。
| oss-cn-hangzhou-internal.aliyuncs.com |
UploadUrl | string | 是 |
说明
可使用的 OSS Bucket 名,必须以“cloudphone-saved-bucket-”前缀的 Bucket Bucket,例如“cloudphone-saved-bucket-example”,并创建 OSS 文件夹作为备份目录。UploadUrl 的拼写规则是“oss://”+“Bucket 名”+“/”+“文件夹名称”+“上传的文件名称”。
| oss://cloudphone-saved-bucket-example/send/a.txt |
TargetFileName | string | 否 | 从 OSS 上传到云手机的文件名称。 说明
当 UploadType 是 OSS,TargetFileName 字段选填,如果 TargetFileName 为空,OSS 文件上传到云手机的文件名称保留源文件名称,如果 TargetFileName 不为空,源文件上传到云手机的 SourceFilePath 路径下文件名称为 TargetFileName 的值;当 UploadType 是 DOWNLOAD_URL,TargetFileName 字段不生效。
| test.txt |
返回参数
示例
正常返回示例
JSON
格式
{
"Data": [
{
"AndroidInstanceId": "acp-34pqe4r0kd9kn****",
"TaskId": "t-4ks224ujixw****"
}
],
"RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
"TaskId": "t-ehs0yoedj0xe9****"
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-09-13 | OpenAPI 返回结构发生变更 | 查看变更详情 |