将某个已关闭的云服务器制作成模板(或称"自有镜像"),之后便可将其用于创建新的云服务器。 被捕获的云服务器必须是已关闭( 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
}