将某个已关闭的云服务器制作成模板（或称“自有镜像”），之后便可将其用于创建新的云服务器。 被捕获的云服务器必须是已关闭（ stopped ）状态，否则会返回错误。

由云服务器制成的自有镜像，会保留云服务器中安装的软件、配置及数据， 因此基于这个自有镜像创建的云服务器，就直接获得了相同的系统环境。

Request Parameters

Parameter name	Type	Description	Required
instance	String	要被制作为模板的云服务器	Yes
image_name	String	镜像名称	No
zone	String	区域 ID，注意要小写	Yes
target_user	String	目标用户 ID ，可用于主账号为其子账号创建资源。	No

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
job_id	String	执行任务的 Job ID
image_id	String	新创建的镜像 ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=CaptureInstance
&instance=i-n3nju2rh
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"CaptureInstanceResponse",
  "job_id":"j-bm6ym3r8",
  "image_id":"img-j38f2h3h"
  "ret_code":0
}