推送文件PushFile
接口说明
推送文件到 云手机 文件系统中。系统会将所指定的文件下载解压后,将解压后的内容全部推送到云手机的根目录下。只支持指定tar格式的文件进行推送,您需要将tar文件提前上传至您的OBS桶中。
URL
POST https://cph.cn-north-4.myhuaweicloud.com/v1/{project_id}/cloud-phone/phones/commands
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
project_id
|
string | path | 是 |
项目id。 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
command
|
string | 是 |
推送文件固定填写push。 |
|
content
|
string | 是 |
推送的文件只支持tar文件类型,指定OBS桶中的tar文件。 最大长度为1024字节,只支持大小写字母、数字、下划线(_)、点(.)、斜线(/)、冒号(:)、中划线(-)。 |
|
phone_ids
|
Array of strings | 否 |
云手机ID列表。 server_ids参数不存在时必选,同时存在只处理phone_ids。 |
|
server_ids
|
Array of strings | 否 |
云手机服务器ID列表。 phone_ids参数不存在时必选,同时存在只处理phone_ids。 |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
request_id
|
string | 否 |
请求的唯一标识ID。 |
|
jobs
|
Array of PhoneJob objects | 否 |
任务列表。 |
200 jobs
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
phone_id
|
string | 否 |
云手机的唯一标识ID,云手机相关任务包含此字段。 |
|
job_id
|
string | 否 |
任务的唯一标识。 |
|
error_code
|
string | 否 |
错误码。 |
|
error_msg
|
string | 否 |
错误说明。 |
请求示例
示例 1
推送文件到云手机文件系统中。
"POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands"
{ "command": "push", "content": "obs://push-bucket/my_apps/test.tar", "phone_ids": [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] }
返回示例
返回码：200
OK
示例 1
{
"request_id": "6837531fd3f54550927b930180a706bf",
"jobs": [
{
"phone_id": "1234567b8bab40ffb711234cb80d0234",
"job_id": "1564567b8bab40f34711234cb80d0123"
},
{
"phone_id": "1678567b8bab40f93711234cb80d0764",
"job_id": "1564567b8bab40f34711234cb80d5678"
}
]
}
"request_id": "6837531fd3f54550927b930180a706bf",
"jobs": [
{
"phone_id": "1234567b8bab40ffb711234cb80d0234",
"job_id": "1564567b8bab40f34711234cb80d0123"
},
{
"phone_id": "1678567b8bab40f93711234cb80d0764",
"job_id": "1564567b8bab40f34711234cb80d5678"
}
]
}
SDK
点击 云手机 (CPH) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
