更新时间:2024-12-09 GMT+08:00

镜像属性

概念

镜像是一个包含了软件及必要配置的模板,至少包含操作系统,还可以包含应用软件(例如数据库软件)和私有软件。镜像是镜像管理服务(IMS)管理的核心对象。

镜像属性

名称

类型

说明

file

String

镜像文件下载和上传链接。

owner

String

镜像属于哪个租户。

id

String

镜像ID。

size

Long

目前暂时不使用。

self

String

镜像链接信息。

schema

String

镜像视图。

status

String

镜像状态,取值为active、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。

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

镜像运行最大磁盘空间,单位为GB。

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。如果不支持XEN虚拟化下GPU类型,无需添加该属性。该属性与“__support_xen”和“__support_kvm”属性不共存。

__support_kvm_gpu_type

String

表示该镜像是支持KVM虚拟化平台下的GPU类型,取值参考表3

如果不支持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对应的企业项目。

    关于企业项目ID的获取及企业项目特性的详细信息,请参考“企业中心总览”。

__support_kvm_hi1822_hisriov

String

如果镜像支持sriov直通,取值为true,否则无需增加该属性。

__support_kvm_hi1822_hivirtionet

String

如果镜像支持Virtio-net直通规格,取值为true,否则无需增加该属性。