/ 镜像服务 ims/ / 快速入门
更新时间：2024-06-24 gmt 08:00

快速入门-九游平台

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

api的调用方法请参见。

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

涉及api

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

  • iam获取token的api
  • ims创建镜像的api

具体步骤

  1. token认证，具体操作请参考认证鉴权。
  2. 发送“post https://ims的endpoint/v2/cloudimages/action”。
  3. 在request header中增加“x-auth-token”。
  4. 在request body中传入参数如下： 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
    		 
    {
"name":"ims_test",//镜像名称（必填string）
"description":"云服务器制作镜像",//镜像描述（非必填string）
"instance_id":"877a2cda-ba63-4e1e-b95f-e67e48b6129a",//云服务器id（必填string）
"tags":[
"aaa.111",
"bbb.333",
"ccc.444"
]//镜像标签列表（非必填list）
}

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

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

  1. 根据job_id查询job详情，具体操作请参考。

    查询job详情返回状态status为“success”，则表示私有镜像创建成功。

    请求异常返回值说明请参考。

  2. 查询job详情的body体中可以获取到image_id，即镜像id，根据获取到的镜像id可对镜像进行查询、删除、导出等操作。

相关文档

网站地图