# 镜像属性
#### 概念
镜像是一个包含了软件及必要配置的模板，至少包含操作系统，还可以包含应用软件（例如数据库软件）和私有软件。镜像是镜像管理服务（IMS）管理的核心对象。
 #### 镜像属性
| 名称                               | 类型               | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|
| 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           | 镜像名称。 - 名称的首尾字符不能为空格。  - 名称的长度为1～128位。  - 名称包含以下4种字符： - 大写字母  - 小写字母  - 数字  - 特殊字符包含-、.、_、空格和中文。     |
| checksum                         | String           | 预留字段，当前不支持该功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| deleted                          | Boolean          | 是否是删除的镜像，取值为true或者false。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| protected                        | Boolean          | 是否是受保护的，受保护的镜像不允许删除。取值为true或false。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| container_format                 | String           | 容器类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| min_ram                          | Integer          | 镜像运行需要的最小内存，单位为MB。参数取值依据云服务器的规格限制，默认设置为0。 云服务器的规格限制，请参见[规格清单](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0159822360.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| update_at                        | String           | 更新时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| __os_bit                         | String           | 操作系统位数，一般取值为"32"或者"64"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| __os_version                     | String           | 操作系统具体版本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| __description                    | String           | 镜像描述信息。 支持字母、数字、中文等，不支持回车、\<、 \>，长度不能超过1024个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 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。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| min_disk                         | Integer          | 镜像运行最小磁盘空间，单位为GB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| max_ram                          | Integer          | 镜像支持的最大内存，单位为MB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| virtual_env_type                 | String           | 镜像使用环境类型：FusionCompute、Ironic、DataImage、IsoImage。 - 如果是云服务器镜像（即系统盘镜像），则取值为FusionCompute。  - 如果是数据盘镜像则取值是DataImage。  - 如果是裸金属服务器镜像，则取值是Ironic。  - 如果是ISO镜像，则取值是IsoImage。                                                                                                                                                                      |
| __image_source_type              | String           | 镜像后端存储类型，目前支持uds。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| __imagetype                      | String           | 镜像类型，目前支持以下类型： - 公共镜像：gold  - 私有镜像：private  - 共享镜像：shared  - 市场镜像：market                                                                                                                                                                                                                                                                    |
| __whole_image                    | Boolean          | 是否为整机镜像，取值为"true"或者"false"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| create_at                        | String           | 创建时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| virtual_size                     | Integer          | 预留字段，当前不支持该功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| deleted_at                       | String           | 删除时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| __originalimagename              | String           | 父镜像ID。 公共镜像或通过文件创建的私有镜像，取值为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| __backup_id                      | String           | 备份ID。如果是备份创建的镜像，则填写为备份的ID，否则为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| __productcode                    | String           | 市场镜像的产品ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| __image_location                 | String           | 镜像的存储位置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| __image_size                     | String           | 镜像文件的大小，单位为字节。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| __data_origin                    | String           | 镜像来源。 公共镜像为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| hw_firmware_type                 | String           | 云服务器的启动方式。目前支持： - bios：表示bios引导启动。  - uefi：表示uefi引导启动。                                                                                                                                                                                                                                                                                                                                   |
| __support_kvm                    | String           | 如果镜像支持KVM，取值为true，否则无需增加该属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| __support_xen                    | String           | 如果镜像支持XEN，取值为true，否则无需增加该属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| __support_amd                    | String           | 是否是AMD架构类型的镜像。取值为"true"或者"false"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| __support_largememory            | String           | 表示该镜像支持超大内存。如果镜像支持超大内存，取值为true，否则无需增加该属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| __support_diskintensive          | String           | 表示该镜像支持密集存储。如果镜像支持密集存储性能，则值为true，否则无需增加该属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| __support_highperformance        | String           | 表示该镜像支持高计算性能。如果镜像支持高计算性能，则值为true，否则无需增加该属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| __support_xen_gpu_type           | String           | 表示该镜像是支持XEN虚拟化平台下的GPU优化类型。镜像操作系统类型请参考[表2](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__table65768383152758)。如果不支持XEN虚拟化下GPU类型，无需添加该属性。该属性与"__support_xen"和"__support_kvm"属性不共存。                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| __support_kvm_gpu_type           | String           | 表示该镜像是支持KVM虚拟化平台下的GPU类型，取值参考[表3](https://support.huaweicloud.com/api-ims/ims_03_0910.html#ims_03_0910__table282523154017)。 如果不支持KVM虚拟化下GPU类型，无需添加该属性。该属性与"__support_xen"和"__support_kvm"属性不共存。                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| __support_xen_hana               | String           | 如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无需添加该属性。 该属性与"__support_xen"和"__support_kvm"属性不共存。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| __support_kvm_infiniband         | String           | 如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无需添加该属性。 该属性与"__support_xen"属性不共存。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| __support_fc_inject              | String           | 表示当前镜像支持Cloud-Init密码/密钥注入方式。如果取值为"true"，表示该镜像不支持Cloud-Init注入密码/密钥，其他取值时表示支持Cloud-Init注入密钥/密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| __is_config_init                 | String           | 是否完成了初始化配置。取值为true或false。 如果用户确定完成了初始化配置，则可以设置为true，否则设置为false。默认为false。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| enterprise_project_id            | String           | 表示当前镜像所属的企业项目。 - 取值为0或无该值，表示属于default企业项目。  - 取值为UUID，表示属于该UUID对应的企业项目。                                                                                                                                                                                                                                                                                                                                                   |
| __support_kvm_hi1822_hisriov     | String           | 如果镜像支持sriov直通，取值为true，否则无需增加该属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| __support_kvm_hi1822_hivirtionet | String           | 如果镜像支持Virtio-net直通规格，取值为true，否则无需增加该属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |