快速入门_镜像服务 IMS_API参考_编程技术网-程序员技术内容聚合平台

（在说正事之前，我要推荐一个福利：你还在原价购买阿里云、腾讯云、华为云服务器吗？那太亏啦！来这里，新购、升级、续费都打折，能够为您省60%的钱呢！2核4G企业级云服务器低至69元/年，点击进去看看吧>>>)

本节通过调用一系列IMS的API使用云服务器来创建私有镜像。

API的调用方法请参见如何调用API。

使用云服务器创建私有镜像时，请确保云服务器处于关机状态。
通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。

涉及API

当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

IAM获取token的API
IMS创建镜像的API

具体步骤

Token认证，具体操作请参考认证鉴权。
发送“POST https://IMS的Endpoint/v2/cloudimages/action”。
在Request Header中增加“X-Auth-Token”。

在Request Body中传入参数如下：

{
    "name": "ims_test",  //镜像名称（必填String）
    "description": "云服务器制作镜像",  //镜像描述（非必填String）
    "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a",  //云服务器ID（必填String）
    "tags": [  
             "aaa.111",  
             "bbb.333",  
             "ccc.444"  
    ]  //镜像标签列表（非必填List<String>）
}

请求响应成功后，返回job_id。

若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参考错误码。

根据job_id查询job详情，具体操作请参考异步任务查询。
查询job详情返回状态status为“SUCCESS”，则表示私有镜像创建成功。

请求异常返回值说明请参考状态码。
查询job详情的body体中可以获取到image_id，即镜像ID，根据获取到的镜像ID可对镜像进行查询、删除、导出等操作。