文档首页> 镜像服务 IMS> API参考> 应用示例> 使用ISO文件创建镜像
更新时间:2023-05-09 GMT+08:00

使用ISO文件创建镜像

场景描述

ISO是一种光盘映像文件,通过特定的压缩方式,将大量的数据文件统一为一个后缀名为iso的映像文件。ISO文件可以理解为从光盘中复制出来的数据文件,所以ISO文件无法直接使用,需要利用一些工具进行解压后才能使用。例如使用虚拟光驱打开,或者将ISO文件刻录到光盘中后,使用光驱来进行读取。

本章介绍通过ISO文件创建私有镜像的API操作过程。

涉及API

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

  • IAM获取token的API

    URI格式:POST https://{IAM的Endpoint}/v3/auth/tokens

  • 镜像服务API:制作镜像(使用上传至OBS桶中的外部镜像文件制作私有镜像)

    URI格式:POST https://{IMS的Endpoint}/v2/cloudimages/action

  • 弹性云服务器API:创建云服务器(按需)

    URI格式:POST https://{ECS的Endpoint}/v1/{project_id}/cloudservers

  • 镜像服务API:制作镜像(使用数据盘制作系统盘镜像)

    URI格式:POST https://{IMS的Endpoint}/v2/cloudimages/action

具体步骤

  1. Token认证,具体操作请参考认证鉴权
  2. 使用上传至OBS桶中的ISO镜像文件制作私有镜像。
    1. 发送“POST https://{IMS的Endpoint}/v2/cloudimages/action”。
    2. 在Request Header中增加“X-Auth-Token”。
    3. 在Request Body中传入如下参数:

      详细的参数说明请参见“制作镜像”。

      {
          "name": "ims_test_file",  //镜像名称(必填String)
          "description": "OBS文件制作镜像",  //镜像描述(非必填String)
          "image_url": "ims-image:centos70.iso",  //OBS桶中外部镜像文件地址(必填String)
          "os_type": "Linux",  //操作系统类型(非必填String)
          "os_version": "CentOS 7.0 64bit",  //操作系统版本(必填String)
          "type": "IsoImage",  //镜像的类型(必填String)
          "min_disk": 40,  //最小系统盘大小(必填Integer)
          "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]  //镜像标签列表(非必填Array of objects)
      }
    4. 请求响应成功后,返回job_id,根据job_id查询job详情,可以获取镜像ID。具体操作请参考异步任务查询
  3. 根据ISO镜像创建一台临时云服务器。
    • 创建云服务器时,只能选择通用计算型、2 vCPU、内存为4G及以上的KVM类型的规格。
    • 通过ISO镜像创建云服务器必须创建两块盘,一块系统盘一块数据盘,在安装操作系统时,操作系统默认安装至数据盘中。
    1. 发送“POST https://{ECS的Endpoint}/v1/{project_id}/cloudservers”。
    2. 在Request Header中增加“X-Auth-Token”。
    3. 在Request Body中传入如下参数:

      以下参数均为必填项,详细的参数说明请参见“创建云服务器(按需)”。

      {
          "server": {
              "imageRef": "fac42d61-ea1e-4271-94ba-6543a852d2c6",  //上一步获取的镜像ID
              "flavorRef": "rc6.large.2_manage",
              "name": "instance-test",
              "vpcid": "18ec99f0-7159-4d7b-ad27-f32315d5af61",
              "nics": [{
                  "subnet_id": "81a4ecb0-0451-4c60-8373-8b923238ec40"
              }],
              "root_volume": {
                  "volumetype": "SATA",
                  "size": "40"
              },
              "data_volumes": [{
                  "volumetype": "SATA",
                  "size": "40"
              }],
              "availability_zone": "az-1a",
              "metadata": {
                  "virtual_env_type": "IsoImage"
              },
              "extendparam": {
                  "diskPrior": "true"
              }
          }
      }
    4. 请求响应成功后,返回job_id,根据job_id查询job详情,可以获取云服务器ID。具体操作请参考“查询任务的执行状态”。
    5. 根据云服务器ID查询云服务器详情,可以获取4中需要用到的数据盘ID(volume_id)。具体操作请参考“查询云服务器详情”。
  4. 使用临时云服务器创建标准私有镜像。
    1. 发送“POST https://{IMS的Endpoint}/v2/cloudimages/action”。
    2. 在Request Header中增加“X-Auth-Token”。
    3. 在Request Body中传入如下参数:

      详细的参数说明请参见“制作镜像”。

      {
          "name": "ims_test",  //镜像名称(必填String)
          "description": "数据盘制作系统盘镜像",  //镜像描述(非必填String)
          "volume_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a",  //数据盘ID(必填String)
          "type": "ECS",  //镜像的类型(必填String)
          "os_version": "CentOS 7.0 64bit",  //操作系统版本(必填String)
          "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]  //镜像标签列表(非必填Array of objects)
      }
    4. 请求响应成功后,返回job_id,根据job_id查询job详情,可以获取镜像ID。具体操作请参考异步任务查询