基本信息

被捕获的云服务器状态必须为 stopped，否则会返回错误。

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

Action

CaptureInstance

Path

/iaas

Method

GET

请求参数

此接口除公共参数外，还包含以下参数。关于公共参数的更多信息，请参见前文内容。

参数名 类型 描述 是否必须

instance

String

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

是

image_name

String

镜像名称

否

target_user

String

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

否

返回数据

此接口除了返回公共响应参数外，还返回以下参数。关于公共响应参数的更多信息，请参见前文内容。

参数名 类型 描述

image_id

String

新创建的镜像 ID

请求示例

https://api.<your_domain>/iaas/?action=CaptureInstance
&instance=i-n3nju2rh
&zone=pek3a
&COMMON_PARAMS

返回示例

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