Chapter 7. Types

This section enumerates all the data types that are available in the API.

7.1. AccessProtocol enum

Table 7.1. Values summary

NameSummary

cifs

 

gluster

 

nfs

 

7.2. Action struct

Table 7.2. Attributes summary

NameTypeSummary

allow_partial_import

Boolean

 

async

Boolean

 

bricks

GlusterBrick[]

 

certificates

Certificate[]

 

check_connectivity

Boolean

 

clone

Boolean

 

cluster

Cluster

 

collapse_snapshots

Boolean

 

comment

String

Free text containing comments about this object.

connectivity_timeout

Integer

 

data_center

DataCenter

 

deploy_hosted_engine

Boolean

 

description

String

A human-readable description in plain text.

details

GlusterVolumeProfileDetails

 

discard_snapshots

Boolean

 

disk

Disk

 

disks

Disk[]

 

exclusive

Boolean

 

fault

Fault

 

fence_type

String

 

filter

Boolean

 

fix_layout

Boolean

 

force

Boolean

 

grace_period

GracePeriod

 

host

Host

 

id

String

A unique identifier.

image

String

 

import_as_template

Boolean

 

is_attached

Boolean

 

iscsi

IscsiDetails

 

iscsi_targets

String[]

 

job

Job

 

logical_units

LogicalUnit[]

 

maintenance_enabled

Boolean

 

modified_bonds

HostNic[]

 

modified_labels

NetworkLabel[]

 

modified_network_attachments

NetworkAttachment[]

 

name

String

A human-readable name in plain text.

option

Option

 

pause

Boolean

 

power_management

PowerManagement

 

proxy_ticket

ProxyTicket

 

reason

String

 

reassign_bad_macs

Boolean

 

remote_viewer_connection_file

String

 

removed_bonds

HostNic[]

 

removed_labels

NetworkLabel[]

 

removed_network_attachments

NetworkAttachment[]

 

resolution_type

String

 

restore_memory

Boolean

 

root_password

String

 

snapshot

Snapshot

 

ssh

Ssh

 

status

String

 

stop_gluster_service

Boolean

 

storage_domain

StorageDomain

 

storage_domains

StorageDomain[]

 

succeeded

Boolean

 

synchronized_network_attachments

NetworkAttachment[]

 

template

Template

 

ticket

Ticket

 

undeploy_hosted_engine

Boolean

 

use_cloud_init

Boolean

 

use_sysprep

Boolean

 

virtual_functions_configuration

HostNicVirtualFunctionsConfiguration

 

vm

Vm

 

vnic_profile_mappings

VnicProfileMapping[]

 

7.3. AffinityGroup struct

An affinity group represents a group of virtual machines with a defined relationship.

Table 7.3. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

enforcing

Boolean

Specifies whether the affinity group uses hard or soft enforcement of the affinity applied to virtual machines that are members of that affinity group.

hosts_rule

AffinityRule

Specifies the affinity rule applied between virtual machines and hosts that are members of this affinity group.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

positive

Boolean

Specifies whether the affinity group applies positive affinity or negative affinity to virtual machines that are members of that affinity group.

vms_rule

AffinityRule

Specifies the affinity rule applied to virtual machines that are members of this affinity group.

7.3.1. enforcing

Specifies whether the affinity group uses hard or soft enforcement of the affinity applied to virtual machines that are members of that affinity group.

Warning

Please note that this attribute has been deprecated since version 4.1 of the engine, and will be removed in the future. Use the vms_rule attribute from now on.

7.3.2. positive

Specifies whether the affinity group applies positive affinity or negative affinity to virtual machines that are members of that affinity group.

Warning

Please note that this attribute has been deprecated since version 4.1 of the engine, and will be removed in the future. Use the vms_rule attribute from now on.

Table 7.4. Links summary

NameTypeSummary

cluster

Cluster

A reference to the cluster to which the affinity group applies.

hosts

Host[]

A list of all hosts assigned to this affinity group.

vms

Vm[]

A list of all virtual machines assigned to this affinity group.

7.4. AffinityLabel struct

The affinity label can influence virtual machine scheduling. It is most frequently used to create a sub-cluster from the available hosts.

Table 7.5. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

read_only

Boolean

The read_only property marks a label that can not be modified.

7.4.1. read_only

The read_only property marks a label that can not be modified. This is usually the case when listing internally-generated labels.

Table 7.6. Links summary

NameTypeSummary

hosts

Host[]

A list of hosts that were labeled using this scheduling label.

vms

Vm[]

A list of virtual machines that were labeled using this scheduling label.

7.5. AffinityRule struct

Generic rule definition for affinity group. Each supported resource type (virtual machine, host) is controlled by a separate rule. This allows expressing of rules like: no affinity between defined virtual machines, but hard affinity between defined virtual machines and virtual hosts.

Table 7.7. Attributes summary

NameTypeSummary

enabled

Boolean

Specifies whether the affinity group uses this rule or not.

enforcing

Boolean

Specifies whether the affinity group uses hard or soft enforcement of the affinity applied to the resources that are controlled by this rule.

positive

Boolean

Specifies whether the affinity group applies positive affinity or negative affinity to the resources that are controlled by this rule.

7.5.1. enabled

Specifies whether the affinity group uses this rule or not. This attribute is optional during creation and is considered to be true when it is not provided. In case this attribute is not provided to the update operation, it is considered to be true if AffinityGroup positive attribute is set as well. The backend enabled value will be preserved when both enabled and positive attributes are missing.

7.5.2. enforcing

Specifies whether the affinity group uses hard or soft enforcement of the affinity applied to the resources that are controlled by this rule. This argument is mandatory if the rule is enabled and is ignored when the rule is disabled.

7.5.3. positive

Specifies whether the affinity group applies positive affinity or negative affinity to the resources that are controlled by this rule. This argument is mandatory if the rule is enabled and is ignored when the rule is disabled.

7.6. Agent struct

Type representing a fence agent.

Table 7.8. Attributes summary

NameTypeSummary

address

String

Fence agent address.

comment

String

Free text containing comments about this object.

concurrent

Boolean

Specifies whether the agent should be used concurrently or sequentially.

description

String

A human-readable description in plain text.

encrypt_options

Boolean

Specifies whether the options should be encrypted.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

options

Option[]

Fence agent options (comma-delimited list of key-value pairs).

order

Integer

The order of this agent if used with other agents.

password

String

Fence agent password.

port

Integer

Fence agent port.

type

String

Fence agent type.

username

String

Fence agent user name.

Table 7.9. Links summary

NameTypeSummary

host

Host

Reference to the host service.

7.7. AgentConfiguration struct

Table 7.10. Attributes summary

NameTypeSummary

address

String

 

broker_type

MessageBrokerType

 

network_mappings

String

 

password

String

 

port

Integer

 

username

String

 

7.8. Api struct

This type contains the information returned by the root service of the API.

To get that information send a request like this:

GET /ovirt-engine/api

The result will be like this:

<api>
  <link rel="hosts" href="/ovirt-engine/api/hosts"/>
  <link rel="vms" href="/ovirt-engine/api/vms"/>
  ...
  <product_info>
    <name>oVirt Engine</name>
    <vendor>ovirt.org</vendor>
    <version>
      <build>0</build>
      <full_version>4.1.0_master</full_version>
      <major>4</major>
      <minor>1</minor>
      <revision>0</revision>
    </version>
  </product_info>
  <special_objects>
    <link rel="templates/blank" href="..."/>
    <link rel="tags/root" href="..."/>
  </special_objects>
  <summary>
    <vms>
      <total>10</total>
      <active>3</active>
    </vms>
    <hosts>
      <total>2</total>
      <active>2</active>
    </hosts>
    <users>
      <total>8</total>
      <active>2</active>
    </users>
    <storage_domains>
      <total>2</total>
      <active>2</active>
    </storage_domains>
  </summary>
  <time>2016-12-12T12:22:25.866+01:00</time>
</api>

Table 7.11. Attributes summary

NameTypeSummary

product_info

ProductInfo

Information about the product, such as its name, the name of the vendor, and the version.

special_objects

SpecialObjects

References to special objects, such as the blank template and the root of the hierarchy of tags.

summary

ApiSummary

A summary containing the total number of relevant objects, such as virtual machines, hosts, and storage domains.

time

Date

The date and time when this information was generated.

7.9. ApiSummary struct

A summary containing the total number of relevant objects, such as virtual machines, hosts, and storage domains.

Table 7.12. Attributes summary

NameTypeSummary

hosts

ApiSummaryItem

The summary of hosts.

storage_domains

ApiSummaryItem

The summary of storage domains.

users

ApiSummaryItem

The summary of users.

vms

ApiSummaryItem

The summary of virtual machines.

7.10. ApiSummaryItem struct

This type contains an item of the API summary. Each item contains the total and active number of some kind of object.

Table 7.13. Attributes summary

NameTypeSummary

active

Integer

The total number of active objects.

total

Integer

The total number of objects.

7.11. Application struct

Table 7.14. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.15. Links summary

NameTypeSummary

vm

Vm

 

7.12. Architecture enum

Table 7.16. Values summary

NameSummary

ppc64

 

undefined

 

x86_64

 

7.13. AuthorizedKey struct

Table 7.17. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

key

String

 

name

String

A human-readable name in plain text.

Table 7.18. Links summary

NameTypeSummary

user

User

 

7.14. AutoNumaStatus enum

Table 7.19. Values summary

NameSummary

disable

 

enable

 

unknown

 

7.15. Balance struct

Table 7.20. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.21. Links summary

NameTypeSummary

scheduling_policy

SchedulingPolicy

 

scheduling_policy_unit

SchedulingPolicyUnit

 

7.16. Bios struct

Table 7.22. Attributes summary

NameTypeSummary

boot_menu

BootMenu

 

7.17. BlockStatistic struct

Table 7.23. Attributes summary

NameTypeSummary

statistics

Statistic[]

 

7.18. Bonding struct

Represents a network interfaces bond.

Table 7.24. Attributes summary

NameTypeSummary

ad_partner_mac

Mac

The ad_partner_mac property of the partner bond in mode 4.

options

Option[]

A list of option elements for a bonded interface.

slaves

HostNic[]

A list of slave NICs for a bonded interface.

7.18.1. ad_partner_mac

The ad_partner_mac property of the partner bond in mode 4. Bond mode 4 is the 802.3ad standard, which is also called dynamic link aggregation. See Wikipedia and Presentation for more information. ad_partner_mac is the MAC address of the system (switch) at the other end of a bond. This parameter is read-only. Setting it will have no effect on the bond. It is retrieved from /sys/class/net/bondX/bonding/ad_partner_mac file on the system where the bond is located.

7.18.2. options

A list of option elements for a bonded interface. Each option contains property name and value attributes. Only required when adding bonded interfaces.

7.18.3. slaves

A list of slave NICs for a bonded interface. Only required when adding bonded interfaces.

Table 7.25. Links summary

NameTypeSummary

active_slave

HostNic

The active_slave property of the bond in modes that support it (active-backup, balance-alb and balance-tlb).

7.19. Bookmark struct

Table 7.26. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

value

String

 

7.20. Boot struct

Table 7.27. Attributes summary

NameTypeSummary

devices

BootDevice[]

 

7.21. BootDevice enum

Table 7.28. Values summary

NameSummary

cdrom

 

hd

 

network

 

7.22. BootMenu struct

Table 7.29. Attributes summary

NameTypeSummary

enabled

Boolean

 

7.23. BootProtocol enum

Defines the options of the IP address assignment method to a NIC.

Table 7.30. Values summary

NameSummary

autoconf

Stateless address auto-configuration.

dhcp

Dynamic host configuration protocol.

none

No address configuration.

static

Statically-defined address, mask and gateway.

7.23.1. autoconf

Stateless address auto-configuration.

The mechanism is defined by RFC 4862. Please refer to this wikipedia article for more information.

Note

The value is valid for IPv6 addresses only.

7.23.2. dhcp

Dynamic host configuration protocol.

Please refer to this wikipedia article for more information.

7.24. BrickProfileDetail struct

Table 7.31. Attributes summary

NameTypeSummary

profile_details

ProfileDetail[]

 

Table 7.32. Links summary

NameTypeSummary

brick

GlusterBrick

 

7.25. Cdrom struct

Table 7.33. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

file

File

 

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.34. Links summary

NameTypeSummary

instance_type

InstanceType

Optionally references to an instance type the device is used by.

template

Template

Optionally references to a template the device is used by.

vm

Vm

Don’t use this element, use vms instead.

vms

Vm[]

References to the virtual machines that are using this device.

7.26. Certificate struct

Table 7.35. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

content

String

 

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

organization

String

 

subject

String

 

7.27. CloudInit struct

Table 7.36. Attributes summary

NameTypeSummary

authorized_keys

AuthorizedKey[]

 

files

File[]

 

host

Host

 

network_configuration

NetworkConfiguration

 

regenerate_ssh_keys

Boolean

 

timezone

String

 

users

User[]

 

7.28. Cluster struct

Type representation of a cluster.

A JSON representation of a cluster

{
  "cluster" : [ {
    "ballooning_enabled" : "false",
    "cpu" : {
      "architecture" : "x86_64",
      "type" : "Intel SandyBridge Family"
    },
    "custom_scheduling_policy_properties" : {
      "property" : [ {
        "name" : "HighUtilization",
        "value" : "80"
      }, {
        "name" : "CpuOverCommitDurationMinutes",
        "value" : "2"
      } ]
    },
    "error_handling" : {
      "on_error" : "migrate"
    },
    "fencing_policy" : {
      "enabled" : "true",
      "skip_if_connectivity_broken" : {
        "enabled" : "false",
        "threshold" : "50"
      },
      "skip_if_gluster_bricks_up" : "false",
      "skip_if_gluster_quorum_not_met" : "false",
      "skip_if_sd_active" : {
        "enabled" : "false"
      }
    },
    "gluster_service" : "false",
    "ha_reservation" : "false",
    "ksm" : {
      "enabled" : "true",
      "merge_across_nodes" : "true"
    },
    "maintenance_reason_required" : "false",
    "memory_policy" : {
      "over_commit" : {
        "percent" : "100"
      },
      "transparent_hugepages" : {
        "enabled" : "true"
      }
    },
    "migration" : {
      "auto_converge" : "inherit",
      "bandwidth" : {
        "assignment_method" : "auto"
      },
      "compressed" : "inherit",
      "policy" : {
        "id" : "00000000-0000-0000-0000-000000000000"
      }
    },
    "optional_reason" : "false",
    "required_rng_sources" : {
      "required_rng_source" : [ "random" ]
    },
    "switch_type" : "legacy",
    "threads_as_cores" : "false",
    "trusted_service" : "false",
    "tunnel_migration" : "false",
    "version" : {
      "major" : "4",
      "minor" : "1"
    },
    "virt_service" : "true",
    "data_center" : {
      "href" : "/ovirt-engine/api/datacenters/123",
      "id" : "123"
    },
    "mac_pool" : {
      "href" : "/ovirt-engine/api/macpools/456",
      "id" : "456"
    },
    "scheduling_policy" : {
      "href" : "/ovirt-engine/api/schedulingpolicies/789",
      "id" : "789"
    },
    "actions" : {
      "link" : [ {
        "href" : "/ovirt-engine/api/clusters/234/resetemulatedmachine",
        "rel" : "resetemulatedmachine"
      } ]
    },
    "name" : "Default",
    "description" : "The default server cluster",
    "href" : "/ovirt-engine/api/clusters/234",
    "id" : "234",
    "link" : [ {
      "href" : "/ovirt-engine/api/clusters/234/permissions",
      "rel" : "permissions"
    }, {
      "href" : "/ovirt-engine/api/clusters/234/cpuprofiles",
      "rel" : "cpuprofiles"
    }, {
      "href" : "/ovirt-engine/api/clusters/234/networkfilters",
      "rel" : "networkfilters"
    }, {
      "href" : "/ovirt-engine/api/clusters/234/networks",
      "rel" : "networks"
    }, {
      "href" : "/ovirt-engine/api/clusters/234/affinitygroups",
      "rel" : "affinitygroups"
    }, {
      "href" : "/ovirt-engine/api/clusters/234/glusterhooks",
      "rel" : "glusterhooks"
    }, {
      "href" : "/ovirt-engine/api/clusters/234/glustervolumes",
      "rel" : "glustervolumes"
    } ]
  } ]
}

Table 7.37. Attributes summary

NameTypeSummary

ballooning_enabled

Boolean

 

comment

String

Free text containing comments about this object.

cpu

Cpu

 

custom_scheduling_policy_properties

Property[]

Custom scheduling policy properties of the cluster.

description

String

A human-readable description in plain text.

display

Display

 

error_handling

ErrorHandling

 

fencing_policy

FencingPolicy

Custom fencing policy can be defined for a cluster.

gluster_service

Boolean

 

gluster_tuned_profile

String

The name of the https://fedorahosted.

ha_reservation

Boolean

 

id

String

A unique identifier.

ksm

Ksm

 

maintenance_reason_required

Boolean

 

memory_policy

MemoryPolicy

 

migration

MigrationOptions

 

name

String

A human-readable name in plain text.

optional_reason

Boolean

 

required_rng_sources

RngSource[]

Set of random number generator (RNG) sources required from each host in the cluster.

serial_number

SerialNumber

 

supported_versions

Version[]

 

switch_type

SwitchType

Type of switch to be used by all networks in given cluster.

threads_as_cores

Boolean

 

trusted_service

Boolean

 

tunnel_migration

Boolean

 

version

Version

The compatibility version of the cluster.

virt_service

Boolean

 

7.28.1. custom_scheduling_policy_properties

Custom scheduling policy properties of the cluster. These optional properties override the properties of the scheduling policy specified by the scheduling_policy link, and apply only for this specific cluster.

For example, to update the custom properties of the cluster, send a request:

PUT /ovirt-engine/api/clusters/123

With a request body:

<cluster>
  <custom_scheduling_policy_properties>
    <property>
      <name>HighUtilization</name>
      <value>70</value>
    </property>
  </custom_scheduling_policy_properties>
</cluster>

Update operations using the custom_scheduling_policy_properties attribute will not update the the properties of the scheduling policy specified by the scheduling_policy link, they will only be reflected on this specific cluster.

7.28.2. fencing_policy

Custom fencing policy can be defined for a cluster.

Here is an example:

PUT /ovirt-engine/api/cluster/123

With request body:

<cluster>
  <fencing_policy>
    <enabled>true</enabled>
    <skip_if_sd_active>
      <enabled>false</enabled>
    </skip_if_sd_active>
    <skip_if_connectivity_broken>
      <enabled>false</enabled>
      <threshold>50</threshold>
    </skip_if_connectivity_broken>
  </fencing_policy>
</cluster>

7.28.3. gluster_tuned_profile

The name of the tuned profile to set on all the hosts in the cluster. This is not mandatory and relevant only for clusters with gluster service.

7.28.4. required_rng_sources

Set of random number generator (RNG) sources required from each host in the cluster.

When read, it returns the implicit urandom (for cluster version 4.1 and higher) or random (for cluster version 4.0 and lower) plus additional selected RNG sources. When written, the implicit urandom and random RNG sources cannot be removed.

Important

Before version 4.1 of the engine, the set of required random number generators was completely controllable by the administrator; any source could be added or removed, including the random source. But starting with version 4.1, the urandom and random sources will always be part of the set, and can’t be removed.

Important

Engine version 4.1 introduces a new RNG source urandom that replaces random RNG source in clusters with compatibility version 4.1 or higher.

7.28.5. version

The compatibility version of the cluster.

All hosts in this cluster must support at least this compatibility version.

For example:

GET /ovirt-engine/api/clusters/123

Will respond:

<cluster>
  ...
  <version>
    <major>4</major>
    <minor>0</minor>
  </version>
  ...
</cluster>

To update the compatibility version, use:

PUT /ovirt-engine/api/clusters/123

With a request body:

<cluster>
  <version>
    <major>4</major>
    <minor>1</minor>
  </version>
</cluster>

In order to update the cluster compatibility version, all hosts in the cluster must support the new compatibility version.

Table 7.38. Links summary

NameTypeSummary

affinity_groups

AffinityGroup[]

 

cpu_profiles

CpuProfile[]

 

data_center

DataCenter

 

gluster_hooks

GlusterHook[]

 

gluster_volumes

GlusterVolume[]

 

mac_pool

MacPool

A reference to the MAC pool used by this cluster.

management_network

Network

 

network_filters

NetworkFilter[]

 

networks

Network[]

 

permissions

Permission[]

 

scheduling_policy

SchedulingPolicy

Reference to the default scheduling policy used by this cluster.

7.29. ClusterLevel struct

Describes the capabilities supported by a specific cluster level.

Table 7.39. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

cpu_types

CpuType[]

The CPU types supported by this cluster level.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

permits

Permit[]

The permits supported by this cluster level.

7.30. Configuration struct

Table 7.40. Attributes summary

NameTypeSummary

data

String

The document describing the virtual machine.

type

ConfigurationType

 

7.30.1. data

The document describing the virtual machine.

Example of the OVF document:

<?xml version='1.0' encoding='UTF-8'?>
<ovf:Envelope xmlns:ovf="http://schemas.dmtf.org/ovf/envelope/1/"
  xmlns:rasd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData"
  xmlns:vssd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_VirtualSystemSettingData"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  ovf:version="3.5.0.0">
  <References/>
  <Section xsi:type="ovf:NetworkSection_Type">
    <Info>List of networks</Info>
    <Network ovf:name="Network 1"/>
  </Section>
  <Section xsi:type="ovf:DiskSection_Type">
    <Info>List of Virtual Disks</Info>
  </Section>
  <Content ovf:id="out" xsi:type="ovf:VirtualSystem_Type">
    <CreationDate>2014/12/03 04:25:45</CreationDate>
    <ExportDate>2015/02/09 14:12:24</ExportDate>
    <DeleteProtected>false</DeleteProtected>
    <SsoMethod>guest_agent</SsoMethod>
    <IsSmartcardEnabled>false</IsSmartcardEnabled>
    <TimeZone>Etc/GMT</TimeZone>
    <default_boot_sequence>0</default_boot_sequence>
    <Generation>1</Generation>
    <VmType>1</VmType>
    <MinAllocatedMem>1024</MinAllocatedMem>
    <IsStateless>false</IsStateless>
    <IsRunAndPause>false</IsRunAndPause>
    <AutoStartup>false</AutoStartup>
    <Priority>1</Priority>
    <CreatedByUserId>fdfc627c-d875-11e0-90f0-83df133b58cc</CreatedByUserId>
    <IsBootMenuEnabled>false</IsBootMenuEnabled>
    <IsSpiceFileTransferEnabled>true</IsSpiceFileTransferEnabled>
    <IsSpiceCopyPasteEnabled>true</IsSpiceCopyPasteEnabled>
    <Name>VM_export</Name>
    <TemplateId>00000000-0000-0000-0000-000000000000</TemplateId>
    <TemplateName>Blank</TemplateName>
    <IsInitilized>false</IsInitilized>
    <Origin>3</Origin>
    <DefaultDisplayType>1</DefaultDisplayType>
    <TrustedService>false</TrustedService>
    <OriginalTemplateId>00000000-0000-0000-0000-000000000000</OriginalTemplateId>
    <OriginalTemplateName>Blank</OriginalTemplateName>
    <UseLatestVersion>false</UseLatestVersion>
    <Section ovf:id="70b4d9a7-4f73-4def-89ca-24fc5f60e01a"
      ovf:required="false"
      xsi:type="ovf:OperatingSystemSection_Type">
      <Info>Guest Operating System</Info>
      <Description>other</Description>
    </Section>
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Info>1 CPU, 1024 Memory</Info>
      <System>
        <vssd:VirtualSystemType>ENGINE 3.5.0.0</vssd:VirtualSystemType>
      </System>
      <Item>
        <rasd:Caption>1 virtual cpu</rasd:Caption>
        <rasd:Description>Number of virtual CPU</rasd:Description>
        <rasd:InstanceId>1</rasd:InstanceId>
        <rasd:ResourceType>3</rasd:ResourceType>
        <rasd:num_of_sockets>1</rasd:num_of_sockets>
        <rasd:cpu_per_socket>1</rasd:cpu_per_socket>
      </Item>
      <Item>
        <rasd:Caption>1024 MB of memory</rasd:Caption>
        <rasd:Description>Memory Size</rasd:Description>
        <rasd:InstanceId>2</rasd:InstanceId>
        <rasd:ResourceType>4</rasd:ResourceType>
        <rasd:AllocationUnits>MegaBytes</rasd:AllocationUnits>
        <rasd:VirtualQuantity>1024</rasd:VirtualQuantity>
      </Item>
      <Item>
        <rasd:Caption>USB Controller</rasd:Caption>
        <rasd:InstanceId>3</rasd:InstanceId>
        <rasd:ResourceType>23</rasd:ResourceType>
        <rasd:UsbPolicy>DISABLED</rasd:UsbPolicy>
      </Item>
    </Section>
  </Content>
</ovf:Envelope>

7.31. ConfigurationType enum

Table 7.41. Values summary

NameSummary

ovf

 

7.32. Console struct

Table 7.42. Attributes summary

NameTypeSummary

enabled

Boolean

 

7.33. Core struct

Table 7.43. Attributes summary

NameTypeSummary

index

Integer

 

socket

Integer

 

7.34. Cpu struct

Table 7.44. Attributes summary

NameTypeSummary

architecture

Architecture

 

cores

Core[]

 

cpu_tune

CpuTune

 

level

Integer

 

mode

CpuMode

 

name

String

 

speed

Decimal

 

topology

CpuTopology

 

type

String

 

7.35. CpuMode enum

Table 7.45. Values summary

NameSummary

custom

 

host_model

 

host_passthrough

 

7.36. CpuProfile struct

Table 7.46. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.47. Links summary

NameTypeSummary

cluster

Cluster

 

permissions

Permission[]

 

qos

Qos

 

7.37. CpuTopology struct

Table 7.48. Attributes summary

NameTypeSummary

cores

Integer

 

sockets

Integer

 

threads

Integer

 

7.38. CpuTune struct

Table 7.49. Attributes summary

NameTypeSummary

vcpu_pins

VcpuPin[]

 

7.39. CpuType struct

Describes a supported CPU type.

Table 7.50. Attributes summary

NameTypeSummary

architecture

Architecture

The architecture of the CPU.

level

Integer

The level of the CPU type.

name

String

The name of the CPU type, for example Intel Conroe Family.

7.40. CreationStatus enum

Table 7.51. Values summary

NameSummary

complete

 

failed

 

in_progress

 

pending

 

7.41. CustomProperty struct

Table 7.52. Attributes summary

NameTypeSummary

name

String

 

regexp

String

 

value

String

 

7.42. DataCenter struct

Table 7.53. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

local

Boolean

 

name

String

A human-readable name in plain text.

quota_mode

QuotaModeType

 

status

DataCenterStatus

 

storage_format

StorageFormat

 

supported_versions

Version[]

 

version

Version

The compatibility version of the data center.

7.42.1. version

The compatibility version of the data center.

All clusters in this data center must already be set to at least this compatibility version.

For example:

GET /ovirt-engine/api/datacenters/123

Will respond:

<data_center>
  ...
  <version>
    <major>4</major>
    <minor>0</minor>
  </version>
  ...
</data_center>

To update the compatibility version, use:

PUT /ovirt-engine/api/datacenters/123

With a request body:

<data_center>
  <version>
    <major>4</major>
    <minor>1</minor>
  </version>
</data_center>

Table 7.54. Links summary

NameTypeSummary

clusters

Cluster[]

Reference to clusters inside this data center.

iscsi_bonds

IscsiBond[]

Reference to ISCSI bonds used by this data center.

mac_pool

MacPool

Reference to the MAC pool used by this data center.

networks

Network[]

Reference to networks attached to this data center.

permissions

Permission[]

Reference to permissions assigned to this data center.

qoss

Qos[]

Reference to quality of service used by this data center.

quotas

Quota[]

Reference to quotas assigned to this data center.

storage_domains

StorageDomain[]

Reference to storage domains attached to this data center.

7.43. DataCenterStatus enum

Table 7.55. Values summary

NameSummary

contend

 

maintenance

 

not_operational

 

problematic

 

uninitialized

 

up

 

7.44. Device struct

A device wraps links to potential parents of a device.

Table 7.56. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.57. Links summary

NameTypeSummary

instance_type

InstanceType

Optionally references to an instance type the device is used by.

template

Template

Optionally references to a template the device is used by.

vm

Vm

Don’t use this element, use vms instead.

vms

Vm[]

References to the virtual machines that are using this device.

7.45. Disk struct

Represents a virtual disk device.

Table 7.58. Attributes summary

NameTypeSummary

active

Boolean

Indicates if the disk is visible to the virtual machine.

actual_size

Integer

The actual size of the disk, in bytes.

alias

String

 

bootable

Boolean

Indicates if the disk is marked as bootable.

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

format

DiskFormat

The underlying storage format.

id

String

A unique identifier.

image_id

String

 

initial_size

Integer

The initial size of a sparse image disk created on block storage, in bytes.

interface

DiskInterface

The type of interface driver used to connect the disk device to the virtual machine.

logical_name

String

 

lun_storage

HostStorage

 

name

String

A human-readable name in plain text.

propagate_errors

Boolean

Indicates if disk errors should not cause virtual machine to be paused and, instead, disk errors should be propagated to the the guest operating system.

provisioned_size

Integer

The virtual size of the disk, in bytes.

qcow_version

QcowVersion

The underlying QCOW version of a QCOW volume.

read_only

Boolean

Indicates if the disk is in read-only mode.

sgio

ScsiGenericIO

 

shareable

Boolean

Indicates if the disk can be attached to multiple virtual machines.

sparse

Boolean

Indicates if the physical storage for the disk should not be preallocated.

status

DiskStatus

The status of the disk device.

storage_type

DiskStorageType

 

uses_scsi_reservation

Boolean

 

wipe_after_delete

Boolean

Indicates if the disk’s blocks will be read back as zeros after it is deleted:

- On block storage, the disk will be zeroed and only then deleted.

7.45.1. active

Indicates if the disk is visible to the virtual machine.

Important

When adding a disk attachment to a virtual machine, the server accepts requests that don’t contain this attribute, but the effect is then undefined. In some cases the disk will be automatically activated and in other cases it won’t. To avoid issues it is strongly recommended to always include the this attribute with the desired value.

7.45.2. actual_size

The actual size of the disk, in bytes.

The actual size is the number of bytes actually used by the disk, and it will be smaller than the provisioned size for disks that use the cow format.

7.45.3. bootable

Indicates if the disk is marked as bootable.

Important

This attribute only makes sense for disks that are actually connected to virtual machines, and in version 4 of the API it has been moved to the DiskAttachment type. It is preserved here only for backwards compatibility, and it will be removed in the future.

7.45.4. initial_size

The initial size of a sparse image disk created on block storage, in bytes.

The initial size is the number of bytes a sparse disk is initially allocated with when created on block storage. The initial size will be smaller than the provisioned size. If not specified the default initial size used by the system will be allocated.

7.45.5. interface

The type of interface driver used to connect the disk device to the virtual machine.

Important

This attribute only makes sense for disks that are actually connected to virtual machines, and in version 4 of the API it has been moved to the DiskAttachment type. It is preserved here only for backwards compatibility, and it will be removed in the future.

7.45.6. provisioned_size

The virtual size of the disk, in bytes.

This attribute is mandatory when creating a new disk.

7.45.7. qcow_version

The underlying QCOW version of a QCOW volume. The QCOW version specifies to the qemu which qemu version the volume supports. This field can be updated using the update API and will be reported only for QCOW volumes, it is determined by the storage domain’s version which the disk is created on. Storage domains with version lower than V4 support QCOW2 volumes, while V4 storage domains also support QCOW2v3. For more information about features of the different QCOW versions, see here.

7.45.8. shareable

Indicates if the disk can be attached to multiple virtual machines.

Important

When a disk is attached to multiple virtual machines it is the responsibility of the guest operating systems of those virtual machines to coordinate access to it, to avoid corruption of the data, for example using a shared file system like GlusterFS or GFS.

7.45.9. wipe_after_delete

Indicates if the disk’s blocks will be read back as zeros after it is deleted:

  • On block storage, the disk will be zeroed and only then deleted.
  • On file storage, since the file system already guarantees that previously removed blocks are read back as zeros, the disk will be deleted immediately.

Table 7.59. Links summary

NameTypeSummary

disk_profile

DiskProfile

 

instance_type

InstanceType

Optionally references to an instance type the device is used by.

openstack_volume_type

OpenStackVolumeType

 

permissions

Permission[]

 

quota

Quota

 

snapshot

Snapshot

 

statistics

Statistic[]

Statistics exposed by the disk.

storage_domain

StorageDomain

 

storage_domains

StorageDomain[]

The storage domains associated with this disk.

template

Template

Optionally references to a template the device is used by.

vm

Vm

Don’t use this element, use vms instead.

vms

Vm[]

References to the virtual machines that are using this device.

7.46. DiskAttachment struct

Describes how a disk is attached to a virtual machine.

Table 7.60. Attributes summary

NameTypeSummary

active

Boolean

Defines whether the disk is active in the virtual machine it’s attached to.

bootable

Boolean

Defines whether the disk is bootable.

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

interface

DiskInterface

The type of interface driver used to connect the disk device to the virtual machine.

logical_name

String

The logical name of the virtual machine’s disk, as seen from inside the virtual machine.

name

String

A human-readable name in plain text.

pass_discard

Boolean

Defines whether the virtual machine passes discard commands to the storage.

read_only

Boolean

Indicates whether the disk is connected to the virtual machine as read only.

uses_scsi_reservation

Boolean

Defines whether SCSI reservation is enabled for this disk.

7.46.1. active

Defines whether the disk is active in the virtual machine it’s attached to.

A disk attached to a virtual machine in an active status is connected to the virtual machine at run time and can be used.

7.46.2. logical_name

The logical name of the virtual machine’s disk, as seen from inside the virtual machine.

The logical name of a disk is reported only when the guest agent is installed and running inside the virtual machine.

For example, if the guest operating system is Linux and the disk is connected via a VirtIO interface, the logical name will be reported as /dev/vda:

<disk_attachment>
  ...
  <logical_name>/dev/vda</logical_name>
</disk_attachment>

If the guest operating system is Windows, the logical name will be reported as \\.\PHYSICALDRIVE0.

7.46.3. read_only

Indicates whether the disk is connected to the virtual machine as read only.

When adding a new disk attachment the default value is false.

<disk_attachment>
  ...
  <read_only>true</read_only>
</disk_attachment>

7.46.4. uses_scsi_reservation

Defines whether SCSI reservation is enabled for this disk.

Virtual machines with VIRTIO-SCSI passthrough enabled can set persistent SCSI reservations on disks. If they set persistent SCSI reservations, those virtual machines cannot be migrated to a different host because they would lose access to the disk, because SCSI reservations are specific to SCSI initiators, and therefore hosts. This scenario cannot be automatically detected. To avoid migrating these virtual machines, the user can set this attribute to true, to indicate the virtual machine is using SCSI reservations.

Table 7.61. Links summary

NameTypeSummary

disk

Disk

The reference to the disk.

template

Template

The reference to the template.

vm

Vm

The reference to the virtual machine.

7.47. DiskFormat enum

The underlying storage format of disks.

Table 7.62. Values summary

NameSummary

cow

The Copy On Write format allows snapshots, with a small performance overhead.

raw

The raw format does not allow snapshots, but offers improved performance.

7.48. DiskInterface enum

Table 7.63. Values summary

NameSummary

ide

 

spapr_vscsi

 

virtio

 

virtio_scsi

 

7.49. DiskProfile struct

Table 7.64. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.65. Links summary

NameTypeSummary

permissions

Permission[]

 

qos

Qos

 

storage_domain

StorageDomain

 

7.50. DiskSnapshot struct

Table 7.66. Attributes summary

NameTypeSummary

active

Boolean

Indicates if the disk is visible to the virtual machine.

actual_size

Integer

The actual size of the disk, in bytes.

alias

String

 

bootable

Boolean

Indicates if the disk is marked as bootable.

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

format

DiskFormat

The underlying storage format.

id

String

A unique identifier.

image_id

String

 

initial_size

Integer

The initial size of a sparse image disk created on block storage, in bytes.

interface

DiskInterface

The type of interface driver used to connect the disk device to the virtual machine.

logical_name

String

 

lun_storage

HostStorage

 

name

String

A human-readable name in plain text.

propagate_errors

Boolean

Indicates if disk errors should not cause virtual machine to be paused and, instead, disk errors should be propagated to the the guest operating system.

provisioned_size

Integer

The virtual size of the disk, in bytes.

qcow_version

QcowVersion

The underlying QCOW version of a QCOW volume.

read_only

Boolean

Indicates if the disk is in read-only mode.

sgio

ScsiGenericIO

 

shareable

Boolean

Indicates if the disk can be attached to multiple virtual machines.

sparse

Boolean

Indicates if the physical storage for the disk should not be preallocated.

status

DiskStatus

The status of the disk device.

storage_type

DiskStorageType

 

uses_scsi_reservation

Boolean

 

wipe_after_delete

Boolean

Indicates if the disk’s blocks will be read back as zeros after it is deleted:

- On block storage, the disk will be zeroed and only then deleted.

7.50.1. active

Indicates if the disk is visible to the virtual machine.

Important

When adding a disk attachment to a virtual machine, the server accepts requests that don’t contain this attribute, but the effect is then undefined. In some cases the disk will be automatically activated and in other cases it won’t. To avoid issues it is strongly recommended to always include the this attribute with the desired value.

7.50.2. actual_size

The actual size of the disk, in bytes.

The actual size is the number of bytes actually used by the disk, and it will be smaller than the provisioned size for disks that use the cow format.

7.50.3. bootable

Indicates if the disk is marked as bootable.

Important

This attribute only makes sense for disks that are actually connected to virtual machines, and in version 4 of the API it has been moved to the DiskAttachment type. It is preserved here only for backwards compatibility, and it will be removed in the future.

7.50.4. initial_size

The initial size of a sparse image disk created on block storage, in bytes.

The initial size is the number of bytes a sparse disk is initially allocated with when created on block storage. The initial size will be smaller than the provisioned size. If not specified the default initial size used by the system will be allocated.

7.50.5. interface

The type of interface driver used to connect the disk device to the virtual machine.

Important

This attribute only makes sense for disks that are actually connected to virtual machines, and in version 4 of the API it has been moved to the DiskAttachment type. It is preserved here only for backwards compatibility, and it will be removed in the future.

7.50.6. provisioned_size

The virtual size of the disk, in bytes.

This attribute is mandatory when creating a new disk.

7.50.7. qcow_version

The underlying QCOW version of a QCOW volume. The QCOW version specifies to the qemu which qemu version the volume supports. This field can be updated using the update API and will be reported only for QCOW volumes, it is determined by the storage domain’s version which the disk is created on. Storage domains with version lower than V4 support QCOW2 volumes, while V4 storage domains also support QCOW2v3. For more information about features of the different QCOW versions, see here.

7.50.8. shareable

Indicates if the disk can be attached to multiple virtual machines.

Important

When a disk is attached to multiple virtual machines it is the responsibility of the guest operating systems of those virtual machines to coordinate access to it, to avoid corruption of the data, for example using a shared file system like GlusterFS or GFS.

7.50.9. wipe_after_delete

Indicates if the disk’s blocks will be read back as zeros after it is deleted:

  • On block storage, the disk will be zeroed and only then deleted.
  • On file storage, since the file system already guarantees that previously removed blocks are read back as zeros, the disk will be deleted immediately.

Table 7.67. Links summary

NameTypeSummary

disk

Disk

 

disk_profile

DiskProfile

 

instance_type

InstanceType

Optionally references to an instance type the device is used by.

openstack_volume_type

OpenStackVolumeType

 

permissions

Permission[]

 

quota

Quota

 

snapshot

Snapshot

 

statistics

Statistic[]

Statistics exposed by the disk.

storage_domain

StorageDomain

 

storage_domains

StorageDomain[]

The storage domains associated with this disk.

template

Template

Optionally references to a template the device is used by.

vm

Vm

Don’t use this element, use vms instead.

vms

Vm[]

References to the virtual machines that are using this device.

7.51. DiskStatus enum

Table 7.68. Values summary

NameSummary

illegal

 

locked

 

ok

 

7.52. DiskStorageType enum

Table 7.69. Values summary

NameSummary

cinder

 

image

 

lun

 

7.53. DiskType enum

Table 7.70. Values summary

NameSummary

data

 

system

 

7.54. Display struct

Table 7.71. Attributes summary

NameTypeSummary

address

String

 

allow_override

Boolean

 

certificate

Certificate

 

copy_paste_enabled

Boolean

 

disconnect_action

String

 

file_transfer_enabled

Boolean

 

keyboard_layout

String

 

monitors

Integer

 

port

Integer

 

proxy

String

 

secure_port

Integer

 

single_qxl_pci

Boolean

 

smartcard_enabled

Boolean

 

type

DisplayType

 

7.55. DisplayType enum

Table 7.72. Values summary

NameSummary

spice

 

vnc

 

7.56. Dns struct

Represents the DNS resolver configuration.

Table 7.73. Attributes summary

NameTypeSummary

search_domains

Host[]

Array of hosts serving as search domains.

servers

Host[]

Array of hosts serving as DNS servers.

7.57. DnsResolverConfiguration struct

Represents the DNS resolver configuration.

Table 7.74. Attributes summary

NameTypeSummary

name_servers

String[]

Array of addresses of name servers.

7.57.1. name_servers

Array of addresses of name servers. Either IPv4 or IPv6 addresses may be specified.

7.58. Domain struct

This type represents a directory service domain.

Table 7.75. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

user

User

 

Table 7.76. Links summary

NameTypeSummary

groups

Group[]

A reference to all groups in the directory service.

users

User[]

A reference to a list of all users in the directory service.

7.59. EntityExternalStatus enum

Type representing an external entity status.

Table 7.77. Values summary

NameSummary

error

The external entity status is erroneous.

failure

The external entity has an issue that causes failures.

info

There external entity status is okay but with some information that might be relevant.

ok

The external entity status is okay.

warning

The external entity status is okay but with an issue that might require attention.

7.59.1. error

The external entity status is erroneous. This might require a moderate attention.

7.59.2. failure

The external entity has an issue that causes failures. This might require immediate attention.

7.60. EntityProfileDetail struct

Table 7.78. Attributes summary

NameTypeSummary

profile_details

ProfileDetail[]

 

7.61. ErrorHandling struct

Table 7.79. Attributes summary

NameTypeSummary

on_error

MigrateOnError

 

7.62. Event struct

Type representing an event.

Table 7.80. Attributes summary

NameTypeSummary

code

Integer

The event code.

comment

String

Free text containing comments about this object.

correlation_id

String

The event correlation identifier.

custom_data

String

Free text representing custom event data.

custom_id

Integer

A custom event identifier.

description

String

A human-readable description in plain text.

flood_rate

Integer

Defines the flood rate.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

origin

String

Free text identifying the origin of the event.

severity

LogSeverity

The event severity.

time

Date

The event time.

7.62.1. correlation_id

The event correlation identifier. Used in order to correlate several events together.

7.62.2. flood_rate

Defines the flood rate. This prevents flooding in case an event appeared more than once in the defined rate. Defaults is 30 seconds.

Table 7.81. Links summary

NameTypeSummary

cluster

Cluster

Reference to the cluster service.

data_center

DataCenter

Reference to the data center service.

host

Host

Reference to the host service.

storage_domain

StorageDomain

Reference to the storage domain service.

template

Template

Reference to the template service.

user

User

Reference to the user service.

vm

Vm

Reference to the virtual machine service.

7.63. ExternalComputeResource struct

Table 7.82. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

provider

String

 

url

String

 

user

String

 

Table 7.83. Links summary

NameTypeSummary

external_host_provider

ExternalHostProvider

 

7.64. ExternalDiscoveredHost struct

Table 7.84. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

ip

String

 

last_report

String

 

mac

String

 

name

String

A human-readable name in plain text.

subnet_name

String

 

Table 7.85. Links summary

NameTypeSummary

external_host_provider

ExternalHostProvider

 

7.65. ExternalHost struct

Table 7.86. Attributes summary

NameTypeSummary

address

String

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.87. Links summary

NameTypeSummary

external_host_provider

ExternalHostProvider

 

7.66. ExternalHostGroup struct

Table 7.88. Attributes summary

NameTypeSummary

architecture_name

String

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

domain_name

String

 

id

String

A unique identifier.

name

String

A human-readable name in plain text.

operating_system_name

String

 

subnet_name

String

 

Table 7.89. Links summary

NameTypeSummary

external_host_provider

ExternalHostProvider

 

7.67. ExternalHostProvider struct

Table 7.90. Attributes summary

NameTypeSummary

authentication_url

String

Defines the external provider authentication URL address.

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

password

String

Defines password for the user during the authentication process.

properties

Property[]

Array of provider name/value properties.

requires_authentication

Boolean

Defines whether provider authentication is required or not.

url

String

Defines URL address of the external provider.

username

String

Defines user name to be used during authentication process.

7.67.1. requires_authentication

Defines whether provider authentication is required or not.

If authentication is required, both username and password attributes will be used during authentication.

Table 7.91. Links summary

NameTypeSummary

certificates

Certificate[]

 

compute_resources

ExternalComputeResource[]

 

discovered_hosts

ExternalDiscoveredHost[]

 

host_groups

ExternalHostGroup[]

 

hosts

Host[]

 

7.68. ExternalProvider struct

Represents an external provider.

Table 7.92. Attributes summary

NameTypeSummary

authentication_url

String

Defines the external provider authentication URL address.

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

password

String

Defines password for the user during the authentication process.

properties

Property[]

Array of provider name/value properties.

requires_authentication

Boolean

Defines whether provider authentication is required or not.

url

String

Defines URL address of the external provider.

username

String

Defines user name to be used during authentication process.

7.68.1. requires_authentication

Defines whether provider authentication is required or not.

If authentication is required, both username and password attributes will be used during authentication.

7.69. ExternalStatus enum

Table 7.93. Values summary

NameSummary

error

 

failure

 

info

 

ok

 

warning

 

7.70. ExternalSystemType enum

Represents the type of the external system that is associated with the step.

Table 7.94. Values summary

NameSummary

gluster

Represents Gluster as the external system which is associated with the step.

vdsm

Represents VDSM as the external system which is associated with the step.

7.71. ExternalVmImport struct

Describes the parameters for the virtual machine import operation from an external system.

Table 7.95. Attributes summary

NameTypeSummary

name

String

The name of the virtual machine to be imported, as is defined within the external system.

password

String

The password to authenticate against the external hypervisor system.

provider

ExternalVmProviderType

The type of external virtual machine provider.

sparse

Boolean

Specifies the disk allocation policy of the resulting virtual machine: true for sparse, false for preallocated.

url

String

The URL to be passed to the virt-v2v tool for conversion.

username

String

The username to authenticate against the external hypervisor system.

7.71.1. url

The URL to be passed to the virt-v2v tool for conversion.

Example:

vpx://wmware_user@vcenter-host/DataCenter/Cluster/esxi-host?no_verify=1

More examples can be found at http://libguestfs.org/virt-v2v.1.html.

Table 7.96. Links summary

NameTypeSummary

cluster

Cluster

Specifies the target cluster for the resulting virtual machine.

cpu_profile

CpuProfile

Optional.

drivers_iso

File

Optional.

host

Host

Optional.

quota

Quota

Optional.

storage_domain

StorageDomain

Specifies the target storage domain for converted disks.

vm

Vm

The virtual machine entity used to specify a name for the newly created virtual machine.

7.72. ExternalVmProviderType enum

Describes the type of external hypervisor system.

Table 7.97. Values summary

NameSummary

kvm

 

vmware

 

xen

 

7.73. Fault struct

Table 7.98. Attributes summary

NameTypeSummary

detail

String

 

reason

String

 

7.74. FenceType enum

Type representing the type of the fence operation.

Table 7.99. Values summary

NameSummary

manual

Manual host fencing via power management.

restart

Restart the host via power management.

start

Start the host via power management.

status

Check the host power status via power management.

stop

Stop the host via power management.

7.75. FencingPolicy struct

Type representing a cluster fencing policy.

Table 7.100. Attributes summary

NameTypeSummary

enabled

Boolean

Enable or disable fencing on this cluster.

skip_if_connectivity_broken

SkipIfConnectivityBroken

If enabled, we will not fence a host in case more than a configurable percentage of hosts in the cluster lost connectivity as well.

skip_if_gluster_bricks_up

Boolean

A flag indicating if fencing should be skipped if Gluster bricks are up and running in the host being fenced.

skip_if_gluster_quorum_not_met

Boolean

A flag indicating if fencing should be skipped if Gluster bricks are up and running and Gluster quorum will not be met without those bricks.

skip_if_sd_active

SkipIfSdActive

If enabled, we will skip fencing in case the host maintains its lease in the storage.

7.75.1. skip_if_connectivity_broken

If enabled, we will not fence a host in case more than a configurable percentage of hosts in the cluster lost connectivity as well. This comes to prevent fencing storm in cases where there is a global networking issue in the cluster.

7.75.2. skip_if_gluster_bricks_up

A flag indicating if fencing should be skipped if Gluster bricks are up and running in the host being fenced. This flag is optional, and the default value is false.

7.75.3. skip_if_gluster_quorum_not_met

A flag indicating if fencing should be skipped if Gluster bricks are up and running and Gluster quorum will not be met without those bricks. This flag is optional, and the default value is false.

7.75.4. skip_if_sd_active

If enabled, we will skip fencing in case the host maintains its lease in the storage. It means that if the host still has storage access then it won’t get fenced.

7.76. File struct

Table 7.101. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

content

String

 

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

type

String

 

Table 7.102. Links summary

NameTypeSummary

storage_domain

StorageDomain

 

7.77. Filter struct

Table 7.103. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

position

Integer

 

Table 7.104. Links summary

NameTypeSummary

scheduling_policy_unit

SchedulingPolicyUnit

 

7.78. Floppy struct

Table 7.105. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

file

File

 

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.106. Links summary

NameTypeSummary

instance_type

InstanceType

Optionally references to an instance type the device is used by.

template

Template

Optionally references to a template the device is used by.

vm

Vm

Don’t use this element, use vms instead.

vms

Vm[]

References to the virtual machines that are using this device.

7.79. FopStatistic struct

Table 7.107. Attributes summary

NameTypeSummary

name

String

 

statistics

Statistic[]

 

7.80. GlusterBrick struct

Table 7.108. Attributes summary

NameTypeSummary

brick_dir

String

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

device

String

 

fs_name

String

 

gluster_clients

GlusterClient[]

 

id

String

A unique identifier.

memory_pools

GlusterMemoryPool[]

 

mnt_options

String

 

name

String

A human-readable name in plain text.

pid

Integer

 

port

Integer

 

server_id

String

 

status

GlusterBrickStatus

 

Table 7.109. Links summary

NameTypeSummary

gluster_volume

GlusterVolume

 

instance_type

InstanceType

Optionally references to an instance type the device is used by.

statistics

Statistic[]

 

template

Template

Optionally references to a template the device is used by.

vm

Vm

Don’t use this element, use vms instead.

vms

Vm[]

References to the virtual machines that are using this device.

7.81. GlusterBrickAdvancedDetails struct

Table 7.110. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

device

String

 

fs_name

String

 

gluster_clients

GlusterClient[]

 

id

String

A unique identifier.

memory_pools

GlusterMemoryPool[]

 

mnt_options

String

 

name

String

A human-readable name in plain text.

pid

Integer

 

port

Integer

 

Table 7.111. Links summary

NameTypeSummary

instance_type

InstanceType

Optionally references to an instance type the device is used by.

template

Template

Optionally references to a template the device is used by.

vm

Vm

Don’t use this element, use vms instead.

vms

Vm[]

References to the virtual machines that are using this device.

7.82. GlusterBrickMemoryInfo struct

Table 7.112. Attributes summary

NameTypeSummary

memory_pools

GlusterMemoryPool[]

 

7.83. GlusterBrickStatus enum

Table 7.113. Values summary

NameSummary

down

Brick is in down state, the data cannot be stored or retrieved from it.

unknown

When the status cannot be determined due to host being non-responsive.

up

Brick is in up state, the data can be stored or retrieved from it.

7.84. GlusterClient struct

Table 7.114. Attributes summary

NameTypeSummary

bytes_read

Integer

 

bytes_written

Integer

 

client_port

Integer

 

host_name

String

 

7.85. GlusterHook struct

Table 7.115. Attributes summary

NameTypeSummary

checksum

String

 

comment

String

Free text containing comments about this object.

conflict_status

Integer

 

conflicts

String

 

content

String

 

content_type

HookContentType

 

description

String

A human-readable description in plain text.

gluster_command

String

 

id

String

A unique identifier.

name

String

A human-readable name in plain text.

stage

HookStage

 

status

GlusterHookStatus

 

Table 7.116. Links summary

NameTypeSummary

cluster

Cluster

 

server_hooks

GlusterServerHook[]

 

7.86. GlusterHookStatus enum

Table 7.117. Values summary

NameSummary

disabled

Hook is disabled in the cluster.

enabled

Hook is enabled in the cluster.

missing

Unknown/missing hook status.

7.87. GlusterMemoryPool struct

Table 7.118. Attributes summary

NameTypeSummary

alloc_count

Integer

 

cold_count

Integer

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

hot_count

Integer

 

id

String

A unique identifier.

max_alloc

Integer

 

max_stdalloc

Integer

 

name

String

A human-readable name in plain text.

padded_size

Integer

 

pool_misses

Integer

 

type

String

 

7.88. GlusterServerHook struct

Table 7.119. Attributes summary

NameTypeSummary

checksum

String

 

comment

String

Free text containing comments about this object.

content_type

HookContentType

 

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

status

GlusterHookStatus

 

Table 7.120. Links summary

NameTypeSummary

host

Host

 

7.89. GlusterState enum

Table 7.121. Values summary

NameSummary

down

 

unknown

 

up

 

7.90. GlusterVolume struct

Table 7.122. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

disperse_count

Integer

 

id

String

A unique identifier.

name

String

A human-readable name in plain text.

options

Option[]

 

redundancy_count

Integer

 

replica_count

Integer

 

status

GlusterVolumeStatus

 

stripe_count

Integer

 

transport_types

TransportType[]

 

volume_type

GlusterVolumeType

 

Table 7.123. Links summary

NameTypeSummary

bricks

GlusterBrick[]

 

cluster

Cluster

 

statistics

Statistic[]

 

7.91. GlusterVolumeProfileDetails struct

Table 7.124. Attributes summary

NameTypeSummary

brick_profile_details

BrickProfileDetail[]

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

nfs_profile_details

NfsProfileDetail[]

 

7.92. GlusterVolumeStatus enum

Table 7.125. Values summary

NameSummary

down

Volume needs to be started, for clients to be able to mount and use it.

unknown

When the status cannot be determined due to host being non-responsive.

up

Volume is started, and can be mounted and used by clients.

7.93. GlusterVolumeType enum

Type representing the type of Gluster Volume.

Table 7.126. Values summary

NameSummary

disperse

Dispersed volumes are based on erasure codes, providing space-efficient protection against disk or server failures.

distribute

Distributed volumes distributes files throughout the bricks in the volume.

distributed_disperse

Distributed dispersed volumes distribute files across dispersed subvolumes.

distributed_replicate

Distributed replicated volumes distributes files across replicated bricks in the volume.

distributed_stripe

Distributed striped volumes stripe data across two or more nodes in the cluster.

distributed_striped_replicate

Distributed striped replicated volumes distributes striped data across replicated bricks in the cluster.

replicate

Replicated volumes replicates files across bricks in the volume.

stripe

Striped volumes stripes data across bricks in the volume.

striped_replicate

Striped replicated volumes stripes data across replicated bricks in the cluster.

7.93.1. disperse

Dispersed volumes are based on erasure codes, providing space-efficient protection against disk or server failures.

Dispersed volumes an encoded fragment of the original file to each brick in a way that only a subset of the fragments is needed to recover the original file. The number of bricks that can be missing without losing access to data is configured by the administrator on volume creation time.

7.93.2. distribute

Distributed volumes distributes files throughout the bricks in the volume.

Distributed volumes can be used where the requirement is to scale storage and the redundancy is either not important or is provided by other hardware/software layers.

7.93.3. distributed_disperse

Distributed dispersed volumes distribute files across dispersed subvolumes.

This has the same advantages of distribute replicate volumes, but using disperse to store the data into the bricks.

7.93.4. distributed_replicate

Distributed replicated volumes distributes files across replicated bricks in the volume.

Distributed replicated volumes can be used in environments where the requirement is to scale storage and high-reliability is critical. Distributed replicated volumes also offer improved read performance in most environments.

7.93.5. distributed_stripe

Distributed striped volumes stripe data across two or more nodes in the cluster.

Distributed striped volumes should be used where the requirement is to scale storage and in high concurrency environments accessing very large files is critical.

Note: With the introduction of Sharding in Glusterfs 3.7 releases, striped volumes are not recommended and it will be removed in future release.

7.93.6. distributed_striped_replicate

Distributed striped replicated volumes distributes striped data across replicated bricks in the cluster.

For best results, distributed striped replicated volumes should be used in highly concurrent environments where parallel access of very large files and performance is critical.

Note: With the introduction of Sharding in Glusterfs 3.7 releases, striped volumes are not recommended and it will be removed in future release.

7.93.7. replicate

Replicated volumes replicates files across bricks in the volume.

Replicated volumes can be used in environments where high-availability and high-reliability are critical.

7.93.8. stripe

Striped volumes stripes data across bricks in the volume.

For best results, striped volumes should only in high concurrency environments accessing very large files.

Note: With the introduction of Sharding in Glusterfs 3.7 releases, striped volumes are not recommended and it will be removed in future release.

7.93.9. striped_replicate

Striped replicated volumes stripes data across replicated bricks in the cluster.

For best results, striped replicated volumes should be used in highly concurrent environments where there is parallel access of very large files and performance is critical.

Note: With the introduction of Sharding in Glusterfs 3.7 releases, striped volumes are not recommended and it will be removed in future release.

7.94. GracePeriod struct

Table 7.127. Attributes summary

NameTypeSummary

expiry

Integer

 

7.95. GraphicsConsole struct

Table 7.128. Attributes summary

NameTypeSummary

address

String

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

port

Integer

 

protocol

GraphicsType

 

tls_port

Integer

 

Table 7.129. Links summary

NameTypeSummary

instance_type

InstanceType

 

template

Template

 

vm

Vm

 

7.96. GraphicsType enum

Table 7.130. Values summary

NameSummary

spice

 

vnc

 

7.97. Group struct

This type represents all groups in the directory service.

Table 7.131. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

domain_entry_id

String

The containing directory service domain id.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

namespace

String

Namespace where group resides.

Table 7.132. Links summary

NameTypeSummary

domain

Domain

A link to the domain containing this group.

permissions

Permission[]

A link to the permissions sub-collection for permissions attached to this group.

roles

Role[]

A link to the roles sub-collection for roles attached to this group.

tags

Tag[]

A link to the tags sub-collection for tags attached to this group.

7.98. GuestOperatingSystem struct

Table 7.133. Attributes summary

NameTypeSummary

architecture

String

 

codename

String

 

distribution

String

 

family

String

 

kernel

Kernel

 

version

Version

 

7.99. HardwareInformation struct

Table 7.134. Attributes summary

NameTypeSummary

family

String

 

manufacturer

String

 

product_name

String

 

serial_number

String

 

supported_rng_sources

RngSource[]

 

uuid

String

 

version

String

 

7.100. HighAvailability struct

Table 7.135. Attributes summary

NameTypeSummary

enabled

Boolean

 

priority

Integer

Indicates the priority of the virtual machine inside the run and migration queues.

7.100.1. priority

Indicates the priority of the virtual machine inside the run and migration queues.

Virtual machines with higher priorities will be started and migrated before virtual machines with lower priorities.

The value is an integer between 0 and 100. The higher the value, the higher the priority.

The graphical user interface (GUI) does not allow specifying all the possible values, instead it only allows you to select Low, Medium or High. When the value is set using the API, the GUI will set the label as follows:

API ValueGUI Label

0 - 25

Low

26 - 74

Medium

75 - 100

High

When the label is selected using the GUI, the value in the API will be set as follows:

GUI LabelAPI Value

Low

1

Medium

50

High

100

7.101. Hook struct

Represents a hook.

Table 7.136. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

event_name

String

Name of the event to execute the hook on.

id

String

A unique identifier.

md5

String

Checksum of the hook.

name

String

A human-readable name in plain text.

Table 7.137. Links summary

NameTypeSummary

host

Host

Reference to the host the hook belongs to.

7.102. HookContentType enum

Represents content type of hook script.

Table 7.138. Values summary

NameSummary

binary

Binary content type of the hook.

text

Text content type of the hook.

7.103. HookStage enum

Table 7.139. Values summary

NameSummary

post

 

pre

 

7.104. HookStatus enum

Type represents the status of a hook.

Table 7.140. Values summary

NameSummary

disabled

Hook is disabled.

enabled

Hook is enabled.

missing

Hook is missing.

7.105. Host struct

Type representing a host.

Table 7.141. Attributes summary

NameTypeSummary

address

String

The host address (FQDN/IP).

auto_numa_status

AutoNumaStatus

The host auto non uniform memory access (NUMA) status.

certificate

Certificate

The host certificate.

comment

String

Free text containing comments about this object.

cpu

Cpu

The CPU type of this host.

description

String

A human-readable description in plain text.

device_passthrough

HostDevicePassthrough

Specifies whether host device passthrough is enabled on this host.

display

Display

Optionally specify the display address of this host explicitly.

external_status

ExternalStatus

The host external status.

hardware_information

HardwareInformation

The host hardware information.

hosted_engine

HostedEngine

The hosted engine status on this host.

id

String

A unique identifier.

iscsi

IscsiDetails

The host iSCSI details.

kdump_status

KdumpStatus

The host KDUMP status.

ksm

Ksm

Kernel SamePage Merging (KSM) reduces references to memory pages from multiple identical pages to a single page reference.

libvirt_version

Version

The host libvirt version.

max_scheduling_memory

Integer

The max scheduling memory on this host in bytes.

memory

Integer

The amount of physical memory on this host in bytes.

name

String

A human-readable name in plain text.

numa_supported

Boolean

Specifies whether non uniform memory access (NUMA) is supported on this host.

os

OperatingSystem

The operating system on this host.

override_iptables

Boolean

Specifies whether we should override firewall definitions.

port

Integer

The host port.

power_management

PowerManagement

The host power management definitions.

protocol

HostProtocol

The protocol that the engine uses to communicate with the host.

root_password

String

When creating a new host, a root password is required if the password authentication method is chosen, but this is not subsequently included in the representation.

se_linux

SeLinux

The host SElinux status.

spm

Spm

The host storage pool manager (SPM) status and definition.

ssh

Ssh

The SSH definitions.

status

HostStatus

The host status.

status_detail

String

The host status details.

summary

VmSummary

The virtual machine summary - how many are active, migrating and total.

transparent_huge_pages

TransparentHugePages

Transparent huge page support expands the size of memory pages beyond the standard 4 KiB limit.

type

HostType

Indicates if the host contains a full installation of the operating system or a scaled-down version intended only to host virtual machines.

update_available

Boolean

Specifies whether there is an oVirt-related update on this host.

version

Version

The version of VDSM.

7.105.1. external_status

The host external status. This can be used by third-party software to change the host external status in case of an issue. This has no effect on the host lifecycle, unless a third-party software checks for this status and acts accordingly.

7.105.2. kdump_status

The host KDUMP status. KDUMP happens when the host kernel has crashed and it is now going through memory dumping.

7.105.3. ksm

Kernel SamePage Merging (KSM) reduces references to memory pages from multiple identical pages to a single page reference. This helps with optimization for memory density.

For example, to enable KSM for host 123, send a request like this:

PUT /ovirt-engine/api/hosts/123

With a request body like this:

<host>
  <ksm>
    <enabled>true</enabled>
  </ksm>
</host>

7.105.4. libvirt_version

The host libvirt version. For more information on libvirt please go to libvirt.

7.105.5. override_iptables

Specifies whether we should override firewall definitions. This applies only when the host is installed or re-installed.

7.105.6. protocol

The protocol that the engine uses to communicate with the host.

Warning

Since version 4.1 of the engine the protocol is always set to stomp since xml was removed.

7.105.7. se_linux

The host SElinux status. Security-Enhanced Linux (SELinux) is a component in the Linux kernel that provides a mechanism for supporting access control security policies.

7.105.8. spm

The host storage pool manager (SPM) status and definition. Use it to set the SPM priority of this host, and to see whether this is the current SPM or not.

7.105.9. status_detail

The host status details. Relevant for Gluster hosts.

7.105.10. transparent_huge_pages

Transparent huge page support expands the size of memory pages beyond the standard 4 KiB limit. This reduces memory consumption and increases host performance.

For example, to enable transparent huge page support for host 123, send a request like this:

PUT /ovirt-engine/api/hosts/123

With a request body like this:

<host>
  <transparent_hugepages>
    <enabled>true</enabled>
  </transparent_hugepages>
</host>

7.105.11. version

The version of VDSM.

For example:

GET /ovirt-engine/api/hosts/123

This GET request will return the following output:

<host>
  ...
  <version>
    <build>999</build>
    <full_version>vdsm-4.18.999-419.gitcf06367.el7</full_version>
    <major>4</major>
    <minor>18</minor>
    <revision>0</revision>
  </version>
  ...
</host>

Table 7.142. Links summary

NameTypeSummary

affinity_labels

AffinityLabel[]

 

agents

Agent[]

 

cluster

Cluster

 

devices

Device[]

 

external_host_provider

ExternalHostProvider

 

hooks

Hook[]

 

katello_errata

KatelloErratum[]

Lists all the Katello errata assigned to the host.

network_attachments

NetworkAttachment[]

 

nics

HostNic[]

 

numa_nodes

NumaNode[]

 

permissions

Permission[]

 

statistics

Statistic[]

Each host resource exposes a statistics sub-collection for host-specific statistics.

storage_connection_extensions

StorageConnectionExtension[]

 

storages

HostStorage[]

 

tags

Tag[]

 

unmanaged_networks

UnmanagedNetwork[]

 

7.106. HostDevice struct

Table 7.143. Attributes summary

NameTypeSummary

capability

String

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

driver

String

The name of the driver this device is bound to.

id

String

A unique identifier.

iommu_group

Integer

 

name

String

A human-readable name in plain text.

physical_function

HostDevice

 

placeholder

Boolean

 

product

Product

 

vendor

Vendor

 

virtual_functions

Integer

 

7.106.1. driver

The name of the driver this device is bound to.

For example: pcieport or uhci_hcd.

Table 7.144. Links summary

NameTypeSummary

host

Host

 

parent_device

HostDevice

 

vm

Vm

 

7.107. HostDevicePassthrough struct

Table 7.145. Attributes summary

NameTypeSummary

enabled

Boolean

 

7.108. HostNic struct

Represents a host NIC.

For example, the XML representation of a host NIC looks like this:

<host_nic href="/ovirt-engine/api/hosts/123/nics/456" id="456">
  <name>eth0</name>
  <boot_protocol>static</boot_protocol>
  <bridged>true</bridged>
  <custom_configuration>true</custom_configuration>
  <ip>
    <address>192.168.122.39</address>
    <gateway>192.168.122.1</gateway>
    <netmask>255.255.255.0</netmask>
    <version>v4</version>
  </ip>
  <ipv6>
    <gateway>::</gateway>
    <version>v6</version>
  </ipv6>
  <ipv6_boot_protocol>none</ipv6_boot_protocol>
  <mac>
    <address>52:54:00:0c:79:1d</address>
  </mac>
  <mtu>1500</mtu>
  <status>up</status>
</host_nic>

A bonded interface is represented as a HostNic object containing the bonding and slaves attributes.

For example, the XML representation of a bonded host NIC looks like this:

<host_nic href="/ovirt-engine/api/hosts/123/nics/456" id="456">
  <name>bond0</name>
  <mac address="00:00:00:00:00:00"/>
  <ip>
    <address>192.168.122.39</address>
    <gateway>192.168.122.1</gateway>
    <netmask>255.255.255.0</netmask>
    <version>v4</version>
  </ip>
  <boot_protocol>dhcp</boot_protocol>
  <bonding>
    <options>
      <option>
        <name>mode</name>
        <value>4</value>
        <type>Dynamic link aggregation (802.3ad)</type>
      </option>
      <option>
        <name>miimon</name>
        <value>100</value>
      </option>
    </options>
    <slaves>
      <host_nic id="123"/>
      <host_nic id="456"/>
    </slaves>
  </bonding>
  <mtu>1500</mtu>
  <bridged>true</bridged>
  <custom_configuration>false</custom_configuration>
</host_nic>

Table 7.146. Attributes summary

NameTypeSummary

ad_aggregator_id

Integer

The ad_aggregator_id property of a bond or bond slave, for bonds in mode 4.

base_interface

String

The base interface of the NIC.

bonding

Bonding

The bonding parameters of the NIC.

boot_protocol

BootProtocol

The IPv4 boot protocol configuration of the NIC.

bridged

Boolean

Defines the bridged network status.

check_connectivity

Boolean

 

comment

String

Free text containing comments about this object.

custom_configuration

Boolean

 

description

String

A human-readable description in plain text.

id

String

A unique identifier.

ip

Ip

The IPv4 address of the NIC.

ipv6

Ip

The IPv6 address of the NIC.

ipv6_boot_protocol

BootProtocol

The IPv6 boot protocol configuration of the NIC.

mac

Mac

The MAC address of the NIC.

mtu

Integer

The maximum transmission unit for the interface.

name

String

A human-readable name in plain text.

network_labels

NetworkLabel[]

The labels that are applied to this NIC.

override_configuration

Boolean

 

properties

Property[]

 

speed

Integer

 

statistics

Statistic[]

A link to the statistics of the NIC.

status

NicStatus

 

virtual_functions_configuration

HostNicVirtualFunctionsConfiguration

Describes the virtual functions configuration of a physical function NIC.

vlan

Vlan

 

7.108.1. ad_aggregator_id

The ad_aggregator_id property of a bond or bond slave, for bonds in mode 4. Bond mode 4 is the 802.3ad standard, also called dynamic link aggregation. (See Wikipedia and Presentation for more information). This is only valid for bonds in mode 4, or NICs which are part of a bond. It is not present for bonds in other modes, or NICs which are not part of a bond in mode 4. The ad_aggregator_id property indicates which of the bond slaves are active. The value of the ad_aggregator_id of an active slave is the same as the value of the ad_aggregator_id property of the bond. This parameter is read only. Setting it will have no effect on the bond/NIC. It is retrieved from the /sys/class/net/bondX/bonding/ad_aggregator file for a bond, and the /sys/class/net/ensX/bonding_slave/ad_aggregator_id file for a NIC.

7.108.2. bridged

Defines the bridged network status. Set to true for a bridged network and false for a bridgeless network.

7.108.3. statistics

A link to the statistics of the NIC.

The data types for HostNic statistical values:

  • data.current.rx - The rate in bytes per second of data received.
  • data.current.tx - The rate in bytes per second of data transmitted.
  • data.total.rx - Total received data.
  • data.total.tx - Total transmitted data.
  • errors.total.rx - Total errors from receiving data.
  • errors.total.tx - Total errors from transmitting data.

Table 7.147. Links summary

NameTypeSummary

host

Host

 

network

Network

A reference to the network to which the interface should be connected.

physical_function

HostNic

A reference to the physical function NIC of a SR-IOV virtual function NIC.

qos

Qos

A link to the quality-of-service configuration of the interface.

7.109. HostNicVirtualFunctionsConfiguration struct

Describes the virtual functions configuration of an SR-IOV-enabled physical function NIC.

Table 7.148. Attributes summary

NameTypeSummary

all_networks_allowed

Boolean

Defines whether all networks are allowed to be defined on the related virtual functions, or specified ones only.

max_number_of_virtual_functions

Integer

The maximum number of virtual functions the NIC supports.

number_of_virtual_functions

Integer

The number of virtual functions currently defined.

7.109.1. max_number_of_virtual_functions

The maximum number of virtual functions the NIC supports. This property is read-only.

7.109.2. number_of_virtual_functions

The number of virtual functions currently defined. A user-defined value between 0 and max_number_of_virtual_functions.

7.110. HostProtocol enum

The protocol used by the engine to communicate with a host.

Warning

Since version 4.1 of the engine the protocol is always set to stomp since xml was removed.

Table 7.149. Values summary

NameSummary

stomp

JSON-RPC protocol on top of STOMP.

xml

XML-RPC protocol.

7.111. HostStatus enum

Type representing a host status.

Table 7.150. Values summary

NameSummary

connecting

The engine cannot communicate with the host for a specific threshold so it is now trying to connect before going through fencing.

down

The host is down.

error

The host is in error status.

initializing

The host is initializing.

install_failed

The host installation failed.

installing

The host is being installed.

installing_os

The host operating system is now installing.

kdumping

The host kernel has crashed and it is now going through memory dumping.

maintenance

The host is in maintenance status.

non_operational

The host is non operational.

non_responsive

The host is not responsive.

pending_approval

The host is pending administrator approval.

preparing_for_maintenance

The host is preparing for maintenance.

reboot

The host is being rebooted.

unassigned

The host is in activation process.

up

The host is up.

7.111.1. error

The host is in error status. This will happen if we will try to run a virtual machine several times and it will fail.

7.111.2. initializing

The host is initializing. This is an intermediate step before moving the host to 'up' status.

7.111.3. install_failed

The host installation failed. In such cases look at the event log to understand what failed the installation, and issue a re-install.

7.111.4. installing_os

The host operating system is now installing. This status is relevant when using a Satellite/Foreman provider, and issuing a bare-metal provisioning (discovered host provisioning).

7.111.5. maintenance

The host is in maintenance status. When a host is in maintenance it cannot run virtual machines.

7.111.6. non_operational

The host is non operational. This can happen due to various reasons, such as not having a connection with the storage, not supporting a mandatory network, not supporting the cluster level, and more.

7.111.7. non_responsive

The host is not responsive. This means that the engine is not able to communicate with the host.

7.111.8. pending_approval

The host is pending administrator approval. This is relevant only for vintage ovirt-node / RHV-H.

7.111.9. preparing_for_maintenance

The host is preparing for maintenance. During this time the engine makes sure to live migrate all the virtual machines from this host to other hosts. Once all migrations have been completed the host will move to 'maintenance' status.

7.112. HostStorage struct

Table 7.151. Attributes summary

NameTypeSummary

address

String

 

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

logical_units

LogicalUnit[]

 

mount_options

String

 

name

String

A human-readable name in plain text.

nfs_retrans

Integer

The number of times to retry a request before attempting further recovery actions.

nfs_timeo

Integer

The time in tenths of a second to wait for a response before retrying NFS requests.

nfs_version

NfsVersion

 

override_luns

Boolean

 

password

String

 

path

String

 

port

Integer

 

portal

String

 

target

String

 

type

StorageType

 

username

String

 

vfs_type

String

 

volume_group

VolumeGroup

 

7.112.1. nfs_retrans

The number of times to retry a request before attempting further recovery actions. The value must be in the range of 0 to 65535. For more details see the description of the retrans mount option in the nfs man page.

7.112.2. nfs_timeo

The time in tenths of a second to wait for a response before retrying NFS requests. The value must be in the range of 0 to 65535. For more details see the description of the timeo mount option in the nfs man page.

Table 7.152. Links summary

NameTypeSummary

host

Host

 

7.113. HostType enum

This enumerated type is used to determine which type of operating system is used by the host.

Table 7.153. Values summary

NameSummary

ovirt_node

The host contains Red Hat Virtualization Host (RHVH): a new implementation of Red Hat Enterprise Virtualization Hypervisor (RHEV-H) which uses the same installer as Red Hat Enterprise Linux, CentOS, or Fedora.

rhel

The host contains a full Red Hat Enterprise Linux, CentOS, or Fedora installation.

rhev_h

The host contains Red Hat Enterprise Virtualization Hypervisor (RHEV-H), a small-scaled version of Red Hat Enterprise Linux, CentOS, or Fedora, used solely to host virtual machines.

7.113.1. ovirt_node

The host contains Red Hat Virtualization Host (RHVH): a new implementation of Red Hat Enterprise Virtualization Hypervisor (RHEV-H) which uses the same installer as Red Hat Enterprise Linux, CentOS, or Fedora. The main difference between RHVH and legacy RHEV-H is that RHVH has a writeable file system and will handle its own installation instead of having RPMs pushed to it by the Manager like in legacy RHEV-H.

7.114. HostedEngine struct

Table 7.154. Attributes summary

NameTypeSummary

active

Boolean

 

configured

Boolean

 

global_maintenance

Boolean

 

local_maintenance

Boolean

 

score

Integer

 

7.115. Icon struct

Icon of virtual machine or template.

Table 7.155. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

data

String

Base64 encode content of the icon file.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

media_type

String

Format of icon file.

name

String

A human-readable name in plain text.

7.115.1. media_type

Format of icon file.

One of:

  • image/jpeg
  • image/png
  • image/gif

7.116. Identified struct

This interface is the base model for all types that represent objects with an identifier.

Table 7.156. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

7.117. Image struct

Table 7.157. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.158. Links summary

NameTypeSummary

storage_domain

StorageDomain

 

7.118. ImageTransfer struct

This type contains information regarding an image transfer being performed.

Table 7.159. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

direction

ImageTransferDirection

The direction indicates whether the transfer is sending image data (upload) or receiving image data (download).

id

String

A unique identifier.

name

String

A human-readable name in plain text.

phase

ImageTransferPhase

The current phase of the image transfer in progress.

proxy_url

String

The URL of the proxy server that the user inputs or outputs to.

signed_ticket

String

The signed ticket that should be attached as an Authentication header in the HTTPS request for the proxy server to input or output to (See the proxy_url attribute).

7.118.1. direction

The direction indicates whether the transfer is sending image data (upload) or receiving image data (download).

If a direction is not set during an addition of a new transfer, The default direction for the transfer will be upload.

7.118.2. phase

The current phase of the image transfer in progress. Each transfer needs a managed session, which must be opened for the user to input or output an image. Please refer to image transfer for further documentation.

7.118.3. proxy_url

The URL of the proxy server that the user inputs or outputs to. This attribute is available only if the image transfer entity is in the transferring phase. See phase for details.

Table 7.160. Links summary

NameTypeSummary

host

Host

The host which will be used to write to the image which is targeted for input or output.

image

Image

The image which is targeted for input or output.

7.119. ImageTransferDirection enum

The image transfer direction for a transfer.

When adding a new transfer, the user can choose whether the transfer will be to an image, choosing upload, or to transfer from an image- choosing download as an ImageTransferDirection.

Please refer to image transfer for further documentation.

Table 7.161. Values summary

NameSummary

download

The user must choose download when he/she wants to stream data from an image.

upload

The user can choose upload when he/she wants to stream data to an image.

7.120. ImageTransferPhase enum

A list of possible phases for an image transfer entity. Each of these values defines a specific point in a transfer flow.

Please refer to image transfer for more information.

Table 7.162. Values summary

NameSummary

cancelled

This phase will be set as a result of the user cancelling the transfer.

finalizing_failure

This phase can only be set in the Administration Portal, and indicates that there was an error during the transfer, and it is being finalized with a failure.

finalizing_success

This phase will be set when the user calls finalize.

finished_failure

Indicates that the targeted image failed the verification, and cannot be used.

finished_success

Indicates that the transfer session was successfully closed, and the targeted image was verified and ready to be used.

initializing

The initial phase of an image transfer.

paused_system

This phase means the session timed out, or some other error occurred with this transfer; for example ovirt-imageio-daemon is not running in the selected host.

paused_user

This phase is a result of a pause call by the user, using pause.

resuming

The phase where the transfer has been resumed by the client calling resume.

transferring

The phase where the transfer session is open, and the client can input or output the desired image using the preferred tools.

unknown

An unknown phase.

7.120.1. cancelled

This phase will be set as a result of the user cancelling the transfer. The cancellation can only be performed in the Administration Portal.

7.120.2. finalizing_success

This phase will be set when the user calls finalize. Calling finalize is essential to finish the transfer session, and finish using the targeted image. After finalizing, the phase will be changed to finished_success or finished_failure.

Refer to image transfer for more information.

7.120.3. finished_failure

Indicates that the targeted image failed the verification, and cannot be used. After reaching this phase, the image transfer entity will be deleted, and the targeted image will be set to illegal.

7.120.4. finished_success

Indicates that the transfer session was successfully closed, and the targeted image was verified and ready to be used. After reaching this phase, the image transfer entity will be deleted.

7.120.5. initializing

The initial phase of an image transfer. It is set while the transfer session is establishing. Once the session is established, the phase will be changed to transferring

7.120.6. paused_system

This phase means the session timed out, or some other error occurred with this transfer; for example ovirt-imageio-daemon is not running in the selected host. To resume the session, the client should call resume. After resuming, the phase will change to resuming.

7.120.7. resuming

The phase where the transfer has been resumed by the client calling resume. Resuming starts a new session, and after calling it, the phase will be changed to transferring, or paused_system in case of a failure.

7.120.8. unknown

An unknown phase. This will only be set in cases of unpredictable errors.

7.121. InheritableBoolean enum

Enum representing the boolean value that can be either set, or inherited from a higher level. The inheritance order is virtual machine → cluster → engine-config.

Table 7.163. Values summary

NameSummary

false

Set the value to false on this level.

inherit

Inherit the value from higher level.

true

Set the value to true on this level.

7.122. Initialization struct

Table 7.164. Attributes summary

NameTypeSummary

active_directory_ou

String

 

authorized_ssh_keys

String

 

cloud_init

CloudInit

 

configuration

Configuration

 

custom_script

String

 

dns_search

String

 

dns_servers

String

 

domain

String

 

host_name

String

 

input_locale

String

 

nic_configurations

NicConfiguration[]

 

org_name

String

 

regenerate_ids

Boolean

 

regenerate_ssh_keys

Boolean

 

root_password

String

 

system_locale

String

 

timezone

String

 

ui_language

String

 

user_locale

String

 

user_name

String

 

windows_license_key

String

 

7.123. InstanceType struct

Describes the hardware configuration of virtual machines.

For example medium instance type includes 1 virtual CPU and 4 GiB of memory. It is a top-level entity (e.g. not bound to any data center or cluster). The attributes that are used for instance types and are common to virtual machine and template types are:

  • console
  • cpu
  • custom_cpu_model
  • custom_emulated_machine
  • display
  • high_availability
  • io
  • memory
  • memory_policy
  • migration
  • migration_downtime
  • os
  • rng_device
  • soundcard_enabled
  • usb
  • virtio_scsi

When creating a virtual machine from both an instance type and a template, the virtual machine will inherit the hardware configurations from the instance type

Note

An instance type inherits it’s attributes from the template entity although most template attributes are not used in instance types.

Table 7.165. Attributes summary

NameTypeSummary

bios

Bios

Reference to virtual machine’s BIOS configuration.

comment

String

Free text containing comments about this object.

console

Console

Console configured for this virtual machine.

cpu

Cpu

The configuration of the virtual machine CPU.

cpu_shares

Integer

 

creation_time

Date

The virtual machine creation date.

custom_compatibility_version

Version

Virtual machine custom compatibility version.

custom_cpu_model

String

 

custom_emulated_machine

String

 

custom_properties

CustomProperty[]

Properties sent to VDSM to configure various hooks.

delete_protected

Boolean

If true, the virtual machine cannot be deleted.

description

String

A human-readable description in plain text.

display

Display

The virtual machine display configuration.

domain

Domain

Domain configured for this virtual machine.

high_availability

HighAvailability

The virtual machine high availability configuration.

id

String

A unique identifier.

initialization

Initialization

Reference to virtual machine’s initialization configuration.

io

Io

For performance tuning of IO threading.

large_icon

Icon

Virtual machine’s large icon.

lease

StorageDomainLease

Reference to the storage domain this virtual machine/template lease reside on.

memory

Integer

The virtual machine’s memory, in bytes.

memory_policy

MemoryPolicy

Reference to virtual machine’s memory management configuration.

migration

MigrationOptions

Reference to configuration of migration of running virtual machine to another host.

migration_downtime

Integer

Maximum time the virtual machine can be non responsive during its live migration to another host in ms.

name

String

A human-readable name in plain text.

origin

String

The origin of this virtual machine.

os

OperatingSystem

Operating system type installed on the virtual machine.

rng_device

RngDevice

Random Number Generator device configuration for this virtual machine.

serial_number

SerialNumber

Virtual machine’s serial number in a cluster.

small_icon

Icon

Virtual machine’s small icon.

soundcard_enabled

Boolean

If true, the sound card is added to the virtual machine.

sso

Sso

Reference to the Single Sign On configuration this virtual machine is configured for.

start_paused

Boolean

If true, the virtual machine will be initially in 'paused' state after start.

stateless

Boolean

If true, the virtual machine is stateless - it’s state (disks) are rolled-back after shutdown.

status

TemplateStatus

The status of the template.

time_zone

TimeZone

The virtual machine’s time zone set by oVirt.

tunnel_migration

Boolean

If true, the network data transfer will be encrypted during virtual machine live migration.

type

VmType

Determines whether the virtual machine is optimized for desktop or server.

usb

Usb

Configuration of USB devices for this virtual machine (count, type).

version

TemplateVersion

Indicates whether this is a base version or a sub version of another template.

virtio_scsi

VirtioScsi

Reference to VirtIO SCSI configuration.

vm

Vm

The virtual machine configuration associated with this template.

7.123.1. cpu

The configuration of the virtual machine CPU.

The socket configuration can be updated without rebooting the virtual machine. The cores and the threads require a reboot.

For example, to change the number of sockets to 4 immediately, and the number of cores and threads to 2 after reboot, send the following request:

PUT /ovirt-engine/api/vms/123

With a request body:

<vm>
  <cpu>
    <topology>
      <sockets>4</sockets>
      <cores>2</cores>
      <threads>2</threads>
    </topology>
  </cpu>
</vm>

7.123.2. custom_compatibility_version

Virtual machine custom compatibility version.

Enables a virtual machine to be customized to its own compatibility version. If custom_compatibility_version is set, it overrides the cluster’s compatibility version for this particular virtual machine.

The compatibility version of a virtual machine is limited by the data center the virtual machine resides in, and is checked against capabilities of the host the virtual machine is planned to run on.

7.123.3. high_availability

The virtual machine high availability configuration. If set, the virtual machine will be automatically restarted when it unexpectedly goes down.

7.123.4. large_icon

Virtual machine’s large icon. Either set by user or refers to image set according to operating system.

7.123.5. lease

Reference to the storage domain this virtual machine/template lease reside on.

A virtual machine running with a lease requires checking while running that the lease is not taken by another host, preventing another instance of this virtual machine from running on another host. This provides protection against split-brain in highly available virtual machines. A template can also have a storage domain defined for a lease in order to have the virtual machines created from this template to be preconfigured with this storage domain as the location of the leases.

7.123.6. memory

The virtual machine’s memory, in bytes.

For example, to update a virtual machine to contain 1 Gibibyte (GiB) of memory, send the following request:

PUT /ovirt-engine/api/vms/123

With the following request body:

<vm>
  <memory>1073741824</memory>
</vm>
Note

Memory in the example is converted to bytes using the following formula:
1 GiB = 230 bytes = 1073741824 bytes.

Note

Memory hot plug is supported from Red Hat Virtualization 3.6 onwards. You can use the example above to increase memory while the virtual machine is running.

7.123.7. migration_downtime

Maximum time the virtual machine can be non responsive during its live migration to another host in ms.

Set either explicitly for the virtual machine or by engine-config -s DefaultMaximumMigrationDowntime=[value]

7.123.8. origin

The origin of this virtual machine.

Possible values:

  • ovirt
  • rhev
  • vmware
  • xen
  • external
  • hosted_engine
  • managed_hosted_engine
  • kvm
  • physical_machine
  • hyperv

7.123.9. small_icon

Virtual machine’s small icon. Either set by user or refers to image set according to operating system.

7.123.10. sso

Reference to the Single Sign On configuration this virtual machine is configured for. The user can be automatically signed in the virtual machine’s operating system when console is opened.

Table 7.166. Links summary

NameTypeSummary

cdroms

Cdrom[]

References to the CD-ROM devices attached to the template.

cluster

Cluster

Reference to cluster the virtual machine belongs to.

cpu_profile

CpuProfile

Reference to CPU profile used by this virtual machine.

disk_attachments

DiskAttachment[]

References to the disks attached to the template.

graphics_consoles

GraphicsConsole[]

References to the graphic consoles attached to the template.

nics

Nic[]

References to the network interfaces attached to the template.

permissions

Permission[]

References to the user permissions attached to the template.

quota

Quota

Reference to quota configuration set for this virtual machine.

storage_domain

StorageDomain

Reference to storage domain the virtual machine belongs to.

tags

Tag[]

References to the tags attached to the template.

watchdogs

Watchdog[]

References to the watchdog devices attached to the template.

7.124. Io struct

Table 7.167. Attributes summary

NameTypeSummary

threads

Integer

 

7.125. Ip struct

Represents the IP configuration of a network interface.

Table 7.168. Attributes summary

NameTypeSummary

address

String

The text representation of the IP address.

gateway

String

The address of the default gateway.

netmask

String

The network mask.

version

IpVersion

The version of the IP protocol.

7.125.1. address

The text representation of the IP address.

For example, an IPv4 address will be represented as follows:

<ip>
  <address>192.168.0.1</address>
  ...
</ip>

An IPv6 address will be represented as follows:

<ip>
  <address>2620:52:0:20f0:4216:7eff:feaa:1b50</address>
  ...
</ip>

7.125.2. netmask

The network mask.

For IPv6 addresses the value is an integer in the range of 0-128, which represents the subnet prefix.

7.125.3. version

The version of the IP protocol.

Note

From version 4.1 of the Manager this attribute will be optional, and when a value is not provided, it will be inferred from the value of the address attribute.

7.126. IpAddressAssignment struct

Represents an IP address assignment for a network device.

For a static boot protocol assignment, subnet mask and IP address (and optinally default gateway) must be provided in the IP configuration.

Table 7.169. Attributes summary

NameTypeSummary

assignment_method

BootProtocol

Sets the boot protocol used to assign the IP configuration for a network device.

ip

Ip

Sets the IP configuration for a network device.

7.127. IpVersion enum

Defines the values for the IP protocol version.

Table 7.170. Values summary

NameSummary

v4

IPv4.

v6

IPv6.

7.128. IscsiBond struct

Table 7.171. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

name

String

A human-readable name in plain text.

Table 7.172. Links summary

NameTypeSummary

data_center

DataCenter

 

networks

Network[]

 

storage_connections

StorageConnection[]

 

7.129. IscsiDetails struct

Table 7.173. Attributes summary

NameTypeSummary

address

String

 

disk_id

String

 

initiator

String

 

lun_mapping

Integer

 

password

String

 

paths

Integer

 

port

Integer

 

portal

String

 

product_id

String

 

serial

String

 

size

Integer

 

status

String

 

storage_domain_id

String

 

target

String

 

username

String

 

vendor_id

String

 

volume_group_id

String

 

7.130. Job struct

Represents a job, which monitors execution of a flow in the system. A job can contain multiple steps in a hierarchic structure. The steps can be processed in parallel, depends on the implementation of the flow.

Table 7.174. Attributes summary

NameTypeSummary

auto_cleared

Boolean

Indicates if the job should be cleared automatically after it was completed by the system.

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

end_time

Date

The end time of the job.

external

Boolean

Indicates if the job is originated by an external system.

id

String

A unique identifier.

last_updated

Date

The last update date of the job.

name

String

A human-readable name in plain text.

start_time

Date

The start time of the job.

status

JobStatus

The status of the job.

7.130.1. external

Indicates if the job is originated by an external system. External jobs are managed externally, by the creator of the job.

Table 7.175. Links summary

NameTypeSummary

owner

User

The user who is the owner of the job.

steps

Step[]

The steps of the job.

7.131. JobStatus enum

Represents the status of the job.

Table 7.176. Values summary

NameSummary

aborted

The aborted job status.

failed

The failed job status.

finished

The finished job status.

started

The started job status.

unknown

The unknown job status.

7.131.1. aborted

The aborted job status. This status is applicable for an external job that was forcibly aborted.

7.131.2. finished

The finished job status. This status describes a completed job execution.

7.131.3. started

The started job status. This status represents a job which is currently being executed.

7.131.4. unknown

The unknown job status. This status represents jobs which their resolution is not known, i.e. jobs that were executed before the system was unexpectedly restarted.

7.132. KatelloErratum struct

Type representing a Katello erratum.

Table 7.177. Attributes summary

NameTypeSummary

comment

String

Free text containing comments about this object.

description

String

A human-readable description in plain text.

id

String

A unique identifier.

issued

Date

The date when the Katello erratum was issued.

name

String

A human-readable name in plain text.

packages

Package[]