华为云用户手册

约束与限制 每个标签由键值对组成，标签的key的长度不超过36个字符，value的长度不超过43个字符。key不能为空或者空白字符串，value不能为空，但可以是空白字符串。 单个镜像最多添加10个标签。 请求体中的多个标签的key不允许重复。 此接口为幂等接口： 创建时，如果创建的标签已经存在，即key相同而value不同，则更新对应标签；如果创建的标签已经存在，key/value均相同，则不进行重复添加，视为添加成功。 删除时，如果指定的标签不存在，则默认视为删除成功。 批量删除时对key、value的限制： 删除时，对标签的key、value不做字符集范围校验，key不允许为空或空白字符串；value为可选，且不对value做校验。如果要删除的标签不存在，视为删除成功，不报错。删除时，对标签的key、value做长度校验，标签的key不超过127，value不超过255。

请求示例 批量添加镜像标签，其中，标签键为“key1”对应的值为“value1”、标签键为“key2”对应的值为“value2”。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/action { "tags": [{ "value": "value1", "key": "key1" }, { "value": "value2", "key": "key2" }, { "value": "", "key": "key3" }], "action": "create" } 批量删除镜像标签，其中，标签键为“key1”对应的值为“value1”、标签键为“key2”对应的值为“value2”。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/action { "tags": [{ "value": "value1", "key": "key1" }, { "value": "value2", "key": "key2" }, { "value": "", "key": "key3" }], "action": "delete" }

URI PUT /v1/cloudimages/{image_id}/upload 参数说明请参见表1。 表1 参数说明 参数 是否必选 参数类型 描述 image_id 是 String 镜像ID。 image_id为用户调用创建镜像元数据接口所创建出来镜像的id，使用其他方式创建的镜像id会导致注册失败。 注册接口调用成功后，请根据镜像id查询镜像的状态。镜像状态变为active表示镜像注册成功，详情请参见查询镜像详情（OpenStack原生）。

功能介绍 该接口用于将镜像文件注册为云平台未初始化的私有镜像。 使用该接口注册镜像的具体步骤如下： 将镜像文件上传到OBS个人桶中。具体操作请参见“上传文件或文件夹”。 使用创建镜像元数据接口创建镜像元数据。调用成功后，保存该镜像的ID。创建镜像元数据请参考创建镜像元数据（OpenStack原生）。 根据2得到的镜像ID，使用注册镜像接口注册OBS桶中的镜像文件。 注册镜像接口作为异步接口，调用成功后，说明后台收到了注册请求。需要根据镜像ID查询该镜像状态验证镜像注册是否成功。当镜像状态变为“active”时，表示镜像注册成功。 如何查询异步任务，请参见异步任务查询。 注册镜像前请确保用户已拥有对象存储服务的Tenant Administrator权限。

响应消息 响应参数 参数 参数类型 描述 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 。取值为40～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时间。 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”。 响应样例 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" }

请求示例 更新镜像名称为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" } ]

请求消息 请求参数 参数 是否必选 参数类型 描述 [数组] 是 Array of objects 详情请参见表2。 表2 [数组]字段说明 参数 是否必选 参数类型 描述 op 是 String 操作类型，目前取值为add、replace和remove。 path 是 String 需要操作的属性名称，需要在属性名称前加“/”。 目前用户可以修改以下属性： name：镜像名称 __description：镜像描述 __support_kvm：支持kvm虚拟化 __support_xen：支持xen虚拟化 __support_diskintensive：支持密集存储 __support_highperformance：支持高性能计算 __support_xen_gpu_type：支持xen虚拟化gpu类型 __support_kvm_gpu_type：支持kvm虚拟化gpu类型 __is_config_init：是否完成初始化配置 enterprise_project_id：企业项目ID min_ram：最小内存 hw_vif_multiqueue_enabled：支持网卡多队列 hw_firmware_type：启动方式，取值为bios或uefi 用户可以自定义添加或者删除一些自有的扩展属性。 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"}] }

约束与限制（使用云服务器制作整机镜像） 创建整机镜像时，请确保云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。 详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。 使用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标签数据格式，增加或修改标签。 1 2 3 4 5 PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" } 使用image_tag标签数据格式，增加或修改标签。 1 2 3 4 5 PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1", "image_tag": {"key":"key1","value":"value1"} }

请求消息 请求参数 参数 是否必选 参数类型 描述 image_id 是 String 镜像ID。 如何获取镜像ID，请参见查询镜像列表。 tag 否 String 标签数据。 tag和image_tag只能使用一个。 image_tag 否 Object 新规范的镜像标签列表。image_tag参数说明请参考镜像标签数据格式。默认为空。 tag和image_tag只能使用一个。 表1 image_tag数据结构说明 参数 是否必选 参数类型 描述 key 是 String 标签的键。 value 是 String 标签的值。

请求示例 跨Region复制镜像，其中，目的区域的Region ID为“region-1”、目的区域的项目名称为“project-1”。 1 2 3 4 5 6 7 8 POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/cross_region_copy { "name":"test-copy-1001-4", "description":"test", "region":"region-1", "project_name":"project-1", "agency_name":"ims_copy_image" } 跨Region复制整机镜像，其中，目的区域的Region ID为“region-1”、目的区域的项目名称为“project-1”、存储库ID为“6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61”。 1 2 3 4 5 6 7 8 9 POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/cross_region_copy { "name":"test-copy-1001-4", "description":"test", "region":"region-1", "project_name":"project-1", "agency_name":"ims_copy_image", "vault_id":"6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61" }

响应消息 响应参数 参数 参数类型 描述 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 。取值为40～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时间。 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”属性不共存。 __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”。 __image_location String 镜像的存储位置。 __is_config_init String 是否完成了初始化配置。取值为“true”或者“false”。 __support_amd String 是否是AMD架构类型的镜像。取值为“true”或者“false”。 __support_agent_list String 镜像是否支持企业主机安全或主机监控。 hss：企业主机安全 企业主机安全（Host Security Service，HSS）是提升服务器整体安全性的服务，通过主机管理、风险防御、入侵检测、安全运营、网页防篡改功能，可全面识别并管理云服务器中的信息资产，实时监测云服务器中的风险，降低服务器被入侵的风险。 ces：主机监控 监控是保持弹性云服务器可靠性、可用性和性能的重要部分，通过监控，用户可以观察弹性云服务器资源。为使用户更好地掌握自己的弹性云服务器运行状态，云服务平台提供了云监控。您可以使用该服务监控您的弹性云服务器，执行自动实时监控、告警和通知操作，帮助您更好地了解弹性云服务器的各项性能指标。 取值样例： "__support_agent_list": "hss,ces" 说明： 如果查询结果无此字段，表示镜像不支持企业主机安全或主机监控。 响应样例 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 { "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", "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", "__data_origin": null, "hw_firmware_type":"bios" }

请求示例 通过V2.1版本更新镜像名称为ims_test01。 1 2 3 4 5 6 7 8 9 PATCH https://{Endpoint}/v2/images/33ad552d-1149-471c-8190-ff6776174a00 "Content-Type:application/openstack-images-v2.1-json-patch" [ { "op": "replace", "path": "/name", "value": "test01" } ] 通过V2.0版本更新镜像名称为ims_test01。 1 2 3 4 5 6 7 8 PATCH https://{Endpoint}/v2/images/33ad552d-1149-471c-8190-ff6776174a00 "Content-Type:application/openstack-images-v2.0-json-patch" [ { "replace": "/name", "value": "test01" } ]

请求消息 请求参数 Glance有两种方式的更新操作，通过http header里的Content-Type指定，当前支持“application/openstack-images-v2.0-json-patch”、“application/openstack-images-v2.1-json-patch”两种Content-Type。不同的Content-Type区别只是请求消息体格式不同。 表2 v2.1版本请求消息体 参数 是否必选 参数类型 描述 [数组] 是 Array of objects 详情请参见表3。 表3 [数组]字段说明 参数 参数类型 是否必选 描述 op String 是 所需进行的更新操作的类型：替换、添加、删除。 取值范围：replace、add、remove path String 是 所要操作的属性名称。 replace和remove操作取值只能是镜像当前已有的属性；add操作取值可以为当前已有属性和不存在的属性，如果为已有属性则执行效果同replace，如果是不存在的属性则执行add，需要在属性名称前加“/”。 value String 否 所需更新/添加属性的值。 根据op的value决定，replace、add需要指定，remove不需要 表4 v2.0版本请求消息体 参数 是否必选 参数类型 描述 [数组] 是 Array of objects 详情请参见表5。 表5 [数组]字段说明 参数 参数类型 是否必选 描述 replace String 取值三选一 key为replace表示替换镜像的相关属性，值为所要替换的属性需要在属性名称前加“/” add String key为add表示添加镜像属性，值为所要添加的属性名称，需要在属性名称前加“/” remove String key为remove表示删除镜像属性，值为所要删除的属性名称需要在属性名称前加“/” value String 根据前面的key决定，replace和add需要指定，remove不需要。 所需更新/添加的属性的值。参数说明请参考镜像属性。

请求示例 批量更新镜像成员状态，其中，镜像状态为“接受共享镜像”。 1 2 3 4 5 6 7 8 9 PUT https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "project_id": "edc89b490d7d4392898e19b2deb34797", "status": "accepted" } 批量更新通过CBR创建的整机镜像成员状态，其中，镜像状态为“接受共享镜像”，存储库ID为“d14r5tef-1bc3-4c4f-823e-3e471rg65e65” 1 2 3 4 5 6 7 8 9 10 PUT https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "project_id": "edc89b490d7d4392898e19b2deb34797", "status": "accepted", "vault_id": "d14r5tef-1bc3-4c4f-823e-3e471rg65e65" }

请求消息 请求参数 参数 是否必选 参数类型 描述 images 是 Array of strings 镜像ID列表。 project_id 是 String 项目ID。 status 是 String 镜像成员的状态。 取值如下： accepted：表示接受共享镜像。接受后，该镜像在用户镜像列表中可见，用户可以使用该镜像创建云服务器。 rejected：表示拒绝共享镜像。拒绝后，该镜像在用户镜像列表中不可见，但是，用户仍然可以使用该镜像创建云服务器。 vault_id 否 String 存储库ID。 如果是通过CBR创建的整机镜像，则在接受该共享镜像时，为必选参数，需传入该值。 存储库ID可以从云备份服务控制台获取，或者参考“查询存储库列表”查询。

请求示例 添加镜像标签，其中，标签键为“key1”对应的值为“value1”。 1 2 3 4 5 6 7 POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags { "tag": { "value": "value1", "key": "key1" } }

请求示例 批量删除镜像成员，其中，镜像ID为“d164b5df-1bc3-4c3f-893e-3e471fd16e64”、“0b680482-acaa-4045-b14c-9a8c7dfe9c70”，项目ID为"9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797"。 1 2 3 4 5 6 7 8 9 10 11 DELETE https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "projects": [ "9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797" ] }

请求消息 请求参数 参数 是否必选 参数类型 描述 __os_version 否 String 镜像的操作系统具体版本，取值范围见相关参数取值列表。 如果未指定__os_version，则默认设置为Other Linux (64 bit)，不保证该镜像能成功创建虚拟机以及通过该镜像创建的虚拟机能够正常使用。 visibility 否 String 其他租户是否可见。 默认取值为private。创建镜像元数据时，visibility取值只能为private。 name 否 String 镜像名称，如果未指定name的取值，则默认为空，但是使用该镜像创建虚拟机会失败。名称的长度为1～255位。name参数说明请参考镜像属性。默认值为空。 protected 否 Boolean 镜像是否被保护，保护后的镜像不可删除。默认取值为false。 container_format 否 String 容器格式。 默认取值为bare。 disk_format 否 String 镜像格式，目前支持zvhd2、vhd、raw、qcow2、iso。非iso格式时默认值是zvhd2。 tags 否 Array of strings 镜像标签列表。长度为1～255位。默认为空。 说明： tag中key的赋值方式为 "key=value"。例如： "tagkey=tagvalue" min_ram 否 Integer 镜像运行需要的最小内存，单位为MB。参数取值依据云服务器的规格限制。默认取值为0。 云服务器的规格限制，请参见规格清单。 min_disk 否 Integer 镜像运行需要的最小磁盘，单位为GB 。取值为40～1024GB。 必须大于镜像系统盘容量，否则创建云服务器可能失败。

响应消息 响应参数 参数 参数类型 描述 visibility String 其他租户是否可见。取值为private。 name String 镜像名称，如果未指定name的取值，则默认为空，但是使用该镜像创建虚拟机会失败。名称的长度为1～128位。name参数说明请参考镜像属性。 protected Boolean 镜像是否被保护，保护后的镜像不可删除。取值为false。 container_format String 容器格式。 取值为bare。 disk_format String 镜像格式，目前支持zvhd2、vhd、raw、qcow2、iso。非iso格式时默认值是zvhd2。。 tags Array of strings 镜像标签列表。长度为1～255位。 min_ram Integer 镜像运行最小内存，单位为MB。取值参考ECS规格限制，一般设置为0。 云服务器的规格限制，请参见规格清单。 min_disk Integer 镜像运行需要的最小磁盘容量，单位为GB 。取值为40～1024GB。必须大于镜像系统盘容量，否则创建云服务器可能失败。 status String 镜像状态。取值如下： queued：表示镜像元数据已经创建成功，等待上传镜像文件。 saving：表示镜像正在上传文件到后端存储。 deleted：表示镜像已经删除。 killed：表示镜像上传错误。 active：表示镜像可以正常使用。 created_at String 创建时间。格式为UTC时间。 updated_at String 更新时间。格式为UTC时间。 self String 本镜像链接。 id String 镜像ID。用户调用创建镜像接口后，需保存该镜像的ID，用来调用上传镜像接口完成镜像上传。 file String 上传下载镜像文件的地址链接。 schema String 视图链接。 __image_source_type String 镜像后端存储类型，目前支持uds。 __image_size String 镜像大小。单位为字节。 __isregistered String 镜像是否注册。只有已注册的镜像才能在Portal界面上查询到。取值为true。 __os_version String 镜像的操作系统具体版本，取值范围见相关参数取值列表。 __os_type String 镜像的操作系统类型，取值由__os_version确定。支持Windows、Linux、other。 __platform String 表示镜像支持的操作系统平台。取值由__os_version确定。 __os_bit String 表示操作系统位数。取值由__os_version确定，取值为32或64。 __imagetype String 镜像类型。取值为private，表示私有镜像。 virtual_env_type String 平台类型。 镜像使用环境类型：FusionCompute、Ironic、DataImage、IsoImage。 如果是云服务器镜像，则取值为FusionCompute。 如果是数据盘镜像，则取值为DataImage。 如果是裸金属服务器镜像，则取值为Ironic。 如果是ISO镜像，则取值是IsoImage。 owner String 镜像所属项目ID。 __root_origin String 表示当前镜像来源是从外部导入。取值：file。 checksum String 镜像文件md5值。 size Long 目前暂时不使用。 virtual_size Integer 镜像虚拟大小。单位为字节。 properties Properties object 镜像属性的集合，不表示具体的镜像属性。 响应样例 STATUS CODE 201 { "schema": "/v2/schemas/image", "min_disk": 100, "created_at": "2016-06-02T07:49:48Z", "__image_source_type": "uds", "container_format": "bare", "__image_size": "0", "file": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86/file", "updated_at": "2016-06-02T07:49:49Z", "protected": false, "id": "4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86", "__isregistered": "true", "min_ram": 1024, "owner": "b912fb4a4c464b568ecfca1071b21b10", "__os_type": "Linux", "__imagetype": "private", "visibility": "private", "virtual_env_type": "FusionCompute", "tags": [ "test=testvalue", "image=imagevalue" ], "__platform": "Ubuntu", "__os_bit": "64", "__os_version": "Ubuntu 14.04 server 64bit", "name": "test", "self": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86", "disk_format": "vhd", "status": "queued" }

请求示例 创建镜像元数据，其中，镜像操作系统为“Ubuntu 14.04 server 64bit”，容器格式为“bare”、镜像格式为“vhd”、镜像运行需要的最小磁盘为100GB、镜像运行需要的最小内存为1024MB。 POST https://{Endpoint}/v2/images { "__os_version": "Ubuntu 14.04 server 64bit", "container_format": "bare", "disk_format": "vhd", "min_disk": 100, "min_ram": 1024, "name": "test", "tags": [ "test=testvalue", "image=imagevalue" ], "visibility": "private", "protected": false }

请求示例 按照标签和总条数返回查询条件，查询镜像。 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 POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/resource_instances/action { "action": "count", "matches": [{ "key": "resource_name", "value": "test100" }], "tags": [ { "key": "key3", "values": ["valueXX"] }], "tags_any": [ { "key": "key0", "values": ["valueXX"] }], "not_tags": [ { "key": "key9", "values": ["value9"] }], "not_tags_any": [{ "key": "key7", "values": ["value7"] }] } 按照标签和分页查询条件，查询镜像。 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 POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/resource_instances/action { "action": "filter", "limit": "1", "offset": "0", "matches": [{ "key": "resource_name", "value": "test100" }], "tags": [ { "key": "key3", "values": ["valueXX"] }], "tags_any": [ { "key": "key0", "values": ["valueXX"] }], "not_tags": [ { "key": "key9", "values": ["value9"] }], "not_tags_any": [{ "key": "key7", "values": ["value7"] }] }

响应消息 响应参数 参数 参数类型 描述 resources Array of resource objects 镜像信息列表 total_count Integer 总记录数 表7 resource字段数据结构说明 参数 参数类型 描述 resource_id String 镜像ID resource_detail ResourceDetail object 镜像详情 tags Array of Tags objects 镜像的标签列表 resource_name String 镜像名称 表8 ResourceDetail object 名称 类型 必选 描述 status string 是 镜像状态 表9 resource_tag字段数据结构说明 参数 参数类型 描述 key String 标签的键 value String 标签的值 响应样例 action为count时的响应示例 STATUS CODE 200 1 2 3 { "total_count": 36 } action为filter时的响应示例 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 39 40 41 42 43 44 45 46 47 48 { "total_count": 36, "resources": [{ "resource_name": "test10002", "resource_detail": {"status": "active"}, "tags": [{ "value": "value4", "key": "key4" }, { "value": "valueXX", "key": "key3" }, { "value": "value2", "key": "key2" }, { "value": "value5", "key": "key5" }, { "value": "value8", "key": "key8" }, { "value": "valueXX", "key": "key6" }, { "value": "valueXX", "key": "key0" }, { "value": "value1", "key": "key1" }, { "value": "value7", "key": "key7" }, { "value": "valueXX", "key": "key9" }], "resource_id": "8693187d-1590-4f9f-ae34-eb9e3037cf68" }] }

请求消息 请求参数 参数 是否必选 参数类型 描述 action 是 String 操作标识（区分大小写），支持filter、count。filter就是分页查询；count是只需按照条件将总条数返回即可。 tags 否 Array of objects 包含标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不能为空列表。 详情请参见表2。 tags_any 否 Array of objects 包含任意标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不允许为空列表，但可以不传递参数。 详情请参见表3。 not_tags 否 Array of objects 不包含标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不能为空列表。 详情请参见表4。 not_tags_any 否 Array of objects 不包含任意标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不能为空列表。 详情请参见表5。 without_any_tag 否 Boolean 不包含任意一个标签，该字段为true时查询所有不带标签的资源，此时忽略tag、not_tags、tags_any、not_tags_any字段。 limit 否 String 最大查询记录数（action为count时，此参数无效）。如果action为filter，则limit默认为10，最多为1000，不能为负数，最小值为1。 offset 否 String 索引位置， 从offset指定的下一条数据开始查询。 查询第一页数据时，不需要传入此参数（action为count时，此参数无效），如果action为filter，offset默认为0，不能为负数。 matches 否 Array of objects 搜索字段，key为要匹配的字段，如resource_name、resource_id等。value为匹配的值。多个matches的key不允许重复。不允许为空列表，但可以不传递参数。 详情请参见表6。 表2 tags字段数据结构说明 参数 是否必选 参数类型 描述 key 是 String 标签的键。最大长度127个unicode字符，key不能为空。 values 是 Array of strings 标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。 表3 tags_any字段数据结构说明 参数 是否必选 参数类型 描述 key 是 String 标签的键。最大长度127个unicode字符，key不能为空。 values 是 Array of strings 标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。 表4 not_tags字段数据结构说明 参数 是否必选 参数类型 描述 key 是 String 标签的键。最大长度127个unicode字符，key不能为空。 values 是 Array of strings 标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。 表5 not_tags_any字段数据结构说明 参数 是否必选 参数类型 描述 key 是 String 标签的键。最大长度127个unicode字符，key不能为空。 values 是 Array of strings 标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。 表6 matches字段数据结构说明 参数 是否必选 参数类型 描述 key 是 String 搜索的字段名称。合法值为resource_name、resource_id。 当字段名称为resource_name时，如果value为空字符串，做精确查询，否则按镜像名称全模糊查询。当字段名称为resource_id时，按镜像ID精确查询。 value 是 String 搜索的字段名称的对应值，不允许为空。每个值最大长度255个unicode字符。

响应消息 响应参数 参数 参数类型 描述 status String 共享状态。 created_at String 共享时间，格式为UTC时间。 updated_at String 更新时间，格式为UTC时间。 image_id String 镜像ID member_id String 成员ID，即接受镜像用户的项目ID。 schema String 共享视图 响应样例 STATUS CODE 200 1 2 3 4 5 6 7 8 { "status": "pending", "created_at": "2016-09-01T02:05:14Z", "updated_at": "2016-09-01T02:05:14Z", "image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "member_id": "edc89b490d7d4392898e19b2deb34797", "schema": "/v2/schemas/member" }

请求示例 使用云服务器制作系统盘镜像，其中，镜像标签数据格式为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（操作系统版本）值合法，具体请参见相关参数取值列表。