文档首页 > > API参考> API> 镜像> 制作整机镜像

制作整机镜像

分享
更新时间: 2019/08/26 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。

    使用云服务器创建整机镜像的过程为:先创建一个备份,再将备份创建为整机镜像。如果这个备份为CBR,vault_id为必填项;如果备份为CSBS,vault_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,表示通过CBR服务的备份创建整机镜像。
    • 取值为CSBS,表示通过CSBS服务的备份创建整机镜像。
  • 请求样例
    • 使用云服务器制作整机镜像
      POST https://{Endpoint}/v1/cloudimages/wholeimages/action

      使用tags参数:

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      {
             "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参数:

      1
      2
      3
      4
      5
      6
      7
      {
             "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"}]
      } 
      
    • 使用云服务器备份或云备份制作整机镜像
      POST https://{Endpoint}/v1/cloudimages/wholeimages/action

      使用tags参数:

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      {
           "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参数:

      1
      2
      3
      4
      5
      6
      7
      {
           "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

    服务不可用。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区