调用CreateImage创建一份云手机自定义镜像。

接口说明

调用该接口时,您需要注意:

  • 创建时使用一台云手机实例做模板,只需要指定实例ID(InstanceId)。该台实例的状态必须为运行中(Running)或者已停止(Stopped)。
  • 等待镜像状态变为可用(Available)后才能使用镜像资源。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateImage

接口名称

InstanceId String cp-xxxxxxxx

云手机实例ID

RegionId String cn-hangzhou

云手机实例所属地域

ImageName String myCustomImage

镜像名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以http://和https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

Description String testDescription

镜像的描述信息。长度为2~256个英文或中文字符,不能以http://和https://开头。

ClientToken String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多详情,请参见如何保证幂等性。

返回数据

名称 类型 示例值 描述
ImageId String cpm-xxxxxxxx

自定义镜像ID

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID

示例

请求示例

http(s)://[Endpoint]/?Action=CreateImage
&InstanceId=cp-xxxxxxxx
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<ImageId>cpm-xxxxxxxx</ImageId>

JSON格式

{"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E","ImageId":"cpm-xxxxxxxx"}

错误码

访问错误中心查看更多错误码。

访问错误中心查看更多错误码。