文档首页/ 镜像服务 IMS/ API参考/ API/ 镜像/ 制作整机镜像
更新时间：2024-12-20 GMT+08:00
查看PDF
分享

制作整机镜像

功能介绍

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

华为云不再提供Windows操作系统类型的镜像，该接口不再支持制作Windows整机镜像。

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

  • 创建整机镜像时，请确保云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。

    详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。

  • 使用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只能使用一个。

    image_tags数据结构说明请参见表2。

    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参数可不填。

    存储库ID可以从云备份服务控制台获取，或者参考“查询存储库列表”查询。
  • 使用云服务器备份或云备份创建整机镜像的请求参数

    参数

    是否必选

    参数类型

    描述

    name

    是

    String

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

    description

    否

    String

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

    tags

    否

    Array of strings

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

    tags和image_tags只能使用一个。

    image_tags

    否

    Array of objects

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

    tags和image_tags只能使用一个。

    image_tags数据结构说明请参见表2。

    backup_id

    是

    String

    云服务器备份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。
表2 image_tags数据结构说明

参数

是否必选

参数类型

描述

key

是

String

标签的键。

value

是

String

标签的值。

请求示例

  • 使用云服务器制作整机镜像，其中，镜像标签数据格式为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"}]
}

响应消息

  • 响应参数

    参数

    参数类型

    描述

    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

    服务不可用。
父主题： 镜像