接口说明
对指定id“已关机”状态的云手机执行更换AOSP镜像操作。任务执行成功且重启云手机后,更新的镜像才能生效。 注意: 1. 本接口返回结果只有任务id。查询该任务的执行状态需要只能根据任务id调用“查询任务执行状态详情/列表”接口来实现; 2. 必须确保云手机与AOSP镜像在同一个资源池内才能更换镜像成功; 3. 状态为“已关机”的云手机才能调用此接口; 4. 可通过“查询镜像列表”接口查询可用的镜像id; 5. 暂不支持更换自定义镜像; 6. “云手机更换镜像V2”接口,相较于”云手机更换镜像”接口,本接口请求体中的imageId从Long类型变成String类型,其他功能不变。
URL
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/attributes/changeImageV2
请求参数
Header
|
参数名称
|
类型
|
必填
|
描述
|
|
pool
|
string
|
是
|
资源池ID |
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
req
|
OpenapiCloudPhoneChangeImageV2Req
|
是
|
req |
|
callbackUrl
|
string
|
否
|
回调url,如http://192.168.0.1:5556/api/callback,needCallback为true才能生效 |
|
ids
|
<string> array
|
是
|
云手机实例ID列表 |
|
imageId
|
string
|
是
|
云手机镜像ID |
|
needAuth
|
boolean
|
否
|
是否需要鉴权 |
|
needCallback
|
boolean
|
否
|
是否需要回调 |
请求示例
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/phones/attributes/changeImageV2
{
"imageId":"99",
"ids":[
"1899654129611276290"
],
"needCallback":true,
"callbackUrl":"http://192.168.0.1:5556/api/callback",
"needAuth":true
}
返回参数
返回码: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":"101cdaa5-e49a-4f36-95f9-acd41a19d300",
"state":"OK",
"body":[
{
"id":"1899654129611276290",
"jobId":"1900015426966253569",
"errorCode":null,
"errorMsg":null
}
]
}