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