VK Cloud logo
Updated at March 27, 2024   03:20 PM

Images meta tags

The image may have meta tags that affect the configuration of the virtual machine and the guest operating system. Meta tags are set when editing the image.

Supported image meta tags

VM image tags are divided into:

  • os_*: guest operating system (OS) settings;
  • hw_*: virtual machine settings;
  • mcs_*: VM properties used for sorting in VK Cloud personal account;
  • other tags that affect the work with the image.
Name
Description
Default value
os_type
The type of guest OS created from the image inside the VM. Affects the VM configuration. For example, special hypervisor features will be enabled for Windows to improve the stability and performance of the guest OS
Depends on the OS
mcs_os_type
The type of guest OS inside the VM. Used for sorting in the personal account
os_distro
The distribution of the guest OS created from the image inside the virtual machine. Affects VM configuration, for example, types of virtual network devices
mcs_os_distro
The distribution of the guest OS inside the VM. Used for sorting in the personal account
os_version
Version of the guest OS inside the VM
mcs_os_version
The version of the guest OS inside the VM. Used for sorting in the personal account
os_admin_user
The user is inside the guest OS with administrator rights; the password can be set via personal account
If os_type: windows then value is Administrator, root otherwise
os_require_quiesce
The flag responsible for freezing the file system before taking snapshots of attached disks. If yes, then if the file system freezes unsuccessfully, the snapshot creation operation will be canceled
no
hw_qemu_guest_agent
A sign of the presence of a QEMU agent inside the guest OS. If True, it makes available the possibility of changing the user's password and freezing the file system for backup
False
mcs_name
The name of the image that is displayed to the user of the personal account

Filling os_distro and os_version tags

Use the value Short ID to define the meta tag os_distro and version for the meta tag os_version:

Installing a meta tag

  1. Get the image ID:

    openstack image show <image ID>

    The assigned meta tags are displayed in the line properties.

  2. Set a meta tag:

    openstack image set --property <tag name and value> <image ID>

Deleting a meta tag

  1. Get the image ID:

    openstack image show <image ID>

    The assigned meta tags are displayed in the line properties.

  2. Delete a meta tag:

    openstack image unset --property <tag name and value> <image ID>