Updated on 2024-04-17 GMT+08:00

Image Attributes

Description

An image is a template containing mandatory software, such as an OS. The template may also contain application software, such as database software, and proprietary software. Image is the core object of IMS.

Image Attributes

Name

Type

Description

file

String

Specifies the URL for uploading and downloading the image file.

owner

String

Specifies the tenant to which the image belongs.

id

String

Specifies the image ID.

size

Long

This parameter is unavailable currently.

self

String

Specifies the image URL.

schema

String

Specifies the image schema.

status

String

Specifies the image status. The value can be active, queued, saving, deleted, or killed. An image can be used only when it is in the active state.

tags

Array of strings

Lists the image tags.

visibility

String

Specifies whether the image can be seen by other tenants. The value can be private, public, or shared.

name

String

Specifies the image name.

  • The name cannot start or end with a space.
  • The name contains 1 to 128 characters.
  • The name contains the following characters:
    • Uppercase letters
    • Lowercase letters
    • Digits
    • Special characters, including hyphens (-), periods (.), underscores (_), and space

checksum

String

This parameter is unavailable currently.

deleted

Boolean

Specifies whether the image has been deleted. The value can be true or false.

protected

Boolean

Specifies whether the image is protected. A protected image cannot be deleted. The value can be true or false.

container_format

String

Specifies the container type.

min_ram

Integer

Specifies the minimum memory size (MB) required for running the image. The parameter value depends on the ECS specifications. The default value is 0.

update_at

String

Specifies the time when the image was updated.

__os_bit

String

Specifies the OS architecture, 32 bit or 64 bit.

__os_version

String

Specifies the OS version.

__description

String

Provides supplementary information about the image.

The value contains a maximum of 1024 characters and consists of only letters and digits. Carriage returns and angle brackets (< >) are not allowed.

disk_format

String

Specifies the image format. The value can be zvhd2, vhd, zvhd, raw, iso, or qcow2. The default value is zvhd2 for a non-ISO image.

__isregistered

String

Specifies whether the image has been registered. The value can be true or false.

__platform

String

Specifies the image platform type. The value can be Windows, Ubuntu, Red Hat, SUSE, CentOS, Debian, OpenSUSE, Oracle Linux, Fedora, Other, CoreOS, or EulerOS.

__os_type

String

Specifies the OS type. The value can be Linux, Windows, or Other.

min_disk

Integer

Specifies the minimum disk space (GB) required for running the image.

virtual_env_type

String

Specifies the environment where the image is used. The value can be FusionCompute, Ironic, DataImage, or IsoImage.

  • For an ECS image (system disk image), the value is FusionCompute.
  • For a data disk image, the value is DataImage.
  • For a BMS image, the value is Ironic.
  • For an ISO image, the value is IsoImage.

__image_source_type

String

Specifies the image backend storage type. Only UDS is supported currently.

__imagetype

String

Specifies the image type. The following types are supported:

  • Public image: The value is gold.
  • Private image: The value is private.
  • Shared image: The value is shared.

__whole_image

Boolean

Specifies whether the image is a full-ECS image. The value can be true or false.

create_at

String

Specifies the time when the image was created.

virtual_size

Integer

This parameter is unavailable currently.

deleted_at

String

Specifies the time when the image was deleted.

__originalimagename

String

Specifies the parent image ID.

If the image is a public image or created from an image file, this value is left empty.

__backup_id

String

Specifies the backup ID. To create an image using a backup, set the value to the backup ID. Otherwise, this value is left empty.

__image_location

String

Specifies the location where the image is stored.

__image_size

String

Specifies the size (bytes) of the image file.

__data_origin

String

Specifies the image source.

If the image is a public image, this parameter is left empty.

hw_firmware_type

String

Specifies the ECS boot mode. The following values are supported:

  • bios indicates the BIOS boot mode.
  • uefi indicates the UEFI boot mode.

__support_kvm

String

Specifies whether the image supports KVM. If yes, the value is true. Otherwise, this parameter is not required.

__support_xen

String

Specifies whether the image supports Xen. If yes, the value is true. Otherwise, this parameter is not required.

__support_largememory

String

Specifies whether the image supports large-memory ECSs. If the image supports large-memory ECSs, the value is true. Otherwise, this parameter is not required.

__support_diskintensive

String

Specifies whether the image supports disk-intensive ECSs. If the image supports disk-intensive ECSs, the value is true. Otherwise, this parameter is not required.

__support_highperformance

String

Specifies whether the image supports high-performance ECSs. If the image supports high-performance ECSs, the value is true. Otherwise, this parameter is not required.

__support_xen_gpu_type

String

Specifies whether the image supports GPU-accelerated ECSs on the Xen platform. For the supported OSs, see Table 2. If the image does not support GPU-accelerated ECSs on the Xen platform, this parameter is not required. This parameter cannot co-exist with __support_xen and __support_kvm.

__support_kvm_gpu_type

String

Specifies whether the image supports GPU-accelerated ECSs on the KVM platform. See Table 3 for its value.

If the image does not support GPU-accelerated ECSs on the KVM platform, this parameter is not required. This attribute cannot co-exist with __support_xen and __support_kvm.

__is_config_init

String

Specifies whether initial configuration is complete. The value can be true or false.

If initial configuration is complete, the value is set to true. Otherwise, the value is set to false. The default value is false.

enterprise_project_id

String

Specifies the enterprise project that the image belongs to.

  • If the value is 0 or left blank, the image belongs to the default enterprise project.
  • If the value is a UUID, the image belongs to the enterprise project corresponding to the UUID.

    For more information about enterprise projects and how to obtain enterprise project IDs, see Enterprise Management User Guide.