更新时间:2024-04-16 GMT+08:00

制作整机镜像

功能介绍

使用云服务器、云服务器备份或者云备份制作整机镜像。作为异步接口,调用成功,只是说明后台收到了制作整机镜像的请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询

使用云服务器或者云备份制作整机镜像。作为异步接口,调用成功,只是说明后台收到了制作整机镜像的请求,镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态,具体请参考异步任务查询

约束与限制(使用云服务器制作整机镜像)

  • 创建整机镜像时,请确保云服务器已完成相关配置,否则可能导致整机镜像创建云服务器失败。
  • 使用Windows操作系统云服务器制作整机镜像时,不允许云服务器存在跨区卷,否则制作的整机镜像创建云服务器时可能会导致数据丢失。
  • 使用Linux操作系统云服务器制作整机镜像时,不允许云服务器存在由多个物理卷组成的卷组、或由多个物理卷组成的逻辑卷,否则制作的整机镜像创建云服务器时可能会造成数据丢失。
  • 带有专属存储磁盘的云服务器不支持创建整机镜像。
  • 整机镜像不支持如下操作:不允许导出、复制、共享。
  • 使用Windows操作系统云服务器制作整机镜像时,需修改云服务器SAN策略为OnlineAll类型。否则可能导致使用镜像创建云服务器时,云服务器磁盘处于脱机状态。

    Windows操作系统SAN策略分为三种类型:OnlineAll、OfflineShared、OfflineInternal

    表1 Windows操作系统SAN策略类型

    类型

    说明

    OnlineAll

    表示所有新发现磁盘都置于在线模式。

    OfflineShared

    表示所有共享总线上(比如FC、ISCSI)的新发现磁盘都置于离线模式,非共享总线上的磁盘都置于在线模式。

    OfflineInternal

    表示所有新发现磁盘都置于离线模式。

    1. 运行cmd.exe,执行以下命令,使用DiskPart工具来查询云服务器当前的SAN策略。

      diskpart

    2. 执行以下命令查看云服务器当前的SAN策略。
      san
      • 如果SAN策略为OnlineAll,请执行exit命令退出DiskPart。
      • 否,请执行步骤3
    3. 执行以下命令修改云服务器SAN策略为OnlineAll。

      san policy=onlineall

约束与限制(使用云服务器备份制作整机镜像)

  • 创建整机镜像时,请确保创建该云服务器备份所属的弹性云服务器已完成相关配置,否则可能导致整机镜像创建云服务器失败。
  • 在云服务器关机状态下,制作整机镜像的过程中,用户不能启动云服务器。
  • 使用云服务器备份创建整机镜像时,不允许云服务器备份存在共享卷。
  • 使用云服务器备份创建整机镜像时,云服务器备份必须是可用状态,且每个云服务器备份只能创建一个整机镜像。
  • 整机镜像不支持如下操作:不允许导出、复制、共享。

约束与限制(使用云备份制作整机镜像)

  • 创建整机镜像前,请确保创建该云备份所属的弹性云服务器已完成相关配置,否则可能导致整机镜像创建云服务器失败。
  • 每个云备份只能创建一个整机镜像。
  • 在云服务器关机状态下,制作整机镜像的过程中,用户不能启动云服务器。
  • 整机镜像不支持如下操作:不允许导出、复制、共享。

URI

POST /v1/cloudimages/wholeimages/action

请求消息

  • 使用云服务器创建整机镜像的请求参数

    参数

    是否必选

    参数类型

    描述

    name

    String

    镜像名称。name参数说明请参考镜像属性

    description

    String

    镜像描述信息。description参数说明请参考镜像属性

    tags

    Array of strings

    镜像标签列表。默认为空。

    tags和image_tags只能使用一个。

    image_tags

    Array of objects

    新规范的镜像标签列表。默认为空。

    tags和image_tags只能使用一个。

    instance_id

    String

    云服务器ID。使用云服务器制作整机镜像时使用此参数。

    如何获取云服务器ID:

    1. 登录控制台。
    2. 选择“计算 > 弹性云服务器”。
    3. 云服务器列表栏,单击源云服务器名称,在详情页查看ID。

    enterprise_project_id

    String

    表示当前镜像所属的企业项目。

    • 取值为0或无该值,表示属于default企业项目。
    • 取值为UUID,表示属于该UUID对应的企业项目。

      关于企业项目ID的获取及企业项目特性的详细信息,请参考《企业管理用户指南》。

    max_ram

    Integer

    表示镜像支持的最大内存,单位为MB,默认不设置。

    min_ram

    Integer

    表示镜像支持的最小内存,单位为MB,默认为0。

    vault_id

    String

    表示云服务器待加入的或已加入的存储库的ID。

    可以从云备份服务控制台获取,或者参考《云备份接口参考》的“查询存储库列表”章节查询。

  • 使用云服务器备份或云备份创建整机镜像的请求参数

    参数

    是否必选

    参数类型

    描述

    name

    String

    镜像名称。name参数说明请参考镜像属性

    description

    String

    镜像描述信息。description参数说明请参考镜像属性

    tags

    Array of strings

    镜像标签列表。默认为空。

    tags和image_tags只能使用一个。

    image_tags

    Array of objects

    新规范的镜像标签列表。默认为空。

    tags和image_tags只能使用一个。

    backup_id

    String

    云服务器备份ID。

    云服务器备份ID或者云备份ID。

    如何获取云服务器备份ID:
    1. 登录管理控制台。
    2. 选择“存储 > 云服务器备份”。
    3. 在备份列表栏,展开备份详情,查看备份ID。
    如何获取云备份ID:
    1. 登录管理控制台。
    2. 选择“存储 > 云备份”。
    3. 在云服务器备份页面,单击“备份副本”页签,在备份列表中查看备份ID。

    enterprise_project_id

    String

    表示当前镜像所属的企业项目。

    • 取值为0或无该值,表示属于default企业项目。
    • 取值为UUID,表示属于该UUID对应的企业项目。

      关于企业项目ID的获取及企业项目特性的详细信息,请参考《企业管理用户指南》。

    max_ram

    Integer

    表示镜像支持的最大内存,单位为MB,默认不设置。

    min_ram

    Integer

    表示镜像支持的最小内存,单位为MB,默认为0,表示不受限制。

    whole_image_type

    String

    表示创建整机镜像的方式。

    • 若通过CBR服务的备份创建整机镜像,该参数必填,设置为CBR,此时,backup_id为云备份ID。
    • 若通过CSBS服务的备份创建整机镜像,该参数可为空,取默认值CSBS,此时,backup_id为云服务器备份ID。
  • 使用云备份创建整机镜像的请求参数

    参数

    是否必选

    参数类型

    描述

    name

    String

    镜像名称。name参数说明请参考镜像属性

    description

    String

    镜像描述信息。description参数说明请参考镜像属性

    tags

    Array of strings

    镜像标签列表。默认为空。

    tags和image_tags只能使用一个。

    image_tags

    Array of objects

    新规范的镜像标签列表。默认为空。

    tags和image_tags只能使用一个。

    backup_id

    String

    云备份ID。

    如何获取云备份ID:
    1. 登录管理控制台。
    2. 选择“存储 > 云备份”。
    3. 在云服务器备份页面,单击“备份副本”页签,在备份列表中查看备份ID。

    enterprise_project_id

    String

    表示当前镜像所属的企业项目。

    • 取值为0或无该值,表示属于default企业项目。
    • 取值为UUID,表示属于该UUID对应的企业项目。

      关于企业项目ID的获取及企业项目特性的详细信息,请参考《企业管理用户指南》。

    max_ram

    Integer

    表示镜像支持的最大内存,单位为MB,默认不设置。

    min_ram

    Integer

    表示镜像支持的最小内存,单位为MB,默认为0,表示不受限制。

    whole_image_type

    String

    表示创建整机镜像的方式,必须填写“CBR”。

请求示例

  • 使用云服务器制作整机镜像,其中,镜像标签数据格式为tags,虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    POST https://{Endpoint}/v1/cloudimages/wholeimages/action
    {
           "name": "instance_whole_image",
           "description": "云服务器制作镜像",
           "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a",
           "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600",
           "tags": [
               "aaa.111",
               "bbb.333",
               "ccc.444"
           ]
    }
    
  • 使用云服务器制作整机镜像,其中,镜像标签数据格式为image_tags,虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。
    1
    2
    3
    4
    5
    6
    7
    8
    POST https://{Endpoint}/v1/cloudimages/wholeimages/action
    {
           "name": "instance_whole_image",
           "description": "云服务器制作镜像",
           "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a",
           "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600",
           "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]
    } 
    
  • 使用云服务器备份云服务器备份或云备份制作整机镜像,其中,镜像标签数据格式为tags,备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    POST https://{Endpoint}/v1/cloudimages/wholeimages/action
    {
         "name": "backup_whole_image",
         "description": "云服务器备份云备份制作镜像",
         "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3",
         "whole_image_type": "CBR",
         "tags": [
               "aaa.111",
               "bbb.333",
               "ccc.444"
          ]
    }
    
  • 使用云服务器备份云服务器备份或云备份制作整机镜像,其中,镜像标签数据格式为image_tags,备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。
    1
    2
    3
    4
    5
    6
    7
    8
    POST https://{Endpoint}/v1/cloudimages/wholeimages/action
    {
         "name": "backup_whole_image",
         "description": "云服务器备份云备份制作镜像",
         "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3",
         "whole_image_type": "CBR",
         "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]
    }
    
  • 使用云备份制作整机镜像,其中,镜像标签数据格式为tags,备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    POST https://{Endpoint}/v1/cloudimages/wholeimages/action
    {
         "name": "backup_whole_image",
         "description": "云备份制作镜像",
         "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3",
         "whole_image_type": "CBR",
         "tags": [
               "aaa.111",
               "bbb.333",
               "ccc.444"
          ]
    }
    
  • 使用云备份制作整机镜像,其中,镜像标签数据格式为image_tags,备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。
    1
    2
    3
    4
    5
    6
    7
    8
    POST https://{Endpoint}/v1/cloudimages/wholeimages/action
    {
         "name": "backup_whole_image",
         "description": "云备份制作镜像",
         "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3",
         "whole_image_type": "CBR",
         "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}]
    }
    

响应消息

  • 响应参数

    参数

    参数类型

    描述

    job_id

    String

    异步任务ID。

    详情请参见异步任务查询

  • 响应样例
    STATUS CODE 200
    1
    2
    3
    {
        "job_id": "4010a32b5f909853015f90aaa24b0015"
    }
    

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误,具体返回错误码请参见错误码

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。