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

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

请求参数

Parameter name Type Description Required

instance

String

要被制作为模板的云服务器

Yes

image_name

String

镜像名称

No

zone

String

区域 ID，注意要小写

Yes

target_user

String

目标用户 ID ，可用于主账号为其子账号创建资源。

No

除上述请求参数外，还包含公共参数。

返回数据

Name Type Description

action

String

响应动作

job_id

String

执行任务的 Job ID

image_id

String

新创建的镜像 ID

ret_code

Integer

执行成功与否，0 表示成功，其他值则为错误代码

请求示例

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

返回示例

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