接口说明
对指定id的云手机执行安装应用操作。即用户从其在移动云平台上订购的对象存储桶中选择APK文件，并将其安装到指定的云手机上。 注意： 1. 本接口属于异步任务接口，返回结果只有任务id。查询该任务的执行状态需要客户配置回调信息，或者根据任务id调用“查询任务执行状态详情/列表”接口来实现； 2. 状态为“运行中”的云手机才能调用此接口； 3. 对象存储桶和指定id的云手机必须在同一个资源池中； 4. 使用本接口前必须在云手机控制台-对象存储管理中绑定对象存储信息；
URL
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/apps/install
请求参数
Header
|
参数名称
|
类型
|
必填
|
描述
|
|
pool
|
string
|
是
|
资源池ID |
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
req
|
OpenapiCloudPhoneAppInstallReq
|
是
|
req |
|
appName
|
string
|
是
|
应用名称 |
|
appPackageName
|
string
|
是
|
应用包名 |
|
appSize
|
string
|
是
|
应用大小 |
|
appVersion
|
string
|
是
|
应用版本号 |
|
bucketName
|
string
|
是
|
对象存储桶名称 |
|
callbackUrl
|
string
|
否
|
回调url，如http://192.168.0.1:5556/api/callback，needCallback为true才能生效 |
|
downloadUrl
|
string
|
否
|
对象存储文件地址 |
|
etag
|
string
|
否
|
对象存储上传对象的实体标记 |
|
fileName
|
string
|
是
|
原文件名称 |
|
filePath
|
string
|
是
|
对象存储中文件路径 |
|
needAuth
|
boolean
|
否
|
是否需要鉴权 |
|
needCallback
|
boolean
|
否
|
是否需要回调 |
|
phoneIds
|
<string> array
|
是
|
云手机实例列表 |
请求示例
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/apps/install{
"appName":"Via",
"appPackageName":"mark.via",
"appSize":"2",
"appVersion":"5.8.1",
"bucketName":"cloudphone-app",
"fileName":"via-release-cn.apk",
"filePath":"/aa/via-release-cn.apk",
"needCallback":true,
"callbackUrl":"http://192.168.0.1:5556/api/callback",
"needAuth":true,
"phoneIds":[
"1899348080983306243"
]
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
<OpenapiCloudPhoneJobResultDto> array
|
响应体 |
|
errorCode
|
string
|
任务错误码 |
|
errorMsg
|
string
|
任务错误码说明 |
|
id
|
string
|
云手机ID |
|
jobId
|
string
|
任务ID |
|
errorCode
|
string
|
错误编码 |
|
errorMessage
|
string
|
错误信息 |
|
requestId
|
string
|
请求id |
|
state
|
string
|
状态值 |
返回示例
返回码：200
OK
{
"errorCode":"00000000",
"errorMessage":"请求成功",
"requestId":"d98e8af8-9edf-46f7-8b3d-ccca2025a75c",
"state":"OK",
"body":[
{
"id":"1899348080983306243",
"jobId":"1900091317234876417",
"errorCode":null,
"errorMsg":null
}
]
}