请求示例 使用上传至OBS桶的外部镜像文件制作系统盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为tags。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "type": "E CS ", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用上传至OBS桶的外部镜像文件制作系统盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为image_tags。 1 2 3 4 5 6 7 8 9 10 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "type": "ECS", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } 使用上传至OBS桶的外部镜像文件制作数据盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为tags。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_type": "Linux", "min_disk": 40, "type": "DataImage", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用上传至OBS桶的外部镜像文件制作数据盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为image_tags。 1 2 3 4 5 6 7 8 9 10 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_type": "Linux", "min_disk": 40, "type": "DataImage", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }

功能介绍 使用上传至OBS桶中的超大外部镜像文件制作私有镜像，目前仅支持RAW或ZVHD2格式镜像文件。且要求镜像文件大小不能超过1TB。 由于快速导入功能要求提前转换镜像文件格式为RAW或ZVHD2格式，因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。

请求示例 更新镜像名称为ims_test。 1 2 3 4 5 6 7 8 PATCH https://{Endpoint}/v2/cloudimages/33ad552d-1149-471c-8190-ff6776174a00 [ { "op": "replace", "path": "/name", "value": "ims_test" } ]

响应消息 响应参数 参数 参数类型 描述 file String 镜像文件下载和上传链接。 owner String 镜像属于哪个租户。 id String 镜像ID。 size Long 目前暂时不使用。 self String 镜像链接信息。 schema String 镜像视图。 status String 镜像状态。取值如下： queued：表示镜像元数据已经创建成功，等待上传镜像文件。 saving：表示镜像正在上传文件到后端存储。 deleted：表示镜像已经删除。 killed：表示镜像上传错误。 active：表示镜像可以正常使用。 tags Array of strings 镜像标签列表，提供用户可以自定义管理私有镜像的能力。用户可以通过镜像标签接口为每个镜像增加不同的标签，在查询接口中可以根据标签进行过滤。 visibility String 是否被其他租户可见。取值如下： private：私有镜像 public：公共镜像 shared：共享镜像 name String 镜像名称。name参数说明请参考镜像属性。 checksum String 目前暂时不使用。 protected Boolean 是否是受保护的，受保护的镜像不允许删除。取值为true或false。 container_format String 容器类型。 min_ram Integer 镜像运行需要的最小内存，单位为MB。参数取值依据云服务器的规格限制，默认设置为0。 云服务器的规格限制，请参见规格清单。 max_ram String 镜像支持的最大内存，单位为MB。参数取值可以参考云服务器的规格限制，默认不设置。 云服务器的规格限制，请参见规格清单。 updated_at String 更新时间。格式为UTC时间。 __os_bit String 操作系统位数，一般取值为“32”或者“64”。 __os_version String 操作系统具体版本。 __description String 镜像描述信息。_description参数说明请参考镜像属性。 disk_format String 镜像格式，目前支持zvhd2、vhd、zvhd、raw、qcow2、iso。非iso格式时默认值是zvhd2。 __isregistered String 是否是注册过的镜像，取值为“true”或者“false”。 __platform String 镜像平台分类，取值为Windows、Ubuntu、Red Hat、SUSE、CentOS、Debian、OpenSUSE、Oracle Linux、Fedora、Other、CoreOS、EulerOS。 __os_type String 操作系统类型，目前取值Linux、Windows、Other。 __system__cmkid String 加密镜像所使用的密钥ID。 min_disk Integer 镜像运行需要的最小磁盘容量，单位为GB 。linux操作系统取值为10～1024GB，Windows操作系统取值为20～1024GB。 virtual_env_type String 镜像使用环境类型：FusionCompute、Ironic、DataImage、IsoImage。 如果是云服务器镜像（即系统盘镜像），则取值为FusionCompute。 如果是数据盘镜像，则取值是DataImage。 如果是裸金属服务器镜像，则取值是Ironic。 如果是ISO镜像，则取值是IsoImage。 __image_source_type String 镜像后端存储类型，目前只支持uds。 __imagetype String 镜像类型，目前支持： 公共镜像（gold） 私有镜像（private） 共享镜像（shared） 市场镜像（market） created_at String 创建时间。格式为UTC时间。 __image_displayname String 对外展示名称。 virtual_size Integer 目前暂时不使用。 __originalimagename String 父镜像ID。 公共镜像或通过文件创建的私有镜像，取值为空。 __backup_id String 备份ID。如果是备份创建的镜像，则填写为备份的ID，否则无此参数。 __productcode String 市场镜像的产品ID。 __image_size String 镜像文件的大小，单位为字节。必须大于0。 __data_origin String 镜像来源。 公共镜像为空。 __root_origin String 表示当前镜像来源是从外部导入。取值：file。 __lazyloading String 镜像是否支持延迟加载。取值为true、false、True或False。 active_at String 镜像状态变为正常的时间。 __os_feature_list String 镜像附加属性。该属性采用JSON格式来标识镜像支持的高级特性清单。 __account_code String 收费镜像标识。 hw_firmware_type String 云服务器的启动方式。目前支持： bios：表示bios引导启动。如果无此参数，表示bios启动方式。 uefi：表示uefi引导启动。 说明： 当镜像的架构类型为ARM时，启动方式只支持uefi。 hw_vif_multiqueue_enabled String 镜像是否支持网卡多队列。取值为“true”或者“false”。 __support_kvm String 如果镜像支持KVM，取值为true，否则无需增加该属性。 __support_xen String 如果镜像支持XEN，取值为true，否则无需增加该属性。 __support_largememory String 表示该镜像是否支持超大内存特性。如果镜像支持超大内存，取值为true，否则无此属性。 镜像操作系统类型请参考“弹性云服务器类型与支持的操作系统版本”。 __support_diskintensive String 表示该镜像是否支持密集存储性特性。如果镜像支持密集存储性能，则值为true，否则无此属性。 __support_highperformance String 表示该镜像是否支持高计算性能的特性。如果镜像支持高计算性能，则值为true，否则无此属性。 __support_xen_gpu_type String 表示该镜像是支持XEN虚拟化平台下的GPU类型，取值参考表2。如果不支持，则无此属性。该属性与“__support_xen”和“__support_kvm”属性不共存。 __support_kvm_gpu_type String 表示该镜像是支持KVM虚拟化平台下的GPU类型，取值参考表3。 如果不支持，则无此属性。该属性与“__support_xen”和“__support_kvm”属性不共存。 __support_xen_hana String 如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无此属性。 该属性与“__support_xen”和“__support_kvm”属性不共存。 __support_kvm_infiniband String 如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无此属性。 该属性与“__support_xen”属性不共存。 __system_support_market Boolean 表示当前镜像是否支持发布为市场镜像。 true：支持 false：不支持 __is_offshelved String 表示当前市场镜像是否下架。 true：已下架 false：未下架 enterprise_project_id String 表示当前镜像所属的企业项目。 取值为0或无该值，表示属于default企业项目。 取值为UUID，表示属于该UUID对应的企业项目。 关于企业项目特性的详细信息，请参考“企业中心总览”。 __sequence_num String 表示当前镜像对应云服务器的系统盘插槽位置。 目前暂不使用。 __support_fc_inject String 表示当前镜像支持Cloud-Init密码/密钥注入方式。 如果取值为“true”，表示该镜像不支持Cloud-Init注入密码/密钥，其他取值时表示支持Cloud-Init注入密钥/密码。 说明： 该特性参数只对ECS系统盘镜像生效，其他类型镜像不生效。 __support_arm String 是否为ARM架构类型的镜像。取值为“true”或者“false”。 __support_agent_list String 镜像是否支持主机安全或主机监控。 hss：主机安全 ces：主机监控 取值样例： "__support_agent_list": "hss,ces" 说明： 如果查询结果无此字段，表示镜像不支持主机安全或主机监控。 __support_amd String 是否是AMD架构类型的镜像。取值为“true”或者“false”。 __support_kvm_hi1822_hisriov String 如果镜像支持sriov直通，取值为true，否则无需增加该属性。 __support_kvm_hi1822_hivirtionet String 如果镜像支持Virtio-net直通规格，取值为true，否则无需增加该属性。 响应样例 STATUS CODE 200 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 { "file": "/v2/images/33ad552d-1149-471c-8190-ff6776174a00/file", "owner": "0b1e494e2660441a957313163095fe5c", "id": "33ad552d-1149-471c-8190-ff6776174a00", "size": 2, "self": "/v2/images/33ad552d-1149-471c-8190-ff6776174a00", "schema": "/v2/schemas/image", "status": "active", "tags": [], "visibility": "private", "name": "ims_test", "checksum": "99914b932bd37a50b983c5e7c90ae93b", "hw_vif_multiqueue_enabled": "true", "protected": false, "container_format": "bare", "min_ram": 0, "updated_at": "2015-12-08T02:30:49Z", "__os_bit": "64", "__os_version": "Ubuntu 14.04 server 64bit", "__description": "ims test", "disk_format": "vhd", "__isregistered": "true", "__platform": "Ubuntu", "__os_type": "Linux", "min_disk": 40, "virtual_env_type": "FusionCompute", "__image_source_type": "uds", "__imagetype": "private", "created_at": "2015-12-04T09:45:33Z", "virtual_size": 0, "__originalimagename": "33ad552d-1149-471c-8190-ff6776174a00", "__backup_id": "", "__productcode": "", "__image_size": "449261568", "__support_fc_inject":"true", "__data_origin": null, "hw_firmware_type": "bios" }

请求消息 请求参数 参数 是否必选 参数类型 描述 [数组] 是 Array of objects 详情请参见表2。 表2 [数组]字段说明 参数 是否必选 参数类型 描述 op 是 String 操作类型，目前取值为add、replace和remove。 path 是 String 需要操作的属性名称，需要在属性名称前加“/”。 目前用户可以修改以下属性： name：镜像名称。 __description：镜像描述。 __support_kvm：支持kvm虚拟化。 __support_xen：支持xen虚拟化。 __support_largememory：表示该镜像支持超大内存。如果镜像支持超大内存，取值为true，否则无需增加该属性。 __support_diskintensive：支持密集存储。 __support_highperformance：支持高性能计算。 __support_xen_gpu_type：支持xen虚拟化gpu类型。 __support_kvm_gpu_type：支持kvm虚拟化gpu类型。 __support_xen_hana：如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无需添加该属性。该属性与“__support_xen”和“__support_kvm”属性不共存。 __is_config_init：是否完成初始化配置。 enterprise_project_id：企业项目ID。 min_ram：镜像支持的最小内存，单位为MB。取值可以参考云服务器规格限制，一般不设置。 max_ram：镜像支持的最大内存，单位为MB。取值可以参考云服务器规格限制，一般不设置。 hw_vif_multiqueue_enabled：支持网卡多队列。 hw_firmware_type：启动方式，取值为bios或uefi。 __support_kvm_infiniband：如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无需添加该属性。该属性与“__support_xen”属性不共存。 __support_fc_inject：表示当前镜像支持Cloud-Init密码/密钥注入方式。如果取值为“true”，表示该镜像不支持Cloud-Init注入密码/密钥，其他取值时表示支持Cloud-Init注入密钥/密码。 __support_amd：是否是AMD架构类型的镜像。取值为“true”或者“false”。 __support_kvm_hi1822_hisriov：如果镜像支持sriov直通，取值为true，否则无需增加该属性。 __support_kvm_hi1822_hivirtionet：如果镜像支持Virtio-net直通规格，取值为true，否则无需增加该属性。 用户可以自定义添加或者删除一些自有的扩展属性。 value 是 String 需要操作的属性的值。参数说明请参考镜像属性。

请求示例 使用云服务器制作系统盘镜像，其中，镜像标签数据格式为tags，虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "云服务器制作系统盘镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用云服务器数据盘制作数据盘镜像，其中，镜像标签数据格式为tags，卷ID为“c5dfbd0c-bf0a-4798-a453-61dc6b54aa30”。 1 2 3 4 5 6 7 8 9 10 11 12 POST https://{Endpoint}/v2/cloudimages/action { "data_images": [{"name": "ims_data_image_test", "description": "云服务器数据盘制作数据盘镜像", "volume_id": "c5dfbd0c-bf0a-4798-a453-61dc6b54aa30", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] }] } 使用上传至OBS桶中的外部镜像文件制作镜像，其中，镜像标签数据格式为tags，OBS桶中外部镜像文件地址为“ims-image:centos70.qcow2”。 1 2 3 4 5 6 7 8 9 10 11 12 13 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.qcow2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用云服务器制作系统盘镜像，其中，镜像标签数据格式为image_tags，虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "云服务器制作系统盘镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "image_tags": [ { "key": "key2", "value": "value2" }, { "key": "key1", "value": "value1" } ] } 使用云服务器数据盘制作数据盘镜像，其中，镜像标签数据格式为image_tags，卷ID为“c5dfbd0c-bf0a-4798-a453-61dc6b54aa30”。 1 2 3 4 5 6 7 8 POST /v2/cloudimages/action { "data_images": [{"name": "ims_data_image_test", "description": "云服务器数据盘制作数据盘镜像", "volume_id": "c5dfbd0c-bf0a-4798-a453-61dc6b54aa30", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }] } 使用上传至OBS桶中的外部镜像文件制作镜像，其中，镜像标签数据格式为image_tags，OBS桶中外部镜像文件地址为“ims-image:centos70.qcow2”。 1 2 3 4 5 6 7 8 9 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.qcow2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } 使用数据盘制作系统盘镜像，其中，镜像标签数据格式为tags，卷ID为 "877a2cda-ba63-4e1e-b95f-e67e48b6129a"。 1 2 3 4 5 6 7 8 9 10 11 12 13 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "数据盘制作系统盘镜像", "volume_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "type": "ECS", "os_version": "CentOS 7.0 64bit", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用数据盘制作系统盘镜像，其中，镜像标签数据格式为image_tags，卷ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 1 2 3 4 5 6 7 8 9 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "数据盘制作系统盘镜像", "volume_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "type": "ECS", "os_version": "CentOS 7.0 64bit", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }

约束与限制 使用外部镜像文件制作镜像 外部镜像文件的限制请参见“准备镜像文件（Windows）”或“准备镜像文件（Linux）”。 使用数据盘创建系统盘镜像 使用数据盘制作系统盘镜像时，需确保该数据盘中有操作系统，且操作系统已提前完成优化步骤。如何优化，请参见优化私有镜像（Windows）和优化私有镜像（Linux）。 由于系统无法校验您在调用该接口时指定的卷是否存在操作系统，因此制作系统盘镜像时，请务必确保您输入的os_version（操作系统版本）值合法，具体请参见相关参数取值列表。

约束与限制（使用云服务器制作整机镜像） 创建整机镜像时，请确保云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。 详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。 使用Windows操作系统云服务器制作整机镜像时，不允许云服务器存在跨区卷，否则制作的整机镜像创建云服务器时可能会导致数据丢失。 使用Linux操作系统云服务器制作整机镜像时，不允许云服务器存在由多个物理卷组成的卷组、或由多个物理卷组成的逻辑卷，否则制作的整机镜像创建云服务器时可能会造成数据丢失。 带有专属分布式存储磁盘的云服务器不支持创建整机镜像。 不支持将整机镜像发布为市场镜像。 不支持将整机镜像导出到本地使用。 不支持同区域内复制整机镜像。 跨区域复制整机镜像各区域存在差异，请以控制台界面显示为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。 使用Windows操作系统云服务器制作整机镜像时，需修改云服务器SAN策略为OnlineAll类型。否则可能导致使用镜像创建云服务器时，云服务器磁盘处于脱机状态。 Windows操作系统SAN策略分为三种类型：OnlineAll、OfflineShared、OfflineInternal 表1 Windows操作系统SAN策略类型 类型 说明 OnlineAll 表示所有新发现磁盘都置于在线模式。 OfflineShared 表示所有共享总线上（比如FC、ISCSI）的新发现磁盘都置于离线模式，非共享总线上的磁盘都置于在线模式。 OfflineInternal 表示所有新发现磁盘都置于离线模式。 运行cmd.exe，执行以下命令，使用DiskPart工具来查询云服务器当前的SAN策略。 diskpart 执行以下命令查看云服务器当前的SAN策略。 san 如果SAN策略为OnlineAll，请执行exit命令退出DiskPart。 否，请执行步骤3。 执行以下命令修改云服务器SAN策略为OnlineAll。 san policy=onlineall

约束与限制（使用云服务器备份制作整机镜像） 创建整机镜像时，请确保创建该云服务器备份所属的弹性云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。 详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。 在云服务器关机状态下，制作整机镜像的过程中，用户不能启动云服务器。 使用云服务器备份创建整机镜像时，不允许云服务器备份存在共享卷。 使用云服务器备份创建整机镜像时，云服务器备份必须是可用状态，且每个云服务器备份只能创建一个整机镜像。 不支持将整机镜像发布为市场镜像。 不支持将整机镜像导出到本地使用。 不支持同区域内复制整机镜像。 跨区域复制整机镜像各区域存在差异，请以控制台界面显示为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。

约束与限制（使用云备份制作整机镜像） 创建整机镜像前，请确保创建该云备份所属的弹性云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。 详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。 每个云备份只能创建一个整机镜像。 在云服务器关机状态下，制作整机镜像的过程中，用户不能启动云服务器。 通过云备份创建的整机镜像可以共享给其他租户。但是，如果这个云备份是由其他租户共享的，那么创建的整机镜像不支持共享。 不支持将整机镜像发布为市场镜像。 不支持将整机镜像导出到本地使用。 不支持同区域内复制整机镜像。 跨区域复制整机镜像各区域存在差异，请以控制台界面显示为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。

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

共享过程 用户A作为共享镜像提供者，用户B作为共享镜像接受者时，用户A将私有镜像共享给用户B的具体流程如下： 用户B提供自己的项目ID或者账号ID或者组织URN给用户A。 项目ID和账号ID获取请参考项目ID和账号ID，组织URN获取请参考查看组织详细信息。 用户A共享指定的镜像给用户B。 用户B确认接受用户A的共享镜像。 用户B可以使用用户A共享的镜像，完成创建云服务器等操作。 如果基于账号ID或者组织共享镜像，则用户B无需接受即可使用。

约束与限制 用户只能共享自己没有发布为市场镜像的私有镜像，已经发布为市场镜像的不能共享。 镜像支持共享到同一区域内的其他租户。如果您需要共享到不同区域，请先复制镜像到目标区域后再共享。 系统盘镜像和数据盘镜像最多可以共享给128个租户或者项目或者组织，整机镜像最多可以共享给10个租户或者项目或者组织。 基于账号ID或者组织共享镜像目前仅在部分区域支持，具体请以控制台显示为准。 只有通过云备份，或云服务器（未通过旧版CSBS服务生成备份）创建的整机镜像，才支持共享。

安装virtio驱动 以使用“virtio-win-0.1.189-1”版本中的“virtio-win-gt-x64.msi”驱动为例介绍安装步骤。 VNC登录Windows云服务器。 登录云服务器的详细操作请参见“Windows弹性云服务器登录方式概述”。 必须通过VNC方式登录云服务器，不可使用远程桌面登录方式，因为安装时会更新网卡驱动，远程桌面登录时网卡正在使用，从而导致安装不成功。 根据相关软件及获取方式下载virtio驱动版本。 图1 下载驱动 下载完成后，右键单击“virtio-win-gt-x64.msi”，并选择“以管理员身份运行”，根据界面提示完成安装。 图2 单击RUN 图3 单击Next 图4 勾选协议 选择安装的virtio驱动。如下图，本次选择安装全部的virtio驱动，也可以选择安装所需的virtio驱动。 图5 选择安装的驱动 图6 单击安装 等待程序安装完成。 图7 安装中 安装完成后根据提示重启操作系统。 图8 安装完成 图9 重启提示 重启完成后请执行验证安装成功，验证virtio驱动是否安装成功。

UltraISO软件操作步骤 下载UltraISO，并安装至本地。 下载地址：https://www.ultraiso.com/ 下载virtio驱动。 下载地址：https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso 其他版本获取地址如下： https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/ 使用UltraISO打开ISO文件，如图1所示。 图1 打开ISO文件 ISO格式的镜像文件请使用UltraISO工具打开，请勿使用普通压缩工具打开，否则会丢失ISO的引导数据。 将下载的virtio驱动文件整体拖到ISO文件父节点下。 在UltraISO中，将已集成virtio驱动的ISO文件另存为iso格式，导出至本地。