云手机更换镜像

接口说明

对指定id“已关机”状态的云手机执行更换AOSP镜像操作。任务执行成功且重启云手机后,更新的镜像才能生效。 注意: 1. 本接口返回结果只有任务id。查询该任务的执行状态需要只能根据任务id调用“查询任务执行状态详情/列表”接口来实现; 2. 必须确保云手机与AOSP镜像在同一个资源池内才能更换镜像成功; 3. 状态为“已关机”的云手机才能调用此接口; 4. 可通过“查询镜像列表”接口查询可用的镜像id; 5. 暂不支持更换自定义镜像; 6. “云手机更换镜像V2”接口,相较于”云手机更换镜像”接口,本接口请求体中的imageId从Long类型变成String类型,其他功能不变。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

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
		}
	]
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。