Red Hat SummitVersion 3 REST API Guide
Red Hat Virtualization 4.1
Using the Red Hat Virtualization Version 3 REST Application Programming Interface
Abstract
Version 4 of the Red Hat Virtualization Manager supports versions 3 and 4 of the Representational State Transfer API. The information and examples in this guide apply to version 3 of the REST API.
Chapter 1. Introduction
Copy linkLink copied to clipboard!
Red Hat Virtualization Manager provides a Representational State Transfer (REST) API. The API provides software developers and system administrators with control over their Red Hat Virtualization environment outside of the standard web interface. The REST API is useful for developers and administrators who aim to integrate the functionality of a Red Hat Virtualization environment with custom scripts or external applications that access the API via the standard Hypertext Transfer Protocol (HTTP).
The benefits of the REST API are:
- Broad client support - Any programming language, framework, or system with support for HTTP protocol can use the API;
- Self descriptive - Client applications require minimal knowledge of the virtualization infrastructure as many details are discovered at runtime;
- Resource-based model - The resource-based REST model provides a natural way to manage a virtualization platform.
This provides developers and administrators with the ability to:
- Integrate with enterprise IT systems.
- Integrate with third-party virtualization software.
- Perform automated maintenance or error checking tasks.
- Automate repetitive tasks in a Red Hat Virtualization environment with scripts.
This documentation acts as a reference to the Red Hat Virtualization Manager REST API. It aims to provide developers and administrators with instructions and examples to help harness the functionality of their Red Hat Virtualization environment through the REST API either directly or using the provided Python libraries.
1.1. Representational State Transfer
Copy linkLink copied to clipboard!
Representational State Transfer (REST) is a design architecture that focuses on resources for a specific service and their representations. A resource representation is a key abstraction of information that corresponds to one specific managed element on a server. A client sends a request to a server element located at a Uniform Resource Identifier (URI) and performs operations with standard HTTP methods, such as
GET, POST, PUT, and DELETE. This provides a stateless communication between the client and server where each request acts independent of any other request and contains all necessary information to complete the request.
1.2. Red Hat Virtualization REST API Prerequisites
Copy linkLink copied to clipboard!
Red Hat Virtualization REST API Prerequisites
- A networked installation of Red Hat Virtualization Manager, which includes the REST API.
- A client or programming library that initiates and receives HTTP requests from the REST API. For example:
- Python software development kit (SDK)
- Java software development kit (SDK)
- cURL command line tool
- RESTClient, a debugger for RESTful web services
- Knowledge of Hypertext Transfer Protocol (HTTP), which is the protocol used for REST API interactions. The Internet Engineering Task Force provides a Request for Comments (RFC) explaining the Hypertext Transfer Protocol at http://www.ietf.org/rfc/rfc2616.txt.
- Knowledge of Extensible Markup Language (XML) or JavaScript Object Notation (JSON), which the API uses to construct resource representations. The W3C provides a full specification on XML at http://www.w3.org/TR/xml/. ECMA International provide a free publication on JSON at http://www.ecma-international.org.
Chapter 2. Authentication and Security
Copy linkLink copied to clipboard!
2.1. TLS/SSL Certification
Copy linkLink copied to clipboard!
The Red Hat Virtualization Manager API requires Hypertext Transfer Protocol Secure (HTTPS) [1] for secure interaction with client software, such as the Manager's SDK and CLI components. This involves a process of obtaining a certificate from the Red Hat Virtualization Manager and importing it into the certificate store of your client.
Important
Obtain your certificate from the Red Hat Virtualization Manager using a secure network connection.
Procedure 2.1. Obtaining a Certificate
You can obtain a certificate from the Red Hat Virtualization Manager and transfer it to the client machine using one of three methods:
- Method 1 - Use a command line tool to download the certificate from the Manager. Examples of command line tools include cURL and Wget, both of which are available on multiple platforms.
- If using cURL:
curl -o rhvm.cer http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA
$ curl -o rhvm.cer http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CACopy to Clipboard Copied! Toggle word wrap Toggle overflow - If using Wget:
wget -O rhvm.cer http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA
$ wget -O rhvm.cer http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CACopy to Clipboard Copied! Toggle word wrap Toggle overflow
- Method 2 - Use a web browser to navigate to the certificate located at:Depending on the chosen browser, the certificate either downloads or imports into the browser's keystore.
http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA
http://[manager-fqdn]/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CACopy to Clipboard Copied! Toggle word wrap Toggle overflow - If the browser downloads the certificate: save the file as
rhvm.cer.If the browser imports the certificate: export it from the browser's certification options and save it asrhvm.cer.
- Method 3 - Log in to the Manager, export the certificate from the truststore and copy it to your client machine.
- Log in to the Manager as the
rootuser. - Export the certificate from the truststore using the Java keytool management utility:
keytool -exportcert -keystore /etc/pki/ovirt-engine/.truststore -alias cacert -storepass mypass -file rhvm.cer
$ keytool -exportcert -keystore /etc/pki/ovirt-engine/.truststore -alias cacert -storepass mypass -file rhvm.cerCopy to Clipboard Copied! Toggle word wrap Toggle overflow This creates a certificate file calledrhvm.cer. - Copy the certificate to the client machine using the
scpcommand:scp rhvm.cer [username]@[client-machine]:[directory]
$ scp rhvm.cer [username]@[client-machine]:[directory]Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Each of these methods results in a certificate file named
rhvm.cer on your client machine. An API user imports this file into the certificate store of the client.
Procedure 2.2. Importing a Certificate to a Client
- Importing a certificate to a client relies on how the client itself stores and interprets certificates. This guide contains some examples on importing certificates. For clients not using Network Security Services (NSS) or Java KeyStore (JKS), see your client documentation for more information on importing a certificate.
2.2. HTTP Authentication
Copy linkLink copied to clipboard!
Any user with a Red Hat Virtualization account has access to the REST API. An API user submits a mandatory Red Hat Virtualization Manager user name and password with all requests to the API. Each request uses HTTP Basic Authentication [2] to encode these credentials. If a request does not include an appropriate
Authorization header, the API sends a 401 Authorization Required as a result:
Example 2.1. Access to the REST API without appropriate credentials
HEAD [base] HTTP/1.1 Host: [host] HTTP/1.1 401 Authorization Required
HEAD [base] HTTP/1.1
Host: [host]
HTTP/1.1 401 Authorization Required
Request are issued with an
Authorization header for the specified realm. An API user encodes an appropriate Red Hat Virtualization Manager domain and user in the supplied credentials with the username@domain:password convention.
The following table shows the process for encoding credentials in base64.
| Item | Value |
|---|---|
| username | rhevmadmin |
| domain | domain.example.com |
| password | 123456 |
| unencoded credentials | rhevmadmin@domain.example.com:123456 |
| base64 encoded credentials | cmhldm1hZG1pbkBibGFjay5xdW1yYW5ldC5jb206MTIzNDU2 |
An API user provides the base64 encoded credentials as shown:
Example 2.2. Access to the REST API with appropriate credentials
Important
Basic authentication involves potentially sensitive information, such as passwords, sent as plain text. REST API requires Hypertext Transfer Protocol Secure (HTTPS) for transport-level encryption of plain-text requests.
Important
Some base64 libraries break the result into multiple lines and terminate each line with a newline character. This breaks the header and causes a faulty request. The Authorization header requires the encoded credentials on a single line within the header.
2.3. Authentication Sessions
Copy linkLink copied to clipboard!
The API also provides the ability for authentication session support. An API user sends an initial request with authentication details, then sends all subsequent requests using a session cookie to authenticate. The following procedure demonstrates how to use an authenticated session.
Procedure 2.3. Requesting an authenticated session
- Send a request with the
AuthorizationandPrefer: persistent-authCopy to Clipboard Copied! Toggle word wrap Toggle overflow This returns a response with the following header:Set-Cookie: JSESSIONID=5dQja5ubr4yvI2MM2z+LZxrK; Path=/ovirt-engine/api; Secure
Set-Cookie: JSESSIONID=5dQja5ubr4yvI2MM2z+LZxrK; Path=/ovirt-engine/api; SecureCopy to Clipboard Copied! Toggle word wrap Toggle overflow Note theJSESSIONID=value. In this example the value isJSESSIONID=5dQja5ubr4yvI2MM2z+LZxrK. - Send all subsequent requests with the
Prefer: persistent-authandcookieheader with theJSESSIONID=value. TheAuthorizationis no longer needed when using an authenticated session.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - When the session is no longer required, perform a request to the sever without the
Prefer: persistent-authheader.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
[1]
HTTPS is described in RFC 2818 HTTP Over TLS.
[2]
Basic Authentication is described in RFC 2617 HTTP Authentication: Basic and Digest Access Authentication.
Chapter 3. REST API Quick Start Example
Copy linkLink copied to clipboard!
This chapter provides an example to demonstrate the REST API's ability to setup a basic Red Hat Virtualization environment and create a virtual machine.
In addition to the standard prerequisites, this example requires the following:
- A networked and configured Red Hat Virtualization Host;
- An ISO file containing a desired virtual machine operating system to install. This chapter uses Red Hat Enterprise Linux Server 6 for our installation ISO example; and
- Red Hat Virtualization's engine-iso-uploader tool to upload your chosen operating system ISO file.
This example uses cURL to demonstrate REST requests with a client application. Note that any application capable of HTTP requests can substitute for cURL.
Important
For simplicity, the HTTP request headers in this example omit the
Host: and Authorization: fields. However, these fields are mandatory and require data specific to your installation of Red Hat Virtualization Manager.
Important
All cURL examples include placeholders for authentication details (
USER:PASS) and certificate location (CERT). Ensure all requests performed with cURL fulfill certification and authentication requirements.
Note
Red Hat Virtualization Manager generates a globally unique identifier (GUID) for the
id attribute for each resource. Identifier codes in this example might appear different to the identifier codes in your Red Hat Virtualization environment.
3.1. Example: Access API Entry Point
Copy linkLink copied to clipboard!
The following request retrieves a representation of the main entry point for version 3 of the API.
Example 3.1. Access the API v3 entry point
Request (with header):
GET /ovirt-engine/api HTTP/1.1 Version: 3 Accept: application/xml
GET /ovirt-engine/api HTTP/1.1
Version: 3
Accept: application/xml
Request (without header):
GET /ovirt-engine/api/v3 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/v3 HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] https://[RHEVM Host]:443/ovirt-engine/api
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] https://[RHEVM Host]:443/ovirt-engine/api
Result:
Important
When neither the header nor the URL prefix are used, the server will automatically select a version. The default is version
4. You can change the default version using the ENGINE_API_DEFAULT_VERSION parameter:
echo "ENGINE_API_DEFAULT_VERSION=3" > \ /etc/ovirt-engine/engine.conf.d/99-set-default-version.conf systemctl restart ovirt-engine
# echo "ENGINE_API_DEFAULT_VERSION=3" > \
/etc/ovirt-engine/engine.conf.d/99-set-default-version.conf
# systemctl restart ovirt-engine
Changing this parameter affects all users of the Manager that don't specify the version explicitly.
The entry point provides a user with links to the collections in a virtualization environment. The
rel= attribute of each collection link provides a reference point for each link. The next step in this example examines the datacenter collection, which is available through the rel="datacenter" link.
The entry point also contains other data such as
product_info, special_objects and summary. This data is covered in chapters outside this example.
3.2. Example: List Data Center Collection
Copy linkLink copied to clipboard!
Red Hat Virtualization Manager creates a
Default data center on installation. This example uses the Default data center as the basis for our virtual environment.
The following request retrieves a representation of the data center collection:
Example 3.2. List data center collection
Request:
GET /ovirt-engine/api/datacenters HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/datacenters HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters
Result:
Note the
id code of your Default data center. This code identifies this data center in relation to other resources of your virtual environment.
The data center also contains a link to the
storagedomains sub-collection. The data center uses this sub-collection to attach storage domains from the storagedomains main collection, which this example covers later.
3.3. Example: List Host Cluster Collection
Copy linkLink copied to clipboard!
Red Hat Virtualization Manager creates a
Default host cluster on installation. This example uses the Default cluster to group resources in your Red Hat Virtualization environment.
The following request retrieves a representation of the cluster collection:
Example 3.3. List host clusters collection
Request:
GET /ovirt-engine/api/clusters HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/clusters HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/clusters
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/clusters
Result:
Note the
id code of your Default host cluster. This code identifies this host cluster in relation to other resources of your virtual environment.
The
Default cluster is associated with the Default data center through a relationship using the id and href attributes of the data_center element.
The
networks sub-collection contains a list of associated network resources for this cluster. The next section examines the networks collection in more detail.
3.4. Example: List Logical Networks Collection
Copy linkLink copied to clipboard!
Red Hat Virtualization Manager creates a default
ovirtmgmt network on installation. This network acts as the management network for Red Hat Virtualization Manager to access hosts.
This network is associated with our
Default cluster and is a member of the Default data center. This example uses the ovirtmgmt network to connect our virtual machines.
The following request retrieves a representation of the logical networks collection:
Example 3.4. List logical networks collection
Request:
GET /ovirt-engine/api/networks HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/networks HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/networks
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/networks
Result:
The
ovirtmgmt network is attached to the Default data center through a relationship using the data center's id code.
The
ovirtmgmt network is also attached to the Default cluster through a relationship in the cluster's network sub-collection.
3.5. Example: List Host Collection
Copy linkLink copied to clipboard!
This example uses a Red Hat Virtualization Host. Red Hat Virtualization Manager automatically registers any configured Red Hat Virtualization Host. This example retrieves a representation of the hosts collection and shows a Red Hat Virtualization Host named
hypervisor registered with the virtualization environment.
Example 3.5. List hosts collection
Request:
GET /ovirt-engine/api/hosts HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/hosts HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/hosts
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/hosts
Result:
Note the
id code of your Default host. This code identifies this host in relation to other resources of your virtual environment.
This host is a member of the
Default cluster and accessing the nics sub-collection shows this host has a connection to the ovirtmgmt network.
3.6. Example: List CPU Profiles
Copy linkLink copied to clipboard!
The following request retrieves a representation of the CPU profiles:
Example 3.6. List CPU profiles
Request:
GET /ovirt-engine/api/cpuprofiles HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/cpuprofiles HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHEVM Host]:443/ovirt-engine/api/cpuprofiles
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHEVM Host]:443/ovirt-engine/api/cpuprofiles
Result:
3.7. Example: Create NFS Data Storage
Copy linkLink copied to clipboard!
An NFS data storage domain is an exported NFS share attached to a data center and provides storage for virtualized guest images. Creation of a new storage domain requires a
POST request, with the storage domain representation included, sent to the URL of the storage domain collection.
You can enable the wipe after delete option by default on the storage domain. To configure this specify
<wipe_after_delete> in the POST request. This option can be edited after the domain is created, but doing so will not change the wipe after delete property of disks that already exist.
Example 3.7. Create an NFS data storage domain
Request:
cURL command:
The API creates a NFS data storage domain called
data1 with an export path of 192.168.0.10:/data1 and sets access to the storage domain through the hypervisor host. The API also returns the following representation of the newly created storage domain resource.
Result:
3.8. Example: Create NFS ISO Storage
Copy linkLink copied to clipboard!
An NFS ISO storage domain is a mounted NFS share attached to a data center and provides storage for DVD/CD-ROM ISO and virtual floppy disk (VFD) image files. Creation of a new storage domain requires a
POST request, with the storage domain representation included, sent to the URL of the storage domain collection.
You can enable the wipe after delete option by default on the storage domain. To configure this specify
<wipe_after_delete> in the POST request. This option can be edited after the domain is created, but doing so will not change the wipe after delete property of disks that already exist.
Example 3.8. Create an NFS ISO storage domain
Request:
cURL command:
The API creates a NFS iso storage domain called
iso1 with an export path of 192.168.0.10:/iso1 and gets access to the storage domain through the hypervisor host. The API also returns the following representation of the newly created storage domain resource.
Result:
3.9. Example: Attach Storage Domains to Data Center
Copy linkLink copied to clipboard!
The following example attaches the
data1 and iso1 storage domains to the Default data center.
Example 3.9. Attach data1 storage domain to the Default data center
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<storage_domain><name>data1</name></storage_domain>" \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988/storagedomains
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<storage_domain><name>data1</name></storage_domain>" \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988/storagedomains
Example 3.10. Attach iso1 storage domain to the Default data center
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<storage_domain><name>iso1</name></storage_domain>" \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988/storagedomains
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<storage_domain><name>iso1</name></storage_domain>" \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988/storagedomains
These
POST requests place our two new storage_domain resources in the storagedomains sub-collection of the Default data center. This means the storagedomains sub-collection contains attached storage domains of the data center.
3.10. Example: Activate Storage Domains
Copy linkLink copied to clipboard!
This example activates the
data1 and iso1 storage domains for the Red Hat Virtualization Manager's use.
Example 3.11. Activate data1 storage domain
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<action/>" \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters/d70d5e2d-b8ad-494a-a4d2-c7a5631073c4/storagedomains/9ca7cb40-9a2a-4513-acef-dc254af57aac/activate
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<action/>" \
https://[RHEVM Host]:443/ovirt-engine/api/datacenters/d70d5e2d-b8ad-494a-a4d2-c7a5631073c4/storagedomains/9ca7cb40-9a2a-4513-acef-dc254af57aac/activate
Example 3.12. Activate iso1 storage domain
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<action/>"
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<action/>"
https://[RHEVM Host]:443/ovirt-engine/api/datacenters/d70d5e2d-b8ad-494a-a4d2-c7a5631073c4/storagedomains/00f0d9ce-da15-4b9e-9e3e-3c898fa8b6da/activate
This activates both storage domains for use with the data center.
3.11. Example: Create Virtual Machine
Copy linkLink copied to clipboard!
The following example creates a virtual machine called
vm1 on the Default cluster using the virtualization environment's Blank template as a basis. The request also defines the virtual machine's memory as 512 MB and sets the boot device to a virtual hard disk.
Example 3.13. Create a virtual machine
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<vm><name>vm1</name><cluster><name>default</name></cluster><template><name>Blank</name></template><memory>536870912</memory><os><boot dev='hd'/></os><cpu_profile id='0000001a-001a-001a-001a-00000000035e'/></vm>" https://[RHEVM Host]:443/ovirt-engine/api/vms
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<vm><name>vm1</name><cluster><name>default</name></cluster><template><name>Blank</name></template><memory>536870912</memory><os><boot dev='hd'/></os><cpu_profile id='0000001a-001a-001a-001a-00000000035e'/></vm>" https://[RHEVM Host]:443/ovirt-engine/api/vms
Result:
3.12. Example: Create Virtual Machine NIC
Copy linkLink copied to clipboard!
The following example creates a virtual network interface to connect the example virtual machine to the
ovirtmgmt network.
Example 3.14. Create a virtual machine NIC
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<nic><name>nic1</name><network><name>ovirtmgmt</name></network></nic>" \
https://[RHEVM Host]:443/ovirt-engine/api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/nics
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<nic><name>nic1</name><network><name>ovirtmgmt</name></network></nic>" \
https://[RHEVM Host]:443/ovirt-engine/api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/nics
3.13. Example: Create Virtual Machine Storage Disk
Copy linkLink copied to clipboard!
The following example creates an 8 GB Copy-On-Write storage disk for the example virtual machine.
Example 3.15. Create a virtual machine storage disk
Request:
cURL command:
The
storage_domain element tells the API to store the disk on the data1 storage domain.
3.14. Example: Attach ISO Image to Virtual Machine
Copy linkLink copied to clipboard!
The boot media for our example virtual machine requires an CD-ROM or DVD ISO image for an operating system installation. This example uses a Red Hat Enterprise Server 6 ISO image for installation.
ISO images must be available in the
iso1 ISO domain for the virtual machines to use. Red Hat Virtualization Platform provides an uploader tool that ensures that the ISO images are uploaded into the correct directory path with the correct user permissions.
Once the ISO is uploaded, an API user requests the ISO storage domain's
files sub-collection to view the file resource:
Example 3.16. View the files sub-collection in an ISO storage domain
Request:
GET /ovirt-engine/api/storagedomains/00f0d9ce-da15-4b9e-9e3e-3c898fa8b6da/files HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/storagedomains/00f0d9ce-da15-4b9e-9e3e-3c898fa8b6da/files HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/storagedomains/00f0d9ce-da15-4b9e-9e3e-3c898fa8b6da/files
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/storagedomains/00f0d9ce-da15-4b9e-9e3e-3c898fa8b6da/files
The API returns the following representation of the files sub-collection:
An API user attaches the
rhel-server-6.0-x86_64-dvd.iso to our example virtual machine. Attaching an ISO image is equivalent to using the Change CD button in the Administration or User Portal.
Example 3.17. Attach an ISO image to the virtual machine
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<cdrom><file id='rhel-server-6.0-x86_64-dvd.iso'/></cdrom>" \
https://[RHEVM Host]:443/ovirt-engine/api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/cdroms
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<cdrom><file id='rhel-server-6.0-x86_64-dvd.iso'/></cdrom>" \
https://[RHEVM Host]:443/ovirt-engine/api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/cdroms
3.15. Example: Start Virtual Machine
Copy linkLink copied to clipboard!
The virtual environment is complete and the virtual machine contains all necessary components to function. This example starts the virtual machine using the
start action.
Example 3.18. Start the virtual machine
Request:
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<action><vm><os><boot dev='cdrom'/></os></vm></action>" \
https://[RHEVM Host]:443/ovirt-engine/api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/start
# curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" \
-u [USER:PASS] --cacert [CERT] \
-d "<action><vm><os><boot dev='cdrom'/></os></vm></action>" \
https://[RHEVM Host]:443/ovirt-engine/api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/start
The additional message entity sets the virtual machine's boot device to CD-ROM for this boot only. This enables the virtual machine to install Red Hat Enterprise Server 6 from the attached ISO image. The boot device reverts back to
disk for all future boots.
3.16. Example: Check System Events
Copy linkLink copied to clipboard!
The
start action for the vm1 creates several entries in the events collection. This example lists the events collection and identifies events specific to the API starting a virtual machine.
Example 3.19. List the events collection
Request:
GET /ovirt-engine/api/events HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/events HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/events
# curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
--cacert [CERT] \
https://[RHEVM Host]:443/ovirt-engine/api/events
Result:
The following events occur:
id="101"- The API authenticates with theadminuser's user name and password.id="102"- The API, acting as theadminuser, startsvm1on thehypervisorhost.id="103"- The API logs out of theadminuser account.
Chapter 4. Entry Point
Copy linkLink copied to clipboard!
A user begins interacting with the API through a
GET request on the entry point URI consisting of a host and base.
Example 4.1. Accessing the API Entry Point
If the host is
www.example.com and the base is /ovirt-engine/api, the entry point appears with the following request:
Note
For simplicity, all other examples omit the
Host: and Authorization: request headers and assume the base is the default /ovirt-engine/api path. This base path differs depending on your implementation.
4.1. Product Information
Copy linkLink copied to clipboard!
The entry point contains a
product_info element to help an API user determine the legitimacy of the Red Hat Virtualization environment. This includes the name of the product, the vendor and the version.
Example 4.2. Verify a genuine Red Hat Virtualization environment
The follow elements identify a genuine Red Hat Virtualization 4.0 environment:
4.2. Link Elements
Copy linkLink copied to clipboard!
Access to the Entry Point provides
link elements and URIs for all of the resource collections the API exposes. Each collection uses a relation type to identify the URI a client needs.
| Relationship | Description |
|---|---|
capabilities | Supported capabilities of the Red Hat Virtualization Manager. |
datacenters | Data centers. |
clusters | Host clusters. |
networks | Virtual networks. |
storagedomains | Storage domains. |
hosts | Hosts. |
vms | Virtual machines. |
disks | Virtual disks. |
templates | Templates. |
vmpools | Virtual machine pools. |
domains | Identity service domains. |
groups | Imported identity service groups. |
roles | Roles. |
users | Users. |
tags | Tags. |
events | Events. |
Figure 4.1. The relationship between the API entry point and the resource collections exposed by the API
Note
All URIs shown in example responses are illustrative. The format of all URIs returned by the server is opaque. Clients navigate to specific resources through the entry point URI and use the relationship types to access the URIs.
The server chooses to include absolute URIs or absolute paths [3] in the
link element's href attribute, so clients are required to handle either form.
The
link elements also contain a set of search URIs for certain collections. These URIs use URI templates [4] to integrate search queries. The purpose of the URI template is to accept a search expression using the natural HTTP pattern of a query parameter. The client does not require prior knowledge of the URI structure. Thus clients should treat these templates as being opaque and access them with a URI template library.
Each search query URI template is identified with a relation type using the convention
"collection/search".
| Relationship | Description |
|---|---|
datacenters/search | Query data centers. |
clusters/search | Query host clusters. |
storagedomains/search | Query storage domains. |
hosts/search | Query hosts. |
vms/search | Query virtual machines. |
disks/search | Query disks. |
templates/search | Query templates. |
vmpools/search | Query virtual machine pools. |
events/search | Query events. |
users/search | Query users. |
4.3. Special Object Elements
Copy linkLink copied to clipboard!
Special object elements define relationships to special fixed resources within the virtualization environment.
| Relationship | Description |
|---|---|
templates/blank | The default blank virtual machine template for your virtualization environment. This template exists in every cluster as opposed to a standard template, which only exists in a single cluster. |
tags/root | The root tag that acts as a base for tag hierarchy in your virtualization environment. |
4.4. Summary Element
Copy linkLink copied to clipboard!
The summary element shows a high level summary of the system's statistics.
| Element | Description |
|---|---|
vms | Total number of vms and total number of active vms. |
hosts | Total number of hosts and total number of active hosts. |
users | Total number of users and total number of active users. |
storage_domains | Total number of storage domains and total number of active storage domains. |
4.5. RESTful Service Description Language (RSDL)
Copy linkLink copied to clipboard!
RESTful Service Description Language (RSDL) provides a description of the structure and elements in the REST API in one whole XML specification. Invoke the RSDL using the following request.
GET /ovirt-engine/api?rsdl HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api?rsdl HTTP/1.1
Accept: application/xml
This produces an XML document in the following format:
| Element | Description |
|---|---|
description | A plain text description of the RSDL document. |
version | The API version, including major release, minor release, build and revision. |
schema | A link to the XML schema (XSD) file. |
links | Defines each link in the API. |
Each
link element contains the following a structure:
| Element | Description |
|---|---|
link | A URI for API requests. Includes a URI attribute (href) and a relationship type attribute (rel). |
request | Defines the request properties required for the link. |
http_method | The method type to access this link. Includes the standard HTTP methods for REST API access: GET, POST, PUT and DELETE. |
headers | Defines the headers for the HTTP request. Contains a series of header elements, which each contain a header name and value to define the header. |
body | Defines the body for the HTTP request. Contains a resource type and a parameter_set, which contains a sets of parameter elements with attributes to define whether they are required for a request and the data type. The parameter element also includes a name element to define the Red Hat Virtualization Manager property to modify and also a further parameter_set subset if type is set to collection. |
response | Defines the output for the HTTP request. Contains a type element to define the resource structure to output. |
Use the RSDL in your applications as a method to map all links and parameter requirements for controlling a Red Hat Virtualization environment.
4.6. Red Hat Virtualization Windows Guest VSS Support
Copy linkLink copied to clipboard!
The Red Hat Virtualization Backup and Restore API provides integration with Microsoft Windows Volume Shadow Copy Service (VSS) using qemu-ga. The VSS provider registration is made in the guest level as part of the Guest Tools deployment.
qemu-ga provides VSS support and live snapshots attempt to quiesce whenever possible.
4.7. QEMU Guest Agent Overview
Copy linkLink copied to clipboard!
In Red Hat Enterprise Linux 6.4, the QEMU Guest Agent (QEMU GA) provided protection against the corruption of Linux guest virtual machines. Before issuing a snapshot request or creating a backup copy of the disk, the management stack (libvirt) sent a
guest-fsfreeze-freeze QMP command to the QEMU GA via the virtio-serial port. This command caused the guest agent to freeze all of the guest virtual machine's filesystems, via the FIFREEZE ioctl() kernel function. This ioctl() function is implemented by the Linux kernel in the guest virtual machine. The function flushes the filesystem cache in the guest virtual machine's kernel, brings the filesystem into a consistent state, and denies all userspace threads write access to the filesystem.
Only after the QEMU GA reported success, libvirt would proceed with the snapshot. At its completion, libvirt sends the
guest-fsfreeze-thaw QMP command to the QEMU GA over the virtio-serial port. This command tells the QEMU GA to issue a FITHAW ioctl(), which unblocks the userspace threads that were previously denied write access, and resumes normal processing. This process did not ensure that application-level data was in a consistent state when the virtual disk snapshot was taken. This was evident in cases where the fsck utility found no problems on filesystems restored from snapshots, and yet applications were not able to resume processing from the point where the snapshot was taken and userspace processes may not have written their internal buffers to files on the disk.
Red Hat Enterprise Linux 6.5 ensures that both file and application-level synchronization (flushing) are done. Guest system administrators can write and install application-specific freezing and thawing hook scripts. Before freezing the filesystems, the QEMU GA invokes the main hook script (included in the QEMU GA package). The main hook script in turn calls individual application-specific scripts, prepared by the guest system administrators, that temporarily deactivate all guest virtual machine applications. All of these actions occur when the mode is changed to "freeze".
Just before filesystems are frozen, the guest system administrator's scripts cause the databases and other file system applications to flush their working buffers to the virtual disk and to stop accepting further client connections. The applications then bring their data files into a consistent state where resumption of processing, with the reactivated (or a freshly started) instance of the application (after restoring the virtual disk from backup) is possible. When all scripts are done making their respective applications inactive, and the main hook script returns, QEMU GA proceeds to freeze filesystems, and the management stack takes the snapshot. Once all this is done, and it is confirmed that the snapshot is taken, the file system will resume to serve write requests. This process is called thawing.
Thawing is freezing in reverse order. Instructed by libvirt, QEMU GA thaws the guest virtual machine's filesystems. It then invokes individual hook scripts (via the main hook script) to resume or restart applications that had been inactivated during the freeze process.
4.8. VSS Transaction Flow
Copy linkLink copied to clipboard!
In processing a backup, the requester and the writers coordinate to do several things: to provide a stable system image from which to back up data (the shadow copied volume), to group files together on the basis of their usage, and to store information on the saved data. This must all be done with minimal interruption of the writer's normal work flow.
A requester (in our case the Backup Vendor) queries writers for their metadata, processes this data, notifies the writers prior to the beginning of the shadow copy and of the backup operations, and then notifies the writers again after the shadow copy and backup operations end.
Here is how the QEMU VSS provider is registered in Windows OS after the Guest Tools installation:
[3]
The RFC describing Uniform Resource Locator Generic Syntax provides a Collected ABNF for URI that explains the difference between these forms.
[4]
The Internet-Draft describing the format of a URI Template is available at http://tools.ietf.org/html/draft-gregorio-uritemplate-03.
Chapter 5. Compatibility Level Versions
Copy linkLink copied to clipboard!
Each host connected to Red Hat Virtualization Manager contains a version of VDSM. VDSM is the agent within the virtualization infrastructure that runs on a hypervisor or host and provides local management for virtual machines, networks and storage. Red Hat Virtualization Manager controls hypervisors and hosts using current or earlier versions of VDSM.
The Manager migrates virtual machines from host to host within a cluster. This means the Manager excludes certain features from a current version of VDSM until all hosts within a cluster have the same VDSM version, or more recent, installed.
The API represents this concept as a
compatibility level for each host, corresponding to the version of VDSM installed. A version element contains major and minor attributes, which describe the compatibility level.
When an administrator upgrades all hosts within a cluster to a certain level, the
version level appears under a supported_versions element. This indicates the cluster's version is now updatable to that level. Once the administrator updates all clusters within a data center to a given level, the data center is updatable to that level.
5.1. Upgrading Compatibility Levels
Copy linkLink copied to clipboard!
Example 5.1. Upgrading compatibility levels
The API reports the following compatibility levels for Red Hat Enterprise Virtualization Manager 3.4 instance:
All hosts within a cluster are updated to VDSM
3.5 and the API reports:
The cluster is now updatable to
3.5. When the cluster is updated, the API reports:
The API user updates the data center to
3.5. Once upgraded, the API exposes features available in Red Hat Enterprise Virtualization 3.5 for this data center.
Chapter 6. Capabilities
Copy linkLink copied to clipboard!
The
capabilities collection provides information about the capabilities that versions of Red Hat Virtualization support. These capabilities include active features and available enumerated values for specific properties.
To retrieve a full list of the capabilities for all versions of Red Hat Enterprise Virtualization from 3.2 to the latest version, submit the following request:
GET /ovirt-engine/api/capabilities/ HTTP/1.1 Content-Type: application/xml Accept: application/xml
GET /ovirt-engine/api/capabilities/ HTTP/1.1
Content-Type: application/xml
Accept: application/xml6.1. Version-Dependent Capabilities
Copy linkLink copied to clipboard!
The
capabilities element contains any number of version elements that describe capabilities dependent on a compatibility level.
The
version element includes attributes for major and minor version numbers. This indicates the current version level.
The following representation shows capabilities specific to Red Hat Enterprise Virtualization Manager
3.5, 3.6, and 4.0 respectively:
Each
version contains a series of capabilities dependent on the version specified.
6.2. Current Version
Copy linkLink copied to clipboard!
The
current element signifies if the version specified is the most recent supported compatibility level. The value is a Boolean true or false.
6.3. Features
Copy linkLink copied to clipboard!
Each version contains a list of compatible features. The following table lists the features compatible with Red Hat Virtualization 4.0.
| Feature | Description |
|---|---|
| Transparent huge pages memory policy | Allows you to define the availability of transparent huge pages for hosts. Acceptable values are true or false. |
| Gluster support | This features provides support for using Gluster Volumes and Bricks as storage. |
| POSIX-FS storage type | This feature provides support for the POSIX-FS storage type. |
| Port mirroring | Allows you to define the availability of port mirroring for virtual network interface cards. Acceptable values are true or false. |
| Display server time | Displays the current date and time in the API. |
| Display host memory | Displays the total memory for a specific host. |
| Display host sockets | Allows you to define the topology of a host CPU. Takes three attributes - sockets, threads and cores - which define the number of host sockets displayed, the number of threads and the number of cores per socket. |
| Search case sensitivity | Allows you to specify whether a search query is case sensitive by providing the case-sensitive=true|false URL parameter. |
Maximum results for GET requests | Allows you to specify the maximum number of results returned from a GET request. |
| JSON content type | Allows you to define a header that makes it possible to set a correlation ID for POST and PUT requests. |
| Activate and deactivate disks | Allows you to activate or deactivate a disk by specifying activate or deactivate as an action on a specific virtual disk. |
| Activate and deactivate network interface cards | Allows you to activate or deactivate a network interface card by specifying activate or deactivate as an action on a specific network interface card. |
| Snapshot refactoring | Allows you to refactor snapshots for virtual machines. |
| Remove template disks from specified storage domain | Allows you to remove virtual machine template disks from a specific storage domain using a DELETE request. |
| Floating disks | Floating disks are disks that are not attached to any virtual machine. With this feature, such disks also appear in the root collection rather than under specific virtual machines. |
| Asynchronous deletion | Allows you to specify that DELETE requests are to be performed asynchronously by specifying the async URL parameter. |
| Session-based authentication | Allows you to maintain a client-server session by providing an appropriate header, eliminating the need to log in with each request. |
| Virtual machine applications | Allows you to view a list of applications installed on a specific virtual machine. This list is located in the applications element of a specific virtual machine. |
| VirtIO-SCSI support | This feature provides support for para-virtualized SCSI controller devices. |
| Custom resource comments | Allows you to add custom comments to data centers and other resources. |
| Refresh host capabilities | Allows you to synchronize data on hosts and refresh the list of network interfaces available to a specific host. |
| Memory snapshot | Allows you to include the memory state as part of a virtual machine snapshot. |
| Watchdog device | Allows you to create watchdog devices for virtual machines. |
| SSH authentication method | Allows you to authenticate with hosts over SSH using an administrative user password or SSH public key. |
| Force select SPM | Allows you to force the selection of a host as SPM. |
| Console device | Allows you to control the attachment of console devices in virtual machines. |
| Storage server connections for storage domains | Allows you to view storage server connections to or from a specific storage domain. |
| Attach and detach storage server connections | Allows you to attach or detach storage server connections to or from a specific storage domain. |
| Single PCI for Qxl | Allows you to view multiple video devices via a single PCI guest device. |
| Add virtual machine from OVF configuration | Allows you to add a virtual machine from a provided OVF configuration. |
| Virtual network interface card profiles | Allows you to configure a profile that defines quality of service, custom properties and port mirroring for a specific virtual network interface card. |
| Image storage domains (tech preview) | Allows you to import images from and export images to an image storage domain such as an OpenStack image service (Glance). |
| Virtual machine fully qualified domain names | Allows you to retrieve the fully qualified domain name of a specific virtual machine. |
| Attaching disk snapshots to virtual machines | This feature provides support for attaching disk snapshots to virtual machines. |
| Cloud-Init | Allows you to initialize a virtual machine using Cloud Init. |
| Gluster brick management | Allows you to delete gluster bricks with data migration using the actions migrate and DELETE. The migrate action and stopmigrate action allow you to migrate data and reuse the brick. |
| Copy and move back-end disks | Allows you to copy and move disks in additional contexts. |
| Network labels | Allows you to provision networks on hosts using labels. |
| Reboot virtual machines | Allows you to reboot virtual machines via a single action. |
A full list of feature elements and their attributes is located at the top of the section for the relevant version:
Chapter 7. Common Features
Copy linkLink copied to clipboard!
7.1. Element Property Icons
Copy linkLink copied to clipboard!
Note
Throughout this guide, the elements of each resource are detailed in tables. These tables include a properties column, displaying icons depicting element properties. The meaning of these icons is shown in Table 7.1, “Element property icons”.
| Property | Description | Icon |
|---|---|---|
| Required for creation | These elements must be included in the client-provided representation of a resource on creation, but are not mandatory for an update of a resource. | 
|
| Non-updatable | These elements cannot have their value changed when updating a resource. Include these elements in a client-provided representation on update only if their values are not altered by the API user. If altered, the API reports an error. | 
|
| Read-only | These elements are read-only. Values for read-only elements are not created or modified. | 
|
7.2. Representations
Copy linkLink copied to clipboard!
7.2.1. Representations
Copy linkLink copied to clipboard!
The API structures resource representations in the following XML document structure:
7.2.2. Common Attributes to Resource Representations
Copy linkLink copied to clipboard!
All resource representations contain a set of common attributes
| Attribute | Type | Description | Properties |
|---|---|---|---|
id | GUID | Each resource in the virtualization infrastructure contains an id, which acts as a globally unique identifier (GUID). The GUID is the primary method of resource identification. | |
href | string | The canonical location of the resource as an absolute path. |
7.2.3. Common Elements to Resource Representations
Copy linkLink copied to clipboard!
All resource representations contain a set of common elements.
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | A user-supplied human readable name for the resource. The name is unique across all resources of its type. | |
description | string | A free-form user-supplied human readable description of the resource. |
7.3. Collections
Copy linkLink copied to clipboard!
7.3.1. Collections
Copy linkLink copied to clipboard!
A collection is a set of resources of the same type. The API provides both top-level collections and sub-collections. An example of a top-level collection is the
hosts collection which contains all virtualization hosts in the environment. An example of a sub-collection is the host.nics collection which contains resources for all network interface cards attached to a host resource.
7.3.2. Listing All Resources in a Collection
Copy linkLink copied to clipboard!
Obtain a listing of resources in a collection with a
GET request on the collection URI obtained from the entry point.
Include an
Accept HTTP header to define the MIME type for the response format.
GET /ovirt-engine/api/[collection] HTTP/1.1 Accept: [MIME type]
GET /ovirt-engine/api/[collection] HTTP/1.1
Accept: [MIME type]7.3.3. Listing Extended Resource Sub-Collections
Copy linkLink copied to clipboard!
The API extends collection representations to include sub-collections when the
Accept header includes the detail parameter.
GET /ovirt-engine/api/collection HTTP/1.1 Accept: application/xml; detail=subcollection
GET /ovirt-engine/api/collection HTTP/1.1
Accept: application/xml; detail=subcollection
This includes multiple sub-collection requests using either separated
detail parameters:
GET /ovirt-engine/api/collection HTTP/1.1 Accept: application/xml; detail=subcollection1; detail=subcollection2
GET /ovirt-engine/api/collection HTTP/1.1
Accept: application/xml; detail=subcollection1; detail=subcollection2
Or one
detail parameter that separates the sub-collection with the + operator:
GET /ovirt-engine/api/collection HTTP/1.1 Accept: application/xml; detail=subcollection1+subcollection2+subcollection3
GET /ovirt-engine/api/collection HTTP/1.1
Accept: application/xml; detail=subcollection1+subcollection2+subcollection3
The API supports extended sub-collections for the following main collections.
| Collection | Extended Sub-Collection Support |
|---|---|
hosts | statistics |
vms | statistics, nics, disks |
Example 7.1. A request for extended statistics, NICs and disks sub-collections in the vms collection
GET /ovirt-engine/api/vms HTTP/1.1 Accept: application/xml; detail=statistics+nics+disks
GET /ovirt-engine/api/vms HTTP/1.1
Accept: application/xml; detail=statistics+nics+disks
7.3.4. Searching Collections with Queries
Copy linkLink copied to clipboard!
A
GET request on a "collection/search" link results in a search query of that collection. The API only returns resources within the collection that satisfy the search query constraints.
7.3.5. Maximum Results Parameter
Copy linkLink copied to clipboard!
Use the
max URL parameter to limit the list of results. An API search query without specifying the max parameter will return all values. Specifying the max parameter is recommended to prevent API search queries from slowing UI performance.
7.3.6. Case Sensitivity
Copy linkLink copied to clipboard!
All search queries are case sensitive by default. The URL syntax provides a Boolean option to toggle case sensitivity.
Example 7.2. Case insensitive search query
GET /ovirt-engine/api/collection;case-sensitive=false?search={query} HTTP/1.1
Accept: application/xml
GET /ovirt-engine/api/collection;case-sensitive=false?search={query} HTTP/1.1
Accept: application/xml
7.3.7. Query Syntax
Copy linkLink copied to clipboard!
The API uses the URI templates to perform a search
query with a GET request:
GET /ovirt-engine/api/collection?search={query} HTTP/1.1
Accept: application/xml
GET /ovirt-engine/api/collection?search={query} HTTP/1.1
Accept: application/xml
The
query template value refers to the search query the API directs to the collection. This query uses the same format as Red Hat Virtualization Query Language:
(criteria) [sortby (element) asc|desc]
The
sortby clause is optional and only needed when ordering results.
| Collection | Criteria | Result |
|---|---|---|
hosts | vms.status=up | Displays a list of all hosts running virtual machines that are up. |
vms | domain=qa.company.com | Displays a list of all virtual machines running on the specified domain. |
vms | users.name=mary | Displays a list of all virtual machines belonging to users with the user name mary. |
events | severity>normal sortby time | Displays the list of all events with severity higher than normal and sorted by the time element values. |
events | severity>normal sortby time desc | Displays the list of all events with severity higher than normal and sorted by the time element values in descending order. |
The API requires the
query template to be URL-encoded to translate reserved characters, such as operators and spaces.
Example 7.3. URL-encoded search query
GET /ovirt-engine/api/vms?search=name%3Dvm1 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/vms?search=name%3Dvm1 HTTP/1.1
Accept: application/xml
7.3.8. Wildcards
Copy linkLink copied to clipboard!
Search queries substitute part of a value with an asterisk as a wildcard.
Example 7.4. Wildcard search query for name=vm*
GET /ovirt-engine/api/vms?search=name%3Dvm* HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/vms?search=name%3Dvm* HTTP/1.1
Accept: application/xml
This query would result in all virtual machines with names beginning with
vm, such as vm1, vm2, vma or vm-webserver.
Example 7.5. Wildcard search query for name=v*1
GET /ovirt-engine/api/vms?search=name%3Dv*1 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/vms?search=name%3Dv*1 HTTP/1.1
Accept: application/xml
This query would result in all virtual machines with names beginning with
v and ending with 1, such as vm1, vr1 or virtualmachine1.
7.3.9. Pagination
Copy linkLink copied to clipboard!
Some Red Hat Virtualization environments contain large collections of resources. However, the API only displays a default number of resources for one search query to a collection. To display more than the default, the API separates collections into pages via a search query containing the
page command.
Example 7.6. Paginating resources
This example paginates resources in a collection. The URL-encoded request is:
GET /ovirt-engine/api/collection?search=page%201 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/collection?search=page%201 HTTP/1.1
Accept: application/xml
Increase the
page value to view the next page of results:
GET /ovirt-engine/api/collection?search=page%202 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/collection?search=page%202 HTTP/1.1
Accept: application/xml
Use the
page command in conjunction with other commands in a search query. For example:
GET /ovirt-engine/api/collection?search=sortby%20element%20asc%20page%202 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/collection?search=sortby%20element%20asc%20page%202 HTTP/1.1
Accept: application/xml
This query displays the second page in a collection listing ordered by a chosen element.
Important
The REST APIs are stateless; it is not possible to retain a state between different requests since all requests are independent from each other. As a result, if a status change occurs between your requests, then the page results may be inconsistent.
For example, if you request a specific page from a list of VMs, and a status change occurs before you can request the next page, then your results may be missing entries or contain duplicated entries.
7.3.10. Creating a Resource in a Collection
Copy linkLink copied to clipboard!
Create a new resource with a
POST request to the collection URI containing a representation of the new resource.
A
POST request requires a Content-Type header. This informs the API of the representation MIME type in the body content as part of the request.
Include an
Accept HTTP header to define the MIME type for the response format.
Each resource type has its own specific required properties. The client supplies these properties when creating a new resource. Refer to the individual resource type documentation for more details.
If a required property is absent, the creation fails with a representation indicating the missing elements.
POST /ovirt-engine/api/[collection] HTTP/1.1 Accept: [MIME type] Content-Type: [MIME type] [body]
POST /ovirt-engine/api/[collection] HTTP/1.1
Accept: [MIME type]
Content-Type: [MIME type]
[body]7.3.11. Asynchronous Requests
Copy linkLink copied to clipboard!
The API performs asynchronous
POST requests unless the user overrides them with an Expect: 201-created header.
For example, certain resources, such as Virtual Machines, Disks, Snapshots and Templates, are created asynchronously. A request to create an asynchronous resource results in a
202 Accepted status. The initial document structure for a 202 Accepted resource also contains a creation_status element and link for creation status updates. For example:
A
GET request to the creation_status link provides a creation status update:
Overriding the asynchronous resource creation requires an
Expect: 201-created header:
7.4. Resources
Copy linkLink copied to clipboard!
7.4.1. Resources
Copy linkLink copied to clipboard!
Resources are data sources in a RESTful web service. Each resource type contains a set of common parameters that the REST API abstracts to form a resource representation, usually in XML or JSON. Users can view a resource representation, then edit the parameters and send the representation back to the resource's URL within the API, which modifies the resource. Users can also delete individual resources through REST.
A RESTful web service also groups resources into collections. Users can view a representation of all resources in a collection. Users also send resource representations to a specific collection to create a new resource within that particular collection.
7.4.2. Retrieving a Resource
Copy linkLink copied to clipboard!
Obtain the state of a resource with a
GET request on a URI obtained from a collection listing.
Include an
Accept HTTP header to define the MIME type for the response format.
GET /ovirt-engine/api/[collection]/[resource_id] HTTP/1.1 Accept: [MIME type]
GET /ovirt-engine/api/[collection]/[resource_id] HTTP/1.1
Accept: [MIME type]
You can obtain additional information from some resources using the
All-Content: true header. The RESTful Service Description Language describes which links support this header.
GET /ovirt-engine/api/[collection]/[resource_id] HTTP/1.1 Accept: [MIME type] All-Content: true
GET /ovirt-engine/api/[collection]/[resource_id] HTTP/1.1
Accept: [MIME type]
All-Content: true
7.4.3. Updating a Resource
Copy linkLink copied to clipboard!
Modify resource properties with a
PUT request containing an updated description from a previous GET request for the resource URI. Details on modifiable properties are found in the individual resource type documentation.
A
PUT request requires a Content-Type header. This informs the API of the representation MIME type in the body content as part of the request.
Include an
Accept HTTP header to define the MIME type for the response format.
PUT /ovirt-engine/api/collection/resource_id HTTP/1.1 Accept: [MIME type] Content-Type: [MIME type] [body]
PUT /ovirt-engine/api/collection/resource_id HTTP/1.1
Accept: [MIME type]
Content-Type: [MIME type]
[body]
This does not include immutable resource properties that an API user has attempted to modify. If an attempt is made to modify a strictly immutable resource property, the API reports a conflict with an error message representation in the response body.
Properties omitted from the representation are ignored and not changed.
7.4.4. Deleting a Resource
Copy linkLink copied to clipboard!
Delete a resource with a
DELETE request sent to its URI.
Include an
Accept HTTP header to define the MIME type for the response format.
DELETE /ovirt-engine/api/[collection]/[resource_id] HTTP/1.1 Accept: [MIME type]
DELETE /ovirt-engine/api/[collection]/[resource_id] HTTP/1.1
Accept: [MIME type]
Some cases require optional body content in the
DELETE request to specify additional properties. A DELETE request with optional body content requires a Content-Type header to inform the API of the representation MIME type in the body content. If a DELETE request contains no body content, omit the Content-Type header.
7.4.5. Sub-Collection Relationships
Copy linkLink copied to clipboard!
A sub-collection relationship defines a hierarchical link between a resource and a sub-collection. The sub-collection exists or has some meaning in the context of a parent resource. For example, a virtual machine contains network interfaces, which means the API maps the relationship between the virtual machine resource and the network interfaces sub-collection.
Sub-collections are used to model the following relationships types:
- Where one parent resource can contain several child resources and vice versa. For example, a virtual machine can contain several disks and some disks are shared among multiple virtual machines.
- Where mapped resources are dependent on a parent resource. Without the parent resource, the dependent resource cannot exist. For example, the link between a virtual machine and snapshots.
- Where mapped resources exist independently from parent resources but data is still associated with the relationship. For example, the link between a cluster and a network.
The API defines a relationship between a resource and a sub-collection using the
link rel= attribute:
The API user now queries the sub-collection.
7.4.6. XML Element Relationships
Copy linkLink copied to clipboard!
XML element links act as an alternative to sub-collections to express relationships between resources. XML element links are simply elements with a "href" attribute that points to the linked element.
XML element links are used to model simple 1:N mappings between resources without a dependency and without data associated with the relationship. For example, the relationship between a host and a cluster.
Examples of such relationships include:
- Backlinks from a resource in a sub-collection to a parent resource; or
- Links between resources with an arbitrary relationship.
Example 7.7. Backlinking from a sub-collection resource to a resource using an XML element
7.4.7. Actions
Copy linkLink copied to clipboard!
Most resources include a list of action links to provide functions not achieved through the standard HTTP methods.
The API invokes an action with a
POST request to the supplied URI. The body of the POST requires an action representation encapsulating common and task-specific parameters.
| Element | Description |
|---|---|
async | true if the server responds immediately with 202 Accepted and an action representation contains a href link to be polled for completion. |
grace_period | a grace period in milliseconds, which must expire before the action is initiated. |
Individual actions and their parameters are documented in the individual resource type's documentation. Some parameters are mandatory for specific actions and their absence is indicated with a
fault response.
An action also requires a
Content-Type: application/xml header since the POST request requires an XML representation in the body content.
When the action is initiated asynchronously, the immediate
202 Accepted response provides a link to monitor the status of the task:
A subsequent
GET on the action URI provides an indication of the status of the asynchronous task.
| Status | Description |
|---|---|
pending | Task has not yet started. |
in_progress | Task is in operation. |
complete | Task completed successfully. |
failed | Task failed. The returned action representation would contain a fault describing the failure. |
Once the task has completed, the action is retained for an indeterminate period. Once this has expired, subsequent
GETs are 301 Moved Permanently redirected back to the target resource.
An action representation also includes some links that are identified by the
rel attribute:
| Type | Description |
|---|---|
parent | A link back to the resource of this action. |
replay | A link back to the original action URI. POSTing to this URI causes the action to be re-initiated. |
7.4.8. Permissions
Copy linkLink copied to clipboard!
Each resource contains a
permissions sub-collection. Each permission contains a user, an assigned role and the specified resource. For example:
A resource acquires a new permission when an API user sends a
POST request with a permission representation and a Content-Type: application/xml header to the resource's permissions sub-collection. Each new permission requires a role and a user:
7.4.9. Handling Errors
Copy linkLink copied to clipboard!
Some errors require further explanation beyond a standard HTTP status code. For example, the API reports an unsuccessful resource state update or action with a
fault representation in the response entity body. The fault contains a reason and detail strings. Clients must accommodate failed requests via extracting the fault or the expected resource representation depending on the response status code. Such cases are clearly indicated in the individual resource documentation.
Chapter 8. The Backup and Restore API
Copy linkLink copied to clipboard!
The backup and restore API is a collection of functions that allows you to perform full or file-level backup and restoration of virtual machines. The API combines several components of Red Hat Virtualization, such as live snapshots and the REST API, to create and work with temporary volumes that can be attached to a virtual machine containing backup software provided by an independent software provider.
For supported third-party backup vendors, consult the Red Hat Virtualization Ecosystem at Red Hat Marketplace.
8.1. Backing Up a Virtual Machine
Copy linkLink copied to clipboard!
Use the backup and restore API to back up a virtual machine. This procedure assumes you have two virtual machines: the virtual machine to back up, and a virtual machine on which the software for managing the backup is installed.
Procedure 8.1. Backing Up a Virtual Machine
- Using the REST API, create a snapshot of the virtual machine to back up:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Note
When you take a snapshot of a virtual machine, a copy of the configuration data of the virtual machine as at the time the snapshot was taken is stored in thedataattribute of theconfigurationattribute ininitializationunder the snapshot.Important
You cannot take snapshots of disks that are marked as shareable or that are based on direct LUN disks. - Retrieve the configuration data of the virtual machine from the
dataattribute under the snapshot:GET /ovirt-engine/api/vms/11111111-1111-1111-1111-111111111111/snapshots/11111111-1111-1111-1111-111111111111 HTTP/1.1 Accept: application/xml Content-type: application/xml
GET /ovirt-engine/api/vms/11111111-1111-1111-1111-111111111111/snapshots/11111111-1111-1111-1111-111111111111 HTTP/1.1 Accept: application/xml Content-type: application/xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Identify the disk ID and snapshot ID of the snapshot:
GET /ovirt-engine/api/vms/11111111-1111-1111-1111-111111111111/snapshots/11111111-1111-1111-1111-111111111111/disks HTTP/1.1 Accept: application/xml Content-type: application/xml
GET /ovirt-engine/api/vms/11111111-1111-1111-1111-111111111111/snapshots/11111111-1111-1111-1111-111111111111/disks HTTP/1.1 Accept: application/xml Content-type: application/xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Attach the snapshot to the backup virtual machine and activate the disk:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Use the backup software on the backup virtual machine to back up the data on the snapshot disk.
- Detach the snapshot disk from the backup virtual machine:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Optionally, delete the snapshot:
DELETE /ovirt-engine/api/vms/11111111-1111-1111-1111-111111111111/snapshots/11111111-1111-1111-1111-111111111111 HTTP/1.1 Accept: application/xml Content-type: application/xml
DELETE /ovirt-engine/api/vms/11111111-1111-1111-1111-111111111111/snapshots/11111111-1111-1111-1111-111111111111 HTTP/1.1 Accept: application/xml Content-type: application/xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
You have backed up the state of a virtual machine at a fixed point in time using backup software installed on a separate virtual machine.
8.2. Restoring a Virtual Machine
Copy linkLink copied to clipboard!
Restore a virtual machine that has been backed up using the backup and restore API. This procedure assumes you have a backup virtual machine on which the software used to manage the previous backup is installed.
Procedure 8.2. Restoring a Virtual Machine
- Attach the disk to the backup virtual machine:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Use the backup software to restore the backup to the disk.
- Detach the disk from the backup virtual machine:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Create a new virtual machine using the configuration data of the virtual machine being restored:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Attach the disk to the new virtual machine:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
You have restored a virtual machine using a backup that was created using the backup and restore API.
Chapter 9. Data Centers
Copy linkLink copied to clipboard!
9.1. Data Center Elements
Copy linkLink copied to clipboard!
The
datacenters collection provides information about the data centers in a Red Hat Virtualization environment. An API user accesses this information through the rel="datacenters" link obtained from the entry point URI.
The following table shows specific elements contained in a data center resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | A plain text, human-readable name for the data center. The name is unique across all data center resources. |
|
description | string | A plain text, human-readable description of the data center | |
link rel="storagedomains" | relationship | A link to the sub-collection for storage domains attached to this data center. | |
link rel="clusters" | relationship | A link to the sub-collection for clusters attached to this data center. | |
link rel="networks" | relationship | A link to the sub-collection for networks available to this data center. | |
link rel="permissions" | relationship | A link to the sub-collection for data center permissions. | |
link rel="quotas" | relationship | A link to the sub-collection for quotas associated with this data center. | |
local | Boolean: true or false | Specifies whether the data center is a local data center, such as created in all-in-one instances. |
|
storage_format | enumerated | Describes the storage format version for the data center. A list of enumerated values are available in capabilities. | |
version major= minor= | complex | The compatibility level of the data center. | |
supported_versions | complex | A list of possible version levels for the data center, including version major= minor=. |
|
mac_pool | string | The MAC address pool associated with the data center. If no MAC address pool is specified the default MAC address pool is used. | |
status | see below | The data center status. |
|
The
status contains one of the following enumerated values: uninitialized, up, maintenance, not_operational, problematic and contend. These states are listed in data_center_states under capabilities.
9.2. XML Representation of a Data Center
Copy linkLink copied to clipboard!
Example 9.1. An XML representation of a data center
9.3. JSON Representation of a Data Center
Copy linkLink copied to clipboard!
Example 9.2. A JSON representation of a data center
9.4. Methods
Copy linkLink copied to clipboard!
9.4.1. Creating a New Data Center
Copy linkLink copied to clipboard!
Creation of a new data center requires the
name and local elements.
Example 9.3. Creating a data center
9.4.2. Updating a Data Center
Copy linkLink copied to clipboard!
The
name, description, storage_type, version, storage_format and mac_pool elements are updatable post-creation.
Example 9.4. Updating a data center
9.4.3. Removing a Data Center
Copy linkLink copied to clipboard!
Removal of a data center requires a
DELETE request.
Example 9.5. Removing a data center
DELETE /ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content
9.5. Sub-Collections
Copy linkLink copied to clipboard!
9.5.1. Storage Domains Sub-Collection
Copy linkLink copied to clipboard!
9.5.1.1. Storage Domains Sub-Collection
Copy linkLink copied to clipboard!
Each data center contains a sub-collection for attached storages domain. An API user interacts with this sub-collection using the standard REST methods.
An attached storage domain has a similar representation to a top-level storage domain, with the exception that it has a data center specific
status and set of actions. States for the status element are listed in storage_domain_states under capabilities.
Important
The API as documented in this section is experimental and subject to change. It is not covered by the backwards compatibility statement.
9.5.1.2. Attaching and Detaching a Storage Domain
Copy linkLink copied to clipboard!
A data center is only ready for use when at least one storage domain is attached, which an API user
POSTs to the data center's storage domains sub-collection.
When attaching a storage domain, its
id or name must be supplied. An example of attaching a storage domain to a data center:
Example 9.6. Attach a storage domain to a data center
Detach a storage domain from a data center with a
DELETE request. Include an optional async element for this request to be asynchronous.
Example 9.7. Detach a storage domain from a data center
9.5.1.3. Actions
Copy linkLink copied to clipboard!
9.5.1.3.1. Activate Storage Domain Action
Copy linkLink copied to clipboard!
An attached storage domain requires activation on a data center before use. The activate action does not take any action specific parameters.
Example 9.8. Action to active a storage domain on a datacenter
9.5.1.3.2. Deactivate Storage Domain Action
Copy linkLink copied to clipboard!
An attached storage domain is deactivated on a data center before removal. The deactivate action does not take any action specific parameters.
Example 9.9. Action to deactivate a storage domain on a datacenter
9.5.2. Network Sub-Collection
Copy linkLink copied to clipboard!
9.5.2.1. Networks Sub-Collection
Copy linkLink copied to clipboard!
Networks associated with a data center are represented with the
networks sub-collection. The representation of a data center's network sub-collection contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | A plain text, human readable name for the network. |
description | string | A plain text, human readable description of the network. |
rel="permissions" | relationship | A link to the permissions sub-collection for the network. |
rel="vnicprofiles" | relationship | A link to the vnicprofiles sub-collection for the network. |
rel="labels" | relationship | A link to the labels sub-collection for the network. |
data_center id= | relationship | A reference to the data center of which the network is a member. |
stp | Boolean: true or false | Specifies whether spanning tree protocol is enabled for the network. |
mtu | integer | Specifies the maximum transmission unit for the network. |
usages | complex | Defines a set of usage elements for the network. Users can define networks as vm and display networks at this level. |
In the REST API, you can manipulate the
networks sub-collection with the standard REST methods. For example, the POST method can be used to update a network id or name
Example 9.10. Associating a network resource with a data center
Update the resource with a
PUT request. The maximum transmission unit of a network is set using a PUT request to specify the integer value of the mtu element.
Example 9.11. Setting the network maximum transmission unit
An association is removed with a
DELETE request to the appropriate element in the collection.
Example 9.12. Removing a network association from a data center
DELETE /ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000/networks/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000/networks/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content9.5.3. Quotas Sub-Collection
Copy linkLink copied to clipboard!
9.5.3.1. Quotas Sub-Collection
Copy linkLink copied to clipboard!
The quotas sub-collection lists restrictions that Red Hat Virtualization Manager implements on resources. An API user views this sub-collection and its resources using the
GET method.
Example 9.13. An XML representation of a quota
Creation of a new quota requires the
name and description elements.
Example 9.14. Creating a quota
Removal of a quota requires a
DELETE request.
Example 9.15. Removing a quota
DELETE /ovirt-engine/api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988/quotas/e13ff85a-b2ba-4f7b-8010-e0d057c03dfe HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988/quotas/e13ff85a-b2ba-4f7b-8010-e0d057c03dfe HTTP/1.1
HTTP/1.1 204 No Content
9.6. Actions
Copy linkLink copied to clipboard!
9.6.1. Force Remove Data Center Action
Copy linkLink copied to clipboard!
An API user forces the removal of a data center when encountering unresolvable problems with storage domains, such as the loss of connection to a master storage domain or a lack of available hosts when deleting storage domains. The API includes a
force action to help with these situations.
This action removes database entries associated with a chosen data center before the API removes the data center from the Red Hat Virtualization environment. This means the API removes the data center regardless of associated storage domains.
This action requires a
DELETE method. The request body contains an action representation with the force parameter set to true. The request also requires an additional Content-type: application/xml header to process the XML representation in the body.
Example 9.16. Force remove action on a data center
This action:
- Deletes all database information for
datastorage domains associated the data center; - Deletes all database information for resources, such as virtual machines and templates, on
datastorage domains associated the data center; - Detaches
isoandexportstorage domains from the data center; and - Deletes the database information for the data center.
This action overrides the requirement for a data center to be empty before deletion.
Important
This action only removes the database entries for resources associated with the data center. The
data storage domains associated with the data center require manual format before reuse. Metadata for iso and export domains require manual cleaning prior to use on another data center.
Chapter 10. Clusters
Copy linkLink copied to clipboard!
10.1. Cluster Elements
Copy linkLink copied to clipboard!
The
clusters collection provides information about clusters in a Red Hat Virtualization environment. An API user accesses this information through the rel="clusters" link obtained from the entry point URI.
The following table shows specific elements contained in a cluster resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | A user-supplied, human-readable name for the cluster. The name is unique across all cluster resources. |
|
description | string | A free-form, user-supplied, human-readable description of the cluster. | |
link rel="networks" | relationship | A link to the sub-collection for networks associated with this cluster. | |
link rel="permissions" | relationship | A link to the sub-collection for cluster permissions. | |
link rel="glustervolumes" | relationship | A link to the sub-collection for Red Hat Gluster Storage volumes associated with this cluster. | |
link rel="glusterhooks" | relationship | A link to the sub-collection for Red Hat Gluster Storage volume hooks associated with this cluster. | |
link rel="affinitygroups" | relationship | A link to the sub-collection for virtual machine affinity groups associated with this cluster. | |
cpu id= | complex | A server CPU reference that defines the CPU type all hosts must support in the cluster. |
|
data_center id= | GUID | A reference to the data center membership of this cluster. |
|
memory_policy | complex | Defines the cluster's policy on host memory utilization. |
|
scheduling_policy | complex | Defines the load-balancing or power-saving modes for hosts in the cluster. |
|
version major= minor= | complex | The compatibility level of the cluster. |
|
supported_versions | complex | A list of possible version levels for the cluster. |
|
error_handling | complex/enumerated | Defines virtual machine handling when a host within a cluster becomes non-operational. Requires a single on_error element containing an enumerated type property listed in capabilities. | |
virt_service | Boolean | Defines whether to expose virtualization services for this cluster. | |
gluster_service | Boolean | Defines whether to expose Red Hat Gluster Storage services for this cluster. | |
threads_as_cores | Boolean | Defines whether hosts can run virtual machines with a total number of processor cores greater than the number of cores in the host. | |
tunnel_migration | Boolean | Defines whether virtual machines use a libvirt-to-libvirt tunnel during migration. | |
trusted_service | Boolean | Defines whether an OpenAttestation server is used to verify hosts. | |
ballooning_enabled | Boolean | Defines whether ballooning is enabled for the cluster. | |
ksm | Boolean | Defines whether ksm is enabled for the cluster. |
Note
When a host's free memory drops below 20%, ballooning commands like
mom.Controllers.Balloon - INFO Ballooning guest:half1 from 1096400 to 1991580 are logged to /etc/vdsm/mom.conf. /etc/vdsm/mom.conf is the Memory Overcommit Manager log file. An event will also be added to the event log if a virtual machine does not respect a balloon.
10.2. Memory Policy Elements
Copy linkLink copied to clipboard!
The
memory_policy element contains the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
overcommit percent= | complex | The percentage of host memory allowed in use before no more virtual machines can start on a host. Virtual machines can use more than the available host memory due to memory sharing under KSM. Recommended values include 100 (None), 150 (Server Load) and 200 (Desktop Load). |
|
transparent_hugepages | complex | Define the enabled status of Transparent Hugepages. The status is either true or false. Check capabilities feature set to ensure your version supports transparent hugepages. |
|
10.3. Scheduling Policy Elements
Copy linkLink copied to clipboard!
The
scheduling_policy element contains the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
policy | enumerated | The VM scheduling mode for hosts in the cluster. A list of enumerated types are listed in capabilities. |
|
thresholds low= high= duration= | complex | Defines CPU limits for the host. The high attribute controls the highest CPU usage percentage the host can have before being considered overloaded. The low attribute controls the lowest CPU usage percentage the host can have before being considered underutilized. The duration attribute refers to the number of seconds the host needs to be overloaded before the scheduler starts and moves the load to another host. |
|
10.4. XML Representation of a Cluster
Copy linkLink copied to clipboard!
Example 10.1. An XML representation of a cluster
10.5. JSON Representation of a Cluster
Copy linkLink copied to clipboard!
Example 10.2. A JSON representation of a cluster
10.6. Methods
Copy linkLink copied to clipboard!
10.6.1. Creating a Cluster
Copy linkLink copied to clipboard!
Creation of a new cluster requires the
name, cpu id= and datacenter elements. Identify the datacenter with either the id attribute or name element.
Example 10.3. Creating a cluster
10.6.2. Updating a Cluster
Copy linkLink copied to clipboard!
The
name, description, cpu id= and error_handling elements are updatable post-creation.
Example 10.4. Updating a cluster
10.6.3. Removing a Cluster
Copy linkLink copied to clipboard!
Removal of a cluster requires a
DELETE request.
Example 10.5. Removing a cluster
DELETE /ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content
10.7. Sub-Collections
Copy linkLink copied to clipboard!
10.7.1. Networks Sub-Collection
Copy linkLink copied to clipboard!
10.7.1.1. Networks Sub-Collection
Copy linkLink copied to clipboard!
Networks associated with a cluster are represented with the
networks sub-collection. Every host within a cluster connects to these associated networks.
The representation of a cluster's
network sub-collection is the same as a standard network resource except for the following additional elements:
| Element | Type | Description | Properties |
|---|---|---|---|
cluster id= | relationship | A reference to the cluster of which this network is a member. |
|
required | Boolean | Defines required or optional network status. | |
display | Boolean | Defines the display network status. Used for backward compatibility. | |
usages | complex | Defines a set of usage elements for the network. Users can define networks as VM and DISPLAY networks at this level. |
An API user manipulates the
networks sub-collection with the standard REST methods. POSTing a network id or name reference to the networks sub-collection associates the network with the cluster.
Example 10.6. Associating a network resource with a cluster
Update the resource with a
PUT request.
Example 10.7. Setting the display network status
The required or optional network status is set using a
PUT request to specify the Boolean value (true or false) of the required element.
Example 10.8. Setting optional network status
An association is removed with a
DELETE request to the appropriate element in the collection.
Example 10.9. Removing a network association from a cluster
DELETE /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f HTTP/1.1
HTTP/1.1 204 No Content
10.7.2. Storage Volumes Sub-Collection
Copy linkLink copied to clipboard!
10.7.2.1. Red Hat Gluster Storage Volumes Sub-Collection
Copy linkLink copied to clipboard!
Red Hat Virtualization provides a means for creating and managing Red Hat Gluster Storage volumes. Red Hat Gluster Storage volumes are associated with clusters and are represented with the
glustervolumes sub-collection.
The representation of a Red Hat Gluster Storage volume resource in the
glustervolumes sub-collection is defined using the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
volume_type | enumerated | Defines the volume type. See the capabilities collection for a list of volume types. |
|
bricks | relationship | The sub-collection for the Red Hat Gluster Storage bricks. When creating a new volume, the request requires a set of brick elements to create and manage in this cluster. Requires the server_id of the Red Hat Gluster Storage server and a brick_dir element for the brick directory |
|
transport_types | complex | Defines a set of volume transport_type elements. See the capabilities collection for a list of available transport types. |
|
replica_count | integer | Defines the file replication count for a replicated volume. |
|
stripe_count | integer | Defines the stripe count for a striped volume |
|
options | complex | A set of additional Red Hat Gluster Storage option elements. Each option includes an option name and a value. |
|
Example 10.10. An XML representation of a Red Hat Gluster Storage volume
Create a Red Hat Gluster Storage volume via a
POST request with the required name, volume_type and bricks to the sub-collection.
Example 10.11. Creating a Red Hat Gluster Storage volume
Remove a Red Hat Gluster Storage volume with a
DELETE request.
Example 10.12. Removing a Red Hat Gluster Storage volume
DELETE /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/e199f877-900a-4e30-8114-8e3177f47651 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/e199f877-900a-4e30-8114-8e3177f47651 HTTP/1.1
HTTP/1.1 204 No Content
Important
Resources in the
glustervolumes sub-collection cannot be updated.
10.7.2.2. Bricks Sub-Collection
Copy linkLink copied to clipboard!
The
glustervolumes sub-collection contains its own bricks sub-collection to define individual bricks in a Red Hat Gluster Storage volume. Additional information can be retrieved for GET requests using the All-Content: true header.
The representation of a volume's
bricks sub-collection is defined using the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
server_id | string | A reference to the Red Hat Gluster Storage server. |
|
brick_dir | string | Defines a brick directory on the Red Hat Gluster Storage server. |
|
replica_count | integer | Defines the file replication count for the brick in the volume. |
|
stripe_count | integer | Defines the stripe count for the brick in the volume |
|
Create new bricks via a
POST request with the required server_id and brick_dir to the sub-collection.
Example 10.13. Adding a brick
Remove a brick with a
DELETE request.
Example 10.14. Removing a brick
DELETE /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/e199f877-900a-4e30-8114-8e3177f47651/bricks/0a473ebe-01d2-444d-8f58-f565a436b8eb HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/e199f877-900a-4e30-8114-8e3177f47651/bricks/0a473ebe-01d2-444d-8f58-f565a436b8eb HTTP/1.1
HTTP/1.1 204 No Content
Important
Resources in the
bricks sub-collection cannot be updated.
10.7.2.3. Actions
Copy linkLink copied to clipboard!
10.7.2.3.1. Start Action
Copy linkLink copied to clipboard!
The
start action makes a Gluster volume available for use.
Example 10.15. Starting a Volume
Use an optional
force Boolean element to force the action for a running volume. This is useful for starting disabled brick processes in a running volume.
10.7.2.3.2. Stop Action
Copy linkLink copied to clipboard!
The
stop action deactivates a Gluster volume.
Example 10.16. Stopping a Volume
Use an optional
force Boolean element to brute force the stop action.
10.7.2.3.3. Set Option Action
Copy linkLink copied to clipboard!
The
setoption action sets a volume option.
Example 10.17. Set an option
10.7.2.3.4. Reset Option Action
Copy linkLink copied to clipboard!
The
resetoption action resets a volume option.
Example 10.18. Reset an option
10.7.2.3.5. Reset All Options Action
Copy linkLink copied to clipboard!
The
resetalloptions action resets all volume options.
Example 10.19. Reset all options
10.7.3. Affinity Groups Sub-Collection
Copy linkLink copied to clipboard!
10.7.3.1. Affinity Group Sub-Collection
Copy linkLink copied to clipboard!
The representation of a virtual machine affinity group resource in the
affinitygroups sub-collection is defined using the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | A plain text, human readable name for the affinity group. |
|
cluster | relationship | A reference to the cluster to which the affinity group applies. | |
positive | Boolean: true or false | Specifies whether the affinity group applies positive affinity or negative affinity to virtual machines that are members of that affinity group. | |
enforcing | Boolean: true or false | Specifies whether the affinity group uses hard or soft enforcement of the affinity applied to virtual machines that are members of that affinity group. |
Example 10.20. An XML representation of a virtual machine affinity group
Create a virtual machine affinity group via a
POST request with the required name attribute.
Example 10.21. Creating a virtual machine affinity group
Remove a virtual machine affinity group with a
DELETE request.
Example 10.22. Removing a virtual machine affinity group
DELETE https://XX.XX.XX.XX/ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000/affinitygroups/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE https://XX.XX.XX.XX/ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000/affinitygroups/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No ContentChapter 11. Networks
Copy linkLink copied to clipboard!
11.1. Network Elements
Copy linkLink copied to clipboard!
The
networks collection provides information about the logical networks in a Red Hat Virtualization environment. An API user accesses this information through the rel="networks" link obtained from the entry point URI.
The following table shows specific elements contained in a network resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="vnicprofiles" | relationship | A link to the sub-collection for VNIC profiles attached to this logical network. | |
link rel="labels" | relationship | A link to the sub-collection for labels attached to this logical network. | |
data_center id= | GUID | A reference to the data center of which this cluster is a member. |
|
vlan id= | integer | A VLAN tag. | |
stp | Boolean: true or false | true if Spanning Tree Protocol is enabled on this network. | |
mtu | integer | Sets the maximum transmission unit for the logical network. If omitted, the logical network uses the default value. | |
status | One of operational or non_operational | The status of the network. These states are listed in network_states under capabilities. |
|
usages | complex | Defines a set of usage elements for the network. Users can define networks as VM networks at this level. |
Important
The API as documented in this section is experimental and subject to change. It is not covered by the backwards compatibility statement.
11.2. XML Representation of a Network Resource
Copy linkLink copied to clipboard!
Example 11.1. An XML representation of a network resource
11.3. JSON Representation of a Network Resource
Copy linkLink copied to clipboard!
Example 11.2. A JSON representation of a network resource
11.4. Methods
Copy linkLink copied to clipboard!
11.4.1. Creating a Network Resource
Copy linkLink copied to clipboard!
Creation of a new network requires the
name and datacenter elements.
Example 11.3. Creating a network resource
11.4.2. Updating a Network Resource
Copy linkLink copied to clipboard!
The
name, description, ip, vlan, stp and display elements are updatable post-creation.
Example 11.4. Updating a network resource
11.4.3. Removing a Network Resource
Copy linkLink copied to clipboard!
Removal of a network requires a
DELETE request.
Example 11.5. Removing a network
DELETE /ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content
11.5. Sub-collections
Copy linkLink copied to clipboard!
11.5.1. Network VNIC Profile Sub-Collection
Copy linkLink copied to clipboard!
VNIC (Virtual Network Interface Controller) profiles, also referred to as virtual machine interface profiles, are customized profiles applied to users and groups to limit network bandwidth. Each
vnicprofile contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the profile. |
description | string | A plain text description of the profile. |
network | string | The unique identifier of the logical network to which the profile applies. |
port_mirroring | Boolean: true or false | The default is false. |
Example 11.6. An XML representation of the network's vnicprofile sub-collection
11.5.2. Network Labels Sub-Collection
Copy linkLink copied to clipboard!
Network labels are plain text, human-readable labels that allow you to automate the association of logical networks with physical host network interfaces. Each
label contains the following elements:
| Element | Type | Description |
|---|---|---|
network | string | The href and id of the networks to which the label is attached. |
Example 11.7. An XML representation of the network's labels sub-collection
11.5.3. Methods
Copy linkLink copied to clipboard!
11.5.3.1. Attach Label to Logical Network Action
Copy linkLink copied to clipboard!
You can attach labels to a logical network to automate the association of that logical network with physical host network interfaces to which the same label has been attached.
Example 11.8. Action to attach a label to a logical network
POST /ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000/labels/ HTTP/1.1 Accept: application/xml Content-type: application/xml <label id="Label_001" />
POST /ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000/labels/ HTTP/1.1
Accept: application/xml
Content-type: application/xml
<label id="Label_001" />11.5.3.2. Removing a Label From a Logical Network
Copy linkLink copied to clipboard!
Removal of a label from a logical network requires a
DELETE request.
Example 11.9. Removing a label from a logical network
DELETE /ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000/labels/[label_id] HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000/labels/[label_id] HTTP/1.1
HTTP/1.1 204 No Content
Chapter 12. Storage Domains
Copy linkLink copied to clipboard!
12.1. Storage Domain Elements
Copy linkLink copied to clipboard!
The
storagedomains collection provides information about the storage domains in a Red Hat Virtualization environment. An API user accesses this information through the rel="storagedomains" link obtained from the entry point URI.
The following table shows specific elements contained in a storage domain resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="permissions" | relationship | A link to the sub-collection for storage domain permissions. | |
link rel="files" | relationship | A link to the files sub-collection for this storage domains. | |
link rel="vms" | relationship | A link to the vms sub-collection for a storage domain with type set to export. | |
link rel="templates" | relationship | A link to the templates sub-collection for a storage domain with type set to export. | |
type | enumerated | The storage domain type. A list of enumerated values are available in capabilities. |
|
external_status | complex/enumerated | The storage domain health status as reported by external systems and plug-ins. The state element contains an enumerated value of ok, info, warning, error, or failure. | |
master | Boolean: true or false | true if this is the master storage domain of a data center. |
|
host | complex | A reference to the host on which this storage domain should be initialized. The only restriction on this host is that it should have access to the physical storage specified. |
|
storage | complex | Describes the underlying storage of the storage domain. |
|
available | integer | Space available in bytes. |
|
used | integer | Space used in bytes. |
|
committed | integer | Space committed in bytes. |
|
storage_format | enumerated | Describes the storage format version for the storage domain. A list of enumerated values are available in capabilities. |
|
wipe_after_delete | Boolean: true or false | Sets the wipe after delete option by default on the storage domain. This option can be edited after the domain is created, but doing so will not change the wipe after delete property of disks that already exist. | |
warning_low_space_indicator | integer | A percentage value that sets the warning low space indicator option. If the free space available on the storage domain is below this percentage, warning messages are displayed to the user and logged. | |
critical_space_action_blocker | integer | A value in GB that sets the critical space action blocker option. If the free space available on the storage domain is below this value, error messages are displayed to the user and logged, and any new action that consumes space, even temporarily, will be blocked. |
Important
The API as documented in this chapter is experimental and subject to change. It is not covered by the backwards compatibility statement.
12.2. XML Representation of a Storage Domain
Copy linkLink copied to clipboard!
Example 12.1. An XML representation of a storage domain
12.3. JSON Representation of a Storage Domain
Copy linkLink copied to clipboard!
Example 12.2. A JSON representation of a storage domain
12.4. Methods
Copy linkLink copied to clipboard!
12.4.1. Creating a Storage Domain
Copy linkLink copied to clipboard!
Creation of a new storage domain requires the
name, type, host and storage elements. Identify the host element with the id attribute or name element.
You can enable the wipe after delete option by default on the storage domain by specifying
<wipe_after_delete> in the POST request. This option can be edited after the domain is created, but doing so will not change the wipe after delete property of disks that already exist.
Example 12.3. Creating a storage domain
The API user attaches the storage domain to a data center after creation.
12.4.2. Updating a Storage Domain
Copy linkLink copied to clipboard!
Only the
name and wipe after delete elements are updatable post-creation. Changing the wipe after delete element will not change the wipe after delete property of disks that already exist.
Example 12.4. Updating a storage domain
12.4.3. Removing a Storage Domain
Copy linkLink copied to clipboard!
Removal of a storage domain requires a
DELETE request.
Example 12.5. Removing a storage domain
DELETE /ovirt-engine/api/storagedomains/fabe0451-701f-4235-8f7e-e20e458819ed HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/storagedomains/fabe0451-701f-4235-8f7e-e20e458819ed HTTP/1.1
HTTP/1.1 204 No Content
12.5. Storage Types
Copy linkLink copied to clipboard!
12.5.1. Storage Types
Copy linkLink copied to clipboard!
The
storage element contains a type element, which is an enumerated value found under the capabilities collection.
The storage element also contains additional elements specific to each storage
type. The next few sections examine these additional storage type elements.
12.5.2. NFS Storage
Copy linkLink copied to clipboard!
The following table contains
nfs specific elements in a storage description.
| Element | Type | Description | Properties |
|---|---|---|---|
address | string | The host name or IP address of the NFS server. |
|
path | string | The path of NFS mountable directory on the server. |
|
12.5.3. PosixFS Storage
Copy linkLink copied to clipboard!
The following table contains
posixfs specific elements in a storage description.
| Element | Type | Description | Properties |
|---|---|---|---|
address | string | The host name or IP address of the PosixFS server. |
|
path | string | The path of PosixFS mountable directory on the server. |
|
vfs_type | string | The Linux-supported file system type of the PosixFS share. |
|
mount_options | string | The options for mounting the PosixFS share. |
|
12.5.4. iSCSI and FCP Storage
Copy linkLink copied to clipboard!
The following table contains
iscsi and fcp specific elements in a storage description.
| Element | Type | Description | Properties |
|---|---|---|---|
logical_unit id= | complex | The id of the logical unit. A storage domain also accepts multiple iSCSI or FCP logical units. |
|
override_luns | Boolean | Defines whether to replace all logical unit settings with new settings. Set to true to override. |
|
The
logical_unit contains a set of sub-elements.
| Element | Type | Description | Properties |
|---|---|---|---|
address | string | The address of the server containing the storage device. |
|
port | integer | The port number of the server. |
|
target | string | The target IQN for the storage device. |
|
username | string | A CHAP user name for logging into a target. |
|
password | string | A CHAP password for logging into a target. |
|
serial | string | The serial ID for the target. |
|
vendor_id | string | The vendor name for the target. |
|
product_id | string | The product code for the target. |
|
lun_mapping | integer | The Logical Unit Number device mapping for the target. |
|
In the case of iSCSI, if a
logical_unit description also contains details of the iSCSI target with the LUN in question, the target performs an automatic login when the storage domain is created.
12.5.5. LocalFS Storage
Copy linkLink copied to clipboard!
The
localfs specific elements in a storage description are:
| Element | Type | Description | Properties |
|---|---|---|---|
path | string | The path of local storage domain on the host. |
|
A
localfs storage domain requires a data center with storage_type set to localfs. This data center only contains a single host cluster, and the host cluster only contains a single host.
12.6. Export Storage Domains
Copy linkLink copied to clipboard!
12.6.1. Export Storage Domains
Copy linkLink copied to clipboard!
Note
The export storage domain is deprecated. Storage data domains can be unattached from a data center and imported to another data center in the same environment, or in a different environment. Virtual machines, floating virtual disk images, and templates can then be uploaded from the imported storage domain to the attached data center. See the Importing Existing Storage Domains section in the Red Hat Virtualization Administration Guide for information on importing storage domains.
Storage domains with
type set to export contain vms and templates sub-collections, which list the import candidate VMs and templates stored on that particular storage domain.
Example 12.6. Listing the virtual machines sub-collection of an export storage domain
VMs and templates in these collections have a similar representation to their counterparts in the top-level VMs and templates collection, except they also contain a
storage_domain reference and an import action.
The
import action imports a virtual machine or a template from an export storage domain. The destination cluster and storage domain is specified with cluster and storage_domain references.
Include an optional
name element to give the virtual machine or template a specific name.
Example 12.7. Action to import a virtual machine from an export storage domain
Example 12.8. Action to import a template from an export storage domain
Include an optional
clone Boolean element to import the virtual machine as a new entity.
Example 12.9. Action to import a virtual machine as a new entity
Include an optional
disks element to choose which disks to import using individual disk id elements.
Example 12.10. Selecting disks for an import action
Delete a virtual machine or template from an
export storage domain with a DELETE request.
Example 12.11. Delete virtual machine from an export storage domain
12.7. Glance Image Storage Domains
Copy linkLink copied to clipboard!
12.7.1. Glance Image Storage Domains
Copy linkLink copied to clipboard!
Storage domains with type set to
Image represent instances of an OpenStack image service that has been added to the Red Hat Virtualization environment as an external provider. These Glance image storage domains contain an images sub-collection with virtual machine images that have been exported to or can be imported from that Glance image storage domain.
Example 12.12. Listing the images sub-collection of a Glance image storage domain
The
import action imports a virtual machine image from a Glance image storage domain. The destination storage domain is specified with a storage_domain reference, and the destination cluster with a cluster reference.
Include an optional
name element to give the virtual machine or template a specific name.
Example 12.13. Action to import a virtual machine from a Glance image storage domain
You can also import images as templates by specifying the
import_as_template reference:
Example 12.14. Action to import a virtual machine from a Glance image storage domain as a template
12.8. Importing a Block Storage Domain
Copy linkLink copied to clipboard!
12.8.1. Importing a Block Storage Domain
Copy linkLink copied to clipboard!
An existing block storage domain with
type set to iscsi or fcp can be imported to the engine using the REST API. The ability to import storage domains allows you to recover data in the event of a failure in the engine database, and to migrate data from one data center or environment to another.
This procedure assumes the storage domain is not attached to a data center or host in any environment. To import and attach an existing block storage domain to a data center, the target data center must be initialized.
Procedure 12.1. Importing a block storage domain
- Discover the targets on your iSCSI storage server:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Get a list of storage domains that are candidates to be imported, using the iSCSI targets discovered in the previous step:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow The response shows a list of storage domains not associated with a host, similar to the following:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Import the iSCSI storage domains to the host:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
You have now imported the block storage domain to your host.
You may now wish to attach the storage domain to the host, and find any unregistered disks. Attach the storage domain and associated disks with the following steps:
Procedure 12.2. Attaching a block storage domain
- Attach the storage domain to your data center:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Find the unregistered disks on the storage domain:
GET /ovirt-engine/api/storagedomains/6ab65b16-0f03-4b93-85a7-5bc3b8d52be0/disks;unregistered Accept: application/xml Content-Type: application/xml
GET /ovirt-engine/api/storagedomains/6ab65b16-0f03-4b93-85a7-5bc3b8d52be0/disks;unregistered Accept: application/xml Content-Type: application/xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow This will return information about any unregistered disks on the storage domain, with a response similar to:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Attach the disk to the storage domain:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
The disk is now attached to the imported block storage domain.
12.9. Sub-Collections
Copy linkLink copied to clipboard!
12.9.1. Files Sub-Collection
Copy linkLink copied to clipboard!
The
files sub-collection under each storage domain provides a way for clients to list available files. This sub-collection is specifically targeted to ISO storage domains, which contain ISO images and virtual floppy disks (VFDs) that an administrator uploads through Red Hat Virtualization Manager.
The addition of a CD-ROM device to a VM requires an ISO image from the
files sub-collection of an ISO storage domain.
Example 12.15. Listing the files sub-collection of an ISO storage domain
Like other resources, files have opaque
id and href attributes. The name element contains the filename.
12.10. Actions
Copy linkLink copied to clipboard!
12.10.1. Importing an Existing Storage Domain
Copy linkLink copied to clipboard!
Note
The export storage domain is deprecated. Storage data domains can be unattached from a data center and imported to another data center in the same environment, or in a different environment. Virtual machines, floating virtual disk images, and templates can then be uploaded from the imported storage domain to the attached data center. See the Importing Existing Storage Domains section in the Red Hat Virtualization Administration Guide for information on importing storage domains.
The API provides a user with the ability to remove an ISO or Export storage domain from one Red Hat Virtualization Manager instance without re-formatting the underlying storage and import it into another instance. Importing is achieved similarly to adding a new storage domain, except the
name is not specified.
Example 12.16. Importing an existing export storage domain
12.10.2. Deleting a Storage Domain
Copy linkLink copied to clipboard!
A
storage_domain reference is passed in the body of a DELETE request for a storage domain. The storage_domain reference is in the following form:
<storage_domain>
<host id="..."/>
</storage_domain>
<storage_domain>
<host id="..."/>
</storage_domain>
OR
Format Storage Domain
An API user provides a optional format element to specify whether or not to format the storage domain after deletion.
Example 12.17. Formatting a storage domain after deletion
<storage_domain>
<host id="..."/>
<format>true</format>
</storage_domain>
<storage_domain>
<host id="..."/>
<format>true</format>
</storage_domain>
If no
format element is passed, the storage domain remains unformatted.
Logical Removal of Storage Domain
The API also provides a function for the logical removal of the storage domain. This retains the storage domain's data for import. Use the destroy element to logically remove the storage domain and retain the data.
Example 12.18. Logical removal of a storage domain
<storage_domain>
<host id="..."/>
<destroy>true</destroy>
</storage_domain>
<storage_domain>
<host id="..."/>
<destroy>true</destroy>
</storage_domain>
12.10.3. Refreshing the LUN Size
Copy linkLink copied to clipboard!
Users can refresh the LUN size after increasing the size of the underlying LUN on the storage server. The
refreshluns action forces a rescan of the provided LUNs and updates the database with the new size if required.
Example 12.19. Refreshing the LUN Size
Chapter 13. Storage Connections
Copy linkLink copied to clipboard!
13.1. Storage Connection Elements
Copy linkLink copied to clipboard!
| Element | Type | Description | Properties |
|---|---|---|---|
type | One of nfs, posixfs, local, or iscsi | The type of storage domain. |
|
address | string | The hostname or IP address of the storage domain. |
(Only required for NFS and iSCSI)
|
host | string | The id or name of the hypervisor. The host is optional. Providing it will attempt a connection to the storage via the host; not providing it will lead to persisting storage details in the database. |
| Element | Type | Description | Properties |
|---|---|---|---|
path | string | The mounted file path of the storage domain. The path cannot be updated to one already used by a storage connection. |
|
mount_options | string | The options for mounting the PosixFS share. | |
vfs_type | string | The Linux-supported file system type of the PosixFS share. |
|
nfs_version | string | The version of NFS used. | |
nfs_timeo | integer | The amount of time, in deciseconds, the NFS client will wait for a request to complete. | |
nfs_retrans | integer | The number of retransmissions the NFS client will attempt to complete a request. |
| Element | Type | Description | Properties |
|---|---|---|---|
port | integer | The TCP port used for the iSCSI storage domain. |
|
target | string | The target IQN for the storage device. |
|
username | string | A CHAP user name for logging into a target. | |
password | string | A CHAP password for logging into a target. |
13.2. XML representation of a Storage Connection Resource
Copy linkLink copied to clipboard!
Example 13.1. An XML representation of a storage connection resource
13.3. Methods
Copy linkLink copied to clipboard!
13.3.1. Creating a New Storage Connection
Copy linkLink copied to clipboard!
Creating a new storage connection requires a
POST request.
It is possible to create a new storage connection without adding a storage domain. The host
id or name is optional; providing it will attempt a connection to the storage via the host.
Example 13.2. Creating a New Storage Connection
13.3.2. Deleting a Storage Connection
Copy linkLink copied to clipboard!
Deleting a storage connection requires a
DELETE request. A storage connection can only be deleted if neither storage domain nor LUN disks reference it.
The host
name or id is optional; providing it unmounts the connection from that host.
Example 13.3. Deleting Storage Connection
13.3.3. Updating a Storage Connection
Copy linkLink copied to clipboard!
Updating an existing storage connection requires a
PUT request. The storage domain must be in either maintenance mode or unattached to successfully update the connection.
Providing the host
name or id is optional; if provided, the host attempts a connection to the updated storage details.
Example 13.4. Updating a Storage Connection
13.3.4. Updating an iSCSI Storage Connection
Copy linkLink copied to clipboard!
Updating an existing iSCSI storage connection requires a
PUT request. An iSCSI storage domain must be in maintenance mode or unattached to successfully update the connection.
Example 13.5. Updating a Storage Connection
13.3.5. Adding New Storage Domain with Existing Storage Connection
Copy linkLink copied to clipboard!
Adding a new storage domain with existing storage connection requires a
POST request. This is only applicable with file-based storage domains: NFS, POSIX, and local.
Example 13.6. Adding a New Storage Domain with Existing Storage Connection
13.3.6. Attaching an Additional Storage Connection to iSCSI Storage
Copy linkLink copied to clipboard!
Attaching an additional storage connection to an iSCSI storage domain requires a
POST request.
Example 13.7. Attaching an Additional Storage Connection to iSCSI Storage
13.3.7. Detaching a Storage Connection from iSCSI Storage
Copy linkLink copied to clipboard!
Detaching a storage connection from an iSCSI storage domain requires a
DELETE request.
Example 13.8. Detaching a Storage Connection from iSCSI Storage
DELETE /ovirt-engine/api/storagedomains/iSCSI_Domain_ID/storageconnections/Storage_Connection_ID HTTP/1.1 Accept: application/xml Content-type: application/xml
DELETE /ovirt-engine/api/storagedomains/iSCSI_Domain_ID/storageconnections/Storage_Connection_ID HTTP/1.1
Accept: application/xml
Content-type: application/xml
13.3.8. Defining Credentials to an iSCSI Target
Copy linkLink copied to clipboard!
When an iSCSI storage domain is added using the Administration Portal, only a single user name and password can be specified for that domain. However, some setups require that each host in the cluster use a separate user name and password. Specific credentials can be applied to each iSCSI target per host by using the
storageconnectionextensions element.
Example 13.9. Defining credentials to an iSCSI target
Chapter 14. Hosts
Copy linkLink copied to clipboard!
14.1. Host Elements
Copy linkLink copied to clipboard!
The
hosts collection provides information about the hosts in a Red Hat Virtualization environment. An API user accesses this information through the rel="hosts" link obtained from the entry point URI.
Additional information can be retrieved for
GET requests using the All-Content: true header.
The following table shows specific elements contained in a host resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="storage" | relationship | A link to the storage sub-collection for host storage. |
|
link rel="nics" | relationship | A link to the nics sub-collection for host network interfaces. | |
link rel="numanodes" | relationship | A link to the numanodes sub-collection for host NUMA nodes. | |
link rel="tags" | relationship | A link to the tags sub-collection for host tags. | |
link rel="permissions" | relationship | A link to the permissions sub-collection for host permissions. | |
link rel="statistics" | relationship | A link to the statistics sub-collection for host statistics. |
|
link rel="hooks" | relationship | A link to the hooks sub-collection for host hooks. | |
link rel="fenceagents" | relationship | A link to the fenceagents sub-collection for host fence agents. | |
link rel="katelloerrata" | relationship | A link to the katelloerrata sub-collection for host errata. | |
link rel="devices" | relationship | A link to the devices sub-collection for host devices. | |
link rel="networkattachments" | relationship | A link to the networkattachments sub-collection for host network configuration. | |
link rel="unmanagednetworks" | relationship | A link to the unmanagednetworks sub-collection for unmanaged networks on the host. | |
link rel="storageconnectionextensions" | relationship | A link to the storageconnectionextensions sub-collection for host storage connection extensions. | |
name | string | The unique identifier for the host. | |
root_password | string | The root password of this host, by convention only included in the client-provided host representation on creation. |
|
comment | string | Any comments regarding the host. | |
address | string | The IP address or hostname of the host. |
|
certificate | complex | A reference to the host certificate details, including organization and subject. |
|
status | See below | The host status. |
|
external_status | complex/enumerated | The host health status as reported by external systems and plug-ins. The state element contains an enumerated value of ok, info, warning, error, or failure. | |
cluster id= | GUID | A reference to the cluster that includes this host. | |
port | integer | The listen port of the VDSM daemon running on this host. |
|
type | One of rhel or ovirt_node | The host type. |
|
storage_manager priority= | Boolean: true or false | Specifies whether the host is a storage manager. |
|
version major= minor= build= revision= full_version= | complex | The compatibility level of the host. |
|
hardware_information | complex | Information regarding the hardware of the host, including manufacturer, version, serial_number, product_name, uuid, and family. | |
power_management type= | complex | Configuration options for host power management, including enabled, options, kdump_detection, automatic_pm_enabled, and agents. See Section 14.4, “Power Management Elements” for more information on the host power management options. | |
ksm | Boolean: true or false | true if Kernel SamePage Merging (KSM) is enabled. | |
transparent_hugepages | Boolean: true or false | true if Transparent Hugepages is enabled. | |
iscsi | complex | The SCSI initiator for the host. |
|
ssh | complex | Details regarding the SSH connection with the host, including port and fingerprint. | |
cpu | complex | Statistics for the host CPU. Includes sub-elements for the CPU's name, topology cores=, topology sockets=, topology threads= and speed. The topology cores= aggregates the total cores while the topology sockets= aggregates the total physical CPUs. The total cores available to virtual machines equals the number of sockets multiplied by the cores per socket. |
|
memory | integer | The total amount of host memory in bytes. |
|
max_scheduling_memory | integer | The maximum amount of memory that can be used in scheduling in bytes. |
|
summary | complex | Summary statistics of the virtual machines on the host. Includes sub-elements for numbers of active, migrating and total VMs. |
|
os type= | complex | Details regarding the operating system installed on the host, including version full_version=. |
|
libvirt_version major= minor= build= revision= full_version= | complex | The libvirt compatibility level of the host. |
|
The
status contains one of the following enumerative values: down, error, initializing, installing, install_failed, maintenance, non_operational, non_responsive, pending_approval, preparing_for_maintenance, connecting, reboot, unassigned and up. These states are listed in host_states under capabilities.
14.2. XML Representation of a Host
Copy linkLink copied to clipboard!
Example 14.1. An XML representation of a host
14.3. JSON Representation of a Host
Copy linkLink copied to clipboard!
Example 14.2. A JSON representation of a host
14.4. Power Management Elements
Copy linkLink copied to clipboard!
The
power_management element provides users with the ability to set a power management configuration, which is required for host fencing. Certain sub-elements are required when configuring power_management.
| Element | Type | Description | Properties |
|---|---|---|---|
type= | fencing device code | A list of valid fencing device codes are available in the capabilities collection. |
|
enabled | Boolean: true or false | Indicates whether power management configuration is enabled or disabled. |
|
address | string | The host name or IP address of the host. |
|
username | string | A valid user name for power management. | |
password | string | A valid, robust password for power management. | |
options | complex | Fencing options for the selected type= specified with the option name="" and value="" strings. | |
agents | complex | Specifies fence agent options when multiple fences are used. Use the order sub-element to prioritize the fence agents. Agents are run sequentially according to their order until the fence action succeeds. When two or more fence agents have the same order, they are run concurrently. Other sub-elements include type, ip, user, password, and options. | |
automatic_pm_enabled | Boolean: true or false | Toggles the automated power control of the host in order to save energy. When set to true, the host will be automatically powered down if the cluster's load is low, and powered on again when required. This is set to true when a host is created, unless disabled by the user. | |
kdump_detection | Boolean: true or false | Toggles whether to determine if kdump is running on the host before it is shut down. When set to true, the host will not shut down during a kdump process. This is set to true when a host has power management enabled, unless disabled by the user. |
The
options element requires a list of option sub-elements. Each option requires a name and type attributes. Certain options are only available for specific fencing types as defined in the capabilities collection.
A new host includes an optional
power_management configuration when POSTing to the host resource. The power_management configuration is updatable using a PUT request.
Example 14.3. An XML representation of a host's power management configuration
14.5. Memory Management Elements
Copy linkLink copied to clipboard!
The API provides two configuration settings for a host's memory management.
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. KSM uses the
ksm element.
Example 14.4. Setting KSM memory management
Transparent Hugepage support expands the size of memory pages beyond the standard 4kB limit. This reduces memory consumption and increases host performance. Transparent Hugepage support uses the
transparent_hugepages element.
Example 14.5. Setting Transparent Hugepage memory management
Availability of Transparent Hugepage support is found in the
capabilities collection.
14.6. Methods
Copy linkLink copied to clipboard!
14.6.1. Creating a Host
Copy linkLink copied to clipboard!
Creation of a new host requires the
name, address and root_password elements.
Example 14.6. Creating a host
The
root_password element is only included in the client-provided initial representation and is not exposed in the representations returned from subsequent requests.
14.6.2. Updating a Host
Copy linkLink copied to clipboard!
The
name, description, cluster, power_management, transparent_hugepages and ksm elements are updatable post-creation.
Example 14.7. Updating a host
14.6.3. Removing a Host
Copy linkLink copied to clipboard!
Removal of a host requires a
DELETE request.
Example 14.8. Removing a host
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content
14.7. Sub-Collections
Copy linkLink copied to clipboard!
14.7.1. Host Network Attachments Sub-Collection
Copy linkLink copied to clipboard!
The
network_attachments sub-collection represents the network configuration of the host. Each network_attachment element represents a network attached to the host and contains the following elements:
|
Element
|
Type
|
Description
|
Properties
|
|---|---|---|---|
network id=
|
GUID
|
A reference to the network to which the host is attached.
|
|
host_nic id=
|
GUID
|
A reference to the host network interface to which the network is attached.
|
|
ip_address_assignments
|
complex
|
The IP configuration of the network. Each
ip_address_assignment contains assignment_method and ip address= netmask= gateway= sub-elements.
| |
properties
|
complex
|
Defines custom property keys for the network. Each
property contains name and value sub-elements. See Section 14.7.2.3.2, “Network Attachment Custom Properties”.
| |
reported_configurations
|
complex
|
A read-only list of configuration properties for the network attachment. The
in_sync boolean is false when the network attachment is out of sync with the logical network definition of the data center. Each reported_configuration contains name, expected_value, actual_value, and in_sync sub-elements.
|
|
host id=
|
GUID
|
A reference to the host.
|
|
Example 14.9. An XML representation of a network attachment on a host
When attaching a network to a host, the
network and host_nic elements are required, with either an id or a name. The host_nic ID can refer to either an unused network interface card or a bond.
Example 14.10. Attach a network to a host
The
host_nic, ip_address_assignments, and properties elements are updatable post-creation. Changing the host_nic ID moves the network to a different network interface card.
Example 14.11. Modifying a host network attachment
Detach a network from the host with a
DELETE request on the network attachment.
Example 14.12. Detach a network from a host
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000 HTTP/1.1 Accept: application/xml Content-type: application/xml HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
HTTP/1.1 204 No ContentImportant
Changes to network attachment configuration must be explicitly committed. See Section 14.8.8, “Commit Host Network Configuration Action”.
14.7.2. Host Network Interface Sub-Collection
Copy linkLink copied to clipboard!
14.7.2.1. Host Network Interface Sub-Collection
Copy linkLink copied to clipboard!
The
nics sub-collection represents a host's physical network interfaces. Additional information can be retrieved for GET requests using the All-Content: true header. Each host_nic element in the representation acts as a network interface and contains the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | The name of the host network interface, e.g. eth0. |
[a]
|
link rel="statistics" | relationship | A link to the statistics sub-collection for a host's network interface statistics. |
|
link rel="labels" | relationship | A link to the labels sub-collection for a host's network interface labels. | |
link rel="networkattachments" | relationship | A link to the networkattachments sub-collection for a host's network interface configuration. | |
link rel="master" | relationship | A reference to the master bonded interface, if this is a slave interface. |
|
host id= | GUID | A reference to the host. |
|
network id= | GUID | A reference to the network, if any, that the interface is attached. |
[b] |
mac address= | string | The MAC address of the interface. |
|
ip address= netmask= gateway= mtu= | complex | The IP level configuration of the interface. | |
mtu | complex | The maximum transmission unit for the interface. | |
boot_protocol | enumerated | The protocol for IP address assignment when the host is booting. A list of enumerated values is available in capabilities. | |
status | enumerated | The link status for the network interface. These states are listed in host_nic_states under capabilities. |
|
vlan id | integer | The VLAN which this interface represents. |
|
bonding | complex | A list of options and slave NICs for bonded interfaces. |
[c]
|
bridged | Boolean | Defines the bridged network status. Set to true for a bridged network and false for a bridgeless network. | |
[a]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
[b]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
[c]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
| |||
Example 14.13. An XML representation of a network interface on a host
In the REST API, you can only create bonded interfaces. See Section 14.7.2.2, “Bonded Interfaces”. All other network interfaces contain updatable
network, ip and boot_protocol elements.
Modify a network interface with a
PUT request.
Remove a network interface with a
DELETE request.
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/ 00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/
00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content
14.7.2.2. Bonded Interfaces
Copy linkLink copied to clipboard!
A bonded interface is represented as a
host_nic resource containing a bonding element.
| Element | Type | Description | Properties |
|---|---|---|---|
options | complex | A list of option elements for a bonded interface. Each option contains property name and value attributes. |
[a]
|
slaves | complex | A list of slave host_nic id= elements for a bonded interface. |
[b]
|
[a]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
[b]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
| |||
An API user creates a new bond when creating a new
host_nic (POST) or updating a host_nic (PUT). Use either the id or name elements to identify the slave host_nic elements. When adding a new network interface, the name and network elements are required. Identify the network element with the id attribute or name element.
Example 14.14. Creating a bonded interface
Important
bond0, bond1, bond2, bond3 and bond4 are the only valid names for a bonded interface.
Example 14.15. Removing a bonded interface
Remove a bonded interface with a
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
DELETE request.
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No ContentImportant
Changes to bonded interface configuration must be explicitly committed. See Section 14.8.8, “Commit Host Network Configuration Action”.
14.7.2.3. Network Interface Network Attachments
Copy linkLink copied to clipboard!
14.7.2.3.1. Network Interface Network Attachments
Copy linkLink copied to clipboard!
Each network interface on a host exposes a
network_attachments sub-collection representing the network interface card's network attachments. Each network_attachment represents a network attached to the network interface and contains the following elements:
|
Element
|
Type
|
Description
|
Properties
|
|---|---|---|---|
network id=
|
GUID
|
A reference to the network to which the interface is attached.
|
|
host_nic id=
|
GUID
|
A reference to the host network interface.
|
|
ip_address_assignments
|
complex
|
The IP configuration of the network. Each
ip_address_assignment contains assignment_method and ip address= netmask= gateway= sub-elements.
| |
properties
|
complex
|
Defines custom property keys for the network. Each
property contains name and value sub-elements.
| |
reported_configurations
|
complex
|
A read-only list of configuration properties for the network attachment. The
in_sync boolean is false when the network attachment contains uncommitted network configuration. Each reported_configuration contains name, expected_value, actual_value, and in_sync sub-elements.
|
|
Example 14.16. An XML representation of a network attachment on a network interface card
When attaching a network to a network interface card, the
network element is required, with either an id or a name.
Example 14.17. Attach a network to a host network interface card
The
ip_address_assignments and properties elements are updatable post-creation.
Example 14.18. Modifying a network attachment
Detach a network from the network interface card with a
DELETE request on the network attachment.
Example 14.19. Detach a network from a host network interface card
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000 HTTP/1.1 Accept: application/xml Content-type: application/xml HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
HTTP/1.1 204 No ContentImportant
Changes to network attachment configuration must be explicitly committed. See Section 14.8.8, “Commit Host Network Configuration Action”.
14.7.2.3.2. Network Attachment Custom Properties
Copy linkLink copied to clipboard!
Custom properties can be applied to network attachments. Each property contains
name and value sub-elements. To amend the custom properties, perform a PUT request on a network attachment, or a POST request with the setupnetworks action.
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the property. Bridge options have the set name of bridge_opts. |
value | string | The bridge options, represented by a valid key and value with the following syntax: [key]=[value]. Separate multiple entries with a whitespace character. The following keys are valid, with the values provided as examples:
|
Example 14.20. An XML representation of a network attachment's properties sub-collection
14.7.2.4. Network Interface Labels
Copy linkLink copied to clipboard!
You can attach labels to a host network interface card to automate the association of that network interface card with logical networks to which the same label has been attached.
Example 14.21. Attaching a label to a network interface card
POST /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels HTTP/1.1 Accept: application/xml Content-type: application/xml <label id="Label_001" />
POST /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels HTTP/1.1
Accept: application/xml
Content-type: application/xml
<label id="Label_001" />
Removal of a label from a physical host network interface card requires a
DELETE request.
Example 14.22. Removing a label from a network interface card
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content14.7.2.5. Network Interface Statistics
Copy linkLink copied to clipboard!
Each host's network interface exposes a
statistics sub-collection for a host's network interface statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
host_nic id= | relationship | A relationship to the containing host_nic resource. |
The following table lists the statistic types for network interfaces on hosts.
|
Name
|
Description
|
|---|---|
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.
|
Example 14.23. An XML representation of a host's network interface statistics sub-collection
Note
This
statistics sub-collection is read-only.
14.7.3. Storage Sub-Collection
Copy linkLink copied to clipboard!
The
storage sub-collection provides a list of the iSCSI and FCP storage representations available on the host. This storage is used to create storage domains.
Each
storage representation in the sub-collection represents a SCSI LUN.
Example 14.24. An XML representation of the storage sub-collection on a host
Note
The
host_storage collection is read-only.
Important
The API as documented in this section is experimental and subject to change. It is not covered by the backwards compatibility statement.
14.7.4. Host NUMA Nodes Sub-Collection
Copy linkLink copied to clipboard!
14.7.4.1. NUMA Nodes Sub-Collection
Copy linkLink copied to clipboard!
The
numanodes sub-collection represents the host's NUMA topology. Each host_numa_node element in the sub-collection represents a NUMA node.
Example 14.25. An XML representation of the numanodes sub-collection on a host
Note
The
host_numa_nodes sub-collection is read-only.
14.7.4.2. NUMA Node Statistics
Copy linkLink copied to clipboard!
Each host NUMA node exposes a
statistics sub-collection for NUMA node statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
host_numa_node id= | relationship | A relationship to the containing numanode resource. |
The following table lists the statistic types for host NUMA nodes.
| Name | Description |
|---|---|
memory.total | Total memory in bytes on the NUMA node. |
memory.used | Memory in bytes used on the NUMA node. |
memory.free | Memory in bytes free on the NUMA node. |
cpu.current.user | Percentage of CPU usage for users. |
cpu.current.system | Percentage of CPU usage for the system. |
cpu.current.idle | Percentage of idle CPU usage. |
Example 14.26. An XML representation of the host NUMA node's statistics sub-collection
Note
A host NUMA node's
statistics sub-collection is read-only.
14.7.5. Host Statistics Sub-Collection
Copy linkLink copied to clipboard!
14.7.5.1. Host Statistics Sub-Collection
Copy linkLink copied to clipboard!
Each host resource exposes a
statistics sub-collection for host-specific statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
host id= | relationship | A relationship to the containing host resource. |
The following table lists the statistic types for hosts.
|
Name
|
Description
|
|---|---|
memory.total |
Total memory in bytes on the host.
|
memory.used |
Memory in bytes used on the host.
|
memory.free |
Memory in bytes free on the host.
|
memory.shared |
Memory in bytes shared on the host.
|
memory.buffers |
I/O buffers in bytes.
|
memory.cached |
OS caches in bytes.
|
swap.total |
Total swap memory in bytes on the host.
|
swap.free |
Swap memory in bytes free on the host.
|
swap.used |
Swap memory in bytes used on the host.
|
swap.cached |
Swap memory in bytes also cached in host's memory.
|
ksm.cpu.current |
Percentage of CPU usage for Kernel SamePage Merging.
|
cpu.current.user |
Percentage of CPU usage for users.
|
cpu.current.system |
Percentage of CPU usage for system.
|
cpu.current.idle |
Percentage of idle CPU usage.
|
cpu.load.avg.5m |
CPU load average per five minutes.
|
Example 14.27. An XML representation of the host's statistics sub-collection
Note
A host's
statistics sub-collection is read-only.
14.8. Actions
Copy linkLink copied to clipboard!
14.8.1. Install VDSM Action
Copy linkLink copied to clipboard!
Install VDSM and related software on the host.
Example 14.28. Action to install VDSM on a virtualization host
14.8.2. Activate Host Action
Copy linkLink copied to clipboard!
Activate the host for use, such as running virtual machines.
Example 14.29. Action to activate a host
14.8.3. Host Network Setup Action
Copy linkLink copied to clipboard!
Configure multiple network settings on a host. The
setupnetworks action can be used for complex network configuration such as moving a network from one network interface to another.
Example 14.30. Action to edit host network configuration
This action updates all specified host network resources with standard NIC elements. The request includes additional elements specified in the following table.
| Element | Type | Description |
|---|---|---|
modified_bonds | complex | Creates or updates bonds. Each host_nic element contains standard bonding elements. See Section 14.7.2.2, “Bonded Interfaces”. |
removed_bonds | complex | An ID list of bonds to remove. |
modified_network_attachments | complex | Adds or updates network attachments on the host. Each network_attachment element contains standard host network_attachment elements. See Section 14.7.1, “Host Network Attachments Sub-Collection”. Changing the host_nic ID moves the network to a different network interface card. |
synchronized_network_attachments | complex | An ID list of out-of-sync network attachments to synchronize with the logical network definition of the data center. |
removed_network_attachments | complex | An ID list of network attachments to remove. |
modified_labels | complex | Creates or modifies labels. Each label element contains a label id (when creating a label) and a host_nic identified by a name or ID. Changing the host_nic ID moves the label to a different network interface card. |
removed_labels | complex | An ID list of labels to remove. |
checkConnectivity | Boolean | Set to true to verify connectivity between the host and the Red Hat Virtualization Manager. If the connectivity is lost, Red Hat Virtualization Manager reverts the settings. |
connectivityTimeout | integer | Defines the timeout for loss of connectivity. |
14.8.4. Fence Host Action
Copy linkLink copied to clipboard!
An API user controls a host's power management device with the
fence action. The capabilities lists available fence_type options.
Example 14.31. Action to fence a host
14.8.5. Deactivate Host Action
Copy linkLink copied to clipboard!
Deactivate the host to perform maintenance tasks.
Example 14.32. Action to deactivate a host
14.8.6. Host iSCSI Login Action
Copy linkLink copied to clipboard!
The
iscsilogin action enables a host to login to an iSCSI target. Logging into a target makes the contained LUNs available in the host_storage collection.
Example 14.33. Action to enable a host to login to iSCSI target
14.8.7. Host iSCSI Discover Action
Copy linkLink copied to clipboard!
The
iscsidiscover action enables an iSCSI portal to be queried for its list of targets.
Example 14.34. Action to query a list of targets for iSCSI portal
14.8.8. Commit Host Network Configuration Action
Copy linkLink copied to clipboard!
An API user commits the network configuration to persist a host network interface attachment or detachment, or persist the creation and deletion of a bonded interface.
Example 14.35. Action to commit network configuration
Important
Networking configuration is only committed after the Manager has established that host connectivity is not lost as a result of the configuration changes. If host connectivity is lost, the host requires a reboot and automatically reverts to the previous networking configuration.
14.8.9. Setting SPM
Copy linkLink copied to clipboard!
Manually set a host as the Storage Pool Manager (SPM).
Example 14.36. Action to Set Host as SPM
Chapter 15. Virtual Machines
Copy linkLink copied to clipboard!
15.1. Virtual Machine Elements
Copy linkLink copied to clipboard!
The
vms collection provides information about virtual machines in a Red Hat Virtualization environment. An API user accesses this information through the rel="vms" link obtained from the entry point URI.
Additional information can be retrieved for
GET requests using the All-Content: true header.
The following table shows specific elements contained in a virtual machine resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="applications" | relationship | A link to the applications sub-collection for virtual machine resources, which shows the applications installed on the virtual machine. | |
link rel="disks" | relationship | A link to the disks sub-collection for virtual machine resources. | |
link rel="nics" | relationship | A link to the nics sub-collection for virtual machine resources. | |
link rel="numanodes" | relationship | A link to the numanodes sub-collection for virtual machine resources. | |
link rel="cdroms" | relationship | A link to the cdroms sub-collection for virtual machine resources. | |
link rel="snapshots" | relationship | A link to the snapshots sub-collection for virtual machine resources. | |
link rel="tags" | relationship | A link to the tags sub-collection for virtual machine resources. | |
link rel="permissions" | relationship | A link to the permissions sub-collection for virtual machine permissions. | |
link rel="statistics" | relationship | A link to the statistics sub-collection for virtual machine resources. |
|
link rel="reporteddevices" |
relationship
|
A link to the
reporteddevices sub-collection for virtual machine resources.
| |
link rel="watchdogs" |
relationship
|
A link to the
watchdogs sub-collection for virtual machine resources.
| |
link rel="sessions" |
relationship
|
A link to the
sessions sub-collection for virtual machine resources.
| |
type | enumerated | The virtual machine type. A list of enumerated values are available in capabilities. |
|
status | See below | The virtual machine status. |
|
memory | integer | The amount of memory allocated to the guest in bytes. | |
cpu | complex |
Defines CPU details for the virtual machine. The
topology sub-element sets number of logical sockets available to the guest and the number of cores per socket. The total cores available to the virtual machine equals the number of sockets multiplied by the cores per socket.
The
cputune sub-element maps virtual CPUs to physical host CPUs using a series of vcpupin elements. Each vcpupin elements contains a virtual CPU attribute (vcpu) and an attribute to define which physical to use (cpuset). Set the cpuset to either a single CPU (cpuset="0"), multiple CPUs (cpuset="0,2"), a CPU range (cpuset="0-3") or a CPU range with exclusion (cpuset="0-3,^2").
The
cpu_mode sub-element defines how closely the virtual CPU relates to the host CPU. It has three values: custom is the default if no mode is given, host_model copies the host CPU as best as libvirt can understand, and host_passthrough passes all aspects of the host to the guest, even those that libvirt does not recognize. However, host_passthrough will prevent migration of that virtual machine.
| |
os type= | string, e.g. RHEL5 or WindowsXP | The guest operating system type. | |
os boot dev= | enumerated | A list of boot devices described by a dev attribute on a boot element. A list of enumerated values are available in capabilities. | |
os kernel | string | A path to a kernel image the virtual machine is configured to boot. This option supports booting a Linux kernel directly rather than through the BIOS bootloader. | |
os initrd | string | A path to an initrd image to be used with the previously specified kernel. This option supports booting a Linux kernel directly rather than through the BIOS bootloader. | |
os cmdline | string | A kernel command line parameter string to be used with the defined kernel. This option supports booting a Linux kernel directly rather than through the BIOS bootloader. | |
high_availability | complex | Set enabled to true if the virtual machine should be automatically restarted if the virtual machine or its host crashes. A priority element controls the order in which virtual machines are re-started. | |
display | complex |
The display
type (either vnc or spice), port, and the number of monitors. The allow_reconnect Boolean value specifies if a client can reconnect to the machine via display.
The
smartcard_enabled sub-element is a Boolean (true or false) to specify if a Smartcard attached to a client is passed through to a virtual machine. The default is false.
| |
cluster id= | GUID | A reference to the virtual machine's host cluster. |
|
template id= | GUID | A reference to the template on which this virtual machine is based. |
|
domain id= | GUID | A reference to the virtual machine's domain. |
|
start_time | xsd:dateTime format: YYYY-MM-DDThh:mm:ss | The date and time at which this virtual machine was started. |
|
stop_time | xsd:dateTime format: YYYY-MM-DDThh:mm:ss | The date and time at which this virtual machine was stopped. |
|
creation_time | xsd:dateTime format: YYYY-MM-DDThh:mm:ss | The date and time at which this virtual machine was created. |
|
origin | One of rhev, ovirt, vmware or xen | The system from which this virtual machine originated. |
|
stateless | Boolean: true or false | true if the virtual machine is stateless. A stateless virtual machine contains a snapshot of its disk image taken at boot and deleted at shutdown. This means state changes do not persist after a reboot. | |
delete_protected | Boolean: true or false | If set to true, the virtual machine cannot be deleted. | |
sso | string | A reference to the method of single sign-on for the virtual machine. Includes a method element with an ip attribute. | |
placement_policy | complex | Sets the placement policy for virtual machine migration. Requires a default host= and an affinity (one of migratable, user_migratable or pinned). Leave the host element empty to set no preferred host. Use multiple host elements to specify a subset of preferred hosts within a cluster. | |
memory_policy | complex | Sets the memory policy for virtual machines. Defines the minimum amount of guaranteed memory on a host in order for the virtual machine to run. | |
quota id= | GUID | Sets a quota for the virtual machine. | |
custom_properties | complex | A set of user-defined environment variable passed as parameters to custom scripts. Each custom_property contains name and value attributes. A list of enumerated values are available in capabilities. | |
usb | complex | Defines the USB policy for a virtual machine. Requires an enabled element set to a Boolean value and a type element set to either native or legacy.
Important
The Legacy USB option has been deprecated and will be removed in Red Hat Virtualization 4.1.
| |
migration_downtime | integer | Represents the maximum number of milliseconds the virtual machine can be down during live migration. A value of 0 means that the VDSM default will be used. | |
cpu_profile id= | GUID | A reference to the virtual machine's cpu profile. | |
next_run_configuration | Boolean: true or false | true if changes to the virtual machine's configuration will be applied when the virtual machine is next restarted. | |
numa_tune_mode | string | Reference to the mode of memory allocation (interleave, strict, or preferred) of the host NUMA node. | |
guest_info | complex | A reference to the guest client information. Includes an ip element with an address= attribute. |
|
vmpool | complex | A reference to the virtual machine pool. This element only appears for virtual machines part of a pool. |
|
timezone | tz database format: Area/Location | The Sysprep timezone setting for a Windows virtual machine. | |
domain | complex | The Sysprep domain setting for a Windows virtual machine. Requires a name from the domains collection. | |
initialization | complex |
Defines a list of values applied to the virtual machine on boot using Cloud-Init for Linux-based virtual machines, or Sysprep for Windows-based virtual machines.
| |
payloads | complex |
Defines a set of
payload elements to deliver content to a virtual machine upon boot. Each payload requires a type attribute, either cdrom or floppy, and a set of file elements. Within each file element is a name element that specifies the name and location of the file, and a content element that defines the content to deliver to the file.
The
payloads element is used by the cloud-init feature. When cloud-init is used to configure a virtual machine, a payload is automatically created with the type attribute set to cd-rom and two file sub-elements, openstack/latest/meta_data.json and openstack/latest/user_data, which pass configuration parameters to the virtual machine.
|
The
status contains one of the following enumerative values: unassigned, down, up, powering_up, powered_down, paused, migrating_from, migrating_to, unknown, not_responding, wait_for_launch, reboot_in_progress, saving_state, restoring_state, suspended, image_illegal, image_locked or powering_down. These states are listed in vm_states under capabilities.
15.2. XML Representation of a Virtual Machine
Copy linkLink copied to clipboard!
Example 15.1. An XML representation of a virtual machine
15.3. XML Representation of Additional OVF Data for a Virtual Machine
Copy linkLink copied to clipboard!
Use a
GET request for a virtual machine with the All-Content: true header to include additional OVF data with the representation of the virtual machine.
The
Accept header defaults to application/xml if left blank, and the data is represented with HTML entities so as not to interfere with the XML tags. Specifying the Accept: application/json header will return the data in standard XML tagging. This example representation has been formatted from its standard block format to improve legibility.
Example 15.2. XML representation of additional ovf data for a virtual machine
15.4. JSON Representation of a Virtual Machine
Copy linkLink copied to clipboard!
Example 15.3. A JSON representation of a virtual machine
15.5. Methods
Copy linkLink copied to clipboard!
15.5.1. Creating a Virtual Machine
Copy linkLink copied to clipboard!
Creating a new virtual machine requires the
name, template, and cluster elements. Identify the template and cluster elements with the id attribute or name element. Identify the CPU profile ID with the cpuprofiles attribute.
Example 15.4. Creating a virtual machine with 512 MB that boots from CD-ROM
Example 15.5. Creating a virtual machine with 512 MB that boots from a virtual hard disk
Note
Memory in the previous example is converted to bytes using the following formula:
512MB * 1024 2 = 536870912 bytes
15.5.2. Updating a Virtual Machine
Copy linkLink copied to clipboard!
The
name, description, cluster, type, memory, cpu, os, high_availability, display, timezone, domain, stateless, placement_policy, memory_policy, usb, payloads, origin and custom_properties elements are updatable post-creation.
Example 15.6. Updating a virtual machine to contain 1 GB of memory
Note
Memory in the previous example is converted to bytes using the following formula:
1024MB * 1024 2 = 1073741824 bytes
Note
Memory hot plug is supported in Red Hat Virtualization. If the virtual machine's operating system supports memory hot plug, you can use the example above to increase memory while the virtual machine is running.
Example 15.7. Hot plugging vCPUs
Add virtual CPUs to a running virtual machine without having to reboot it. In this example, the number of sockets is changed to 2.
Note
CPU hot unplug is currently not supported in Red Hat Virtualization.
Example 15.8. Pinning a virtual machine to multiple hosts
A virtual machine that is pinned to multiple hosts cannot be live migrated, but in the event of a host failure, any virtual machine configured to be highly available is automatically restarted on one of the other hosts to which the virtual machine is pinned. Multi-host pinning can be used to restrict a virtual machine to hosts with, for example, the same hardware configuration.
15.5.3. Removing a Virtual Machine
Copy linkLink copied to clipboard!
Removal of a virtual machine requires a
DELETE request.
Example 15.9. Removing a virtual machine
DELETE /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1
HTTP/1.1 204 No Content
15.5.4. Removing a Virtual Machine but not the Virtual Disk
Copy linkLink copied to clipboard!
Detach the virtual disk prior to removing the virtual machine. This preserves the virtual disk. Removal of a virtual machine requires a
DELETE request.
Example 15.10. Removing a virtual machine
15.6. Sub-Collections
Copy linkLink copied to clipboard!
15.6.1. Disks Sub-Collection
Copy linkLink copied to clipboard!
15.6.1.1. Disks Sub-Collection
Copy linkLink copied to clipboard!
The
disks sub-collection represents all virtual hard disk devices on a virtual machine. A disk representation contains the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="statistics" | relationship | A link to the statistics sub-collection for a virtual machine's disk statistics. |
|
link rel="permissions" | relationship | A link to the permissions sub-collection. |
|
alias | string | The unique identifier for the disk. Use alias instead of name. | |
image_id | string | A reference to the virtual machine image stored on the defined storage domain. | |
storage_domains | complex | The storage domains associated with this disk. Each storage_domain element contains an id attribute with the associated storage domain's GUID. Update this element with POST to perform live migration of a disk from one data storage domain to another. |
[a] |
size | integer | Size of the disk in bytes. Deprecated; replaced by provisioned_size. |
|
provisioned_size | integer | The provisioned size of the disk in bytes. |
|
actual_size | integer | Actual size of the disk in bytes. |
|
status | One of illegal, invalid, locked or ok | The status of the disk device. These states are listed in disk_states under capabilities. |
|
interface | enumerated | The type of interface driver used to connect to the disk device. A list of enumerated values is available in capabilities. | |
format | enumerated | The underlying storage format. A list of enumerated values is available in capabilities. Copy On Write (COW) allows snapshots, with a small performance overhead. Raw does not allow snapshots, but offers improved performance. |
|
sparse | Boolean: true or false | true if the physical storage for the disk should not be preallocated. |
|
bootable | Boolean: true or false | true if this disk is to be marked as bootable. | |
shareable | Boolean: true or false | true to share the disk with multiple virtual machines. | |
wipe_after_delete | Boolean: true or false | true if the underlying physical storage for the disk should be zeroed when the disk is deleted. This increases security but is a more intensive operation and may prolong delete times. | |
propagate_errors | Boolean: true or false | true if disk errors should not cause virtual machine to be paused and, instead, disk errors should be propagated to the guest OS. | |
vm id= | GUID | The ID of the containing virtual machine. |
|
quota id= | GUID | Sets a quota for the disk. | |
lun_storage | complex | A reference to a direct LUN mapping for storage usage. Requires a logical_unit element that contains iSCSI or FCP device details. |
|
active | Boolean | Defines if the disk is connected to the virtual machine. |
|
read_only | Boolean | Defines if the disk is read-only. | |
link rel="disk_profile" | relationship | A link to the disk_profile sub-collection. | |
[a]
This element is only required if the disk is being added to a virtual machine and not created from a virtual machine template.
| |||
Example 15.11. An XML representation of a disk device
Add a new virtual disk. When adding a new internal disk, the
provisioned_size element is required. Use the storage_domains element to specify in which storage domain the disk will be created. Multiple disks for the same virtual machine can reside in different storage domains.
Example 15.12. Creating a new disk device on a virtual machine
Add a new external (direct LUN) disk to a virtual machine. This method requires the
lun_storage element and the logical_unit element, which contains iSCSI or FCP device details.
Example 15.13. Creating a new direct LUN disk device on a virtual machine
The
alias, description, storage_domains, provisioned_size, interface, bootable, shareable, wipe_after_delete and propagate_errors elements are updatable post-creation.
Users can resize virtual disks that are in use by one or more virtual machines, without pausing, hibernating or rebooting the virtual machine(s).
Example 15.14. Updating a virtual disk
Example 15.15. Updating a virtual disk to 20GB
Note
Disk size in the previous example is converted to bytes using the following formula:
20480MB * 1024 2 = 21474836480 bytes
Example 15.16. Renaming a virtual disk
Removal of a virtual disk requires a
DELETE request.
Example 15.17. Removing a virtual disk
DELETE /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1
HTTP/1.1 204 No Content
15.6.1.2. Disk Cloning
Copy linkLink copied to clipboard!
Clone a disk from a template with the
clone element. Set the clone element to true within the disks sub-collection when creating a virtual machine. This clones a disk from the base template and attaches it to the virtual machine.
Example 15.18. Cloning a disk from a template
The following example clones a disk from a template during the creation of a virtual machine.
Important
Search queries for virtual disks based upon disk name require the
alias search parameter instead of name.
15.6.1.3. Disk Statistics Sub-Collection
Copy linkLink copied to clipboard!
Each virtual machine's disk exposes a
statistics sub-collection for disk-specific statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
disk id= | relationship | A relationship to the containing disk resource. |
The following table lists the statistic types for virtual disks.
|
Name
|
Description
|
|---|---|
data.current.read |
The data transfer rate in bytes per second when reading from the disk.
|
data.current.write |
The data transfer rate in bytes per second when writing to the disk.
|
Example 15.19. An XML representation of a virtual machine's statistics sub-collection
Note
This
statistics sub-collection is read-only.
15.6.1.4. Floating Disk Attach and Detach Actions
Copy linkLink copied to clipboard!
Attach a disk from the main
rel="disks" collection using a POST request on the virtual machine's disks sub-collection. Include the id of the disk to attach.
Example 15.20. Attach a floating disk
Detach a disk from a virtual machine's
disks sub-collection using a DELETE request on the disk resource but ensure to include a detach Boolean element so the disk is not destroyed.
Example 15.21. Detach a disk from a virtual machine
15.6.1.5. Disk Activate and Deactivate Actions
Copy linkLink copied to clipboard!
Each virtual machine's disk provides a set of
activate and deactivate actions to add and remove disks from a virtual machine.
Example 15.22. Action to activate a virtual disk
Example 15.23. Action to deactivate a virtual disk
Use these actions to hotplug disks to virtual machines and activate newly attached floating disks.
Important
The hotplugging feature only supports VirtIO disks and virtual machine operating systems that support hotplugging operations. Example operating systems include:
- Red Hat Enterprise Linux 6;
- Red Hat Enterprise Linux 5;
- Windows Server 2008; and,
- Windows Server 2003.
15.6.2. Network Interfaces Sub-Collection
Copy linkLink copied to clipboard!
15.6.2.1. Network Interfaces Sub-Collection
Copy linkLink copied to clipboard!
The
nics sub-collection represents all network interface devices on a virtual machine. A nic representation contains the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="statistics" | relationship | A link to the statistics sub-collection for a virtual machine's network interface statistics. |
|
network id= | GUID | A reference to the network which the interface should be connected. A blank network id is allowed. |
|
interface | enumerated | The type of driver used for the nic. A list of enumerated values is available in capabilities. | |
mac address= | string | The MAC address of the interface. |
|
port_mirroring | complex | Defines whether the NIC receives mirrored traffic. Define a networks element with a series of network id= references. | |
plugged | Boolean | Defines if the NIC is plugged in to the virtual machine. |
|
linked | Boolean | Defines if the NIC is linked to the virtual machine. |
|
Example 15.24. An XML representation of a network interface
When adding a new network interface, the
name and network elements are required. Identify the network element with the id attribute or name element.
Example 15.25. Creating a virtual machine NIC
An API user modifies a network interface with a
PUT request.
Example 15.26. Updating a virtual machine NIC
An API user removes a network interface with a
DELETE request.
Example 15.27. Deleting a virtual machine NIC
DELETE /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/ 7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1
HTTP/1.1 204 No Content
Important
The hotplugging feature only supports virtual machine operating systems with hotplugging operations. Example operating systems include:
- Red Hat Enterprise Linux 6;
- Red Hat Enterprise Linux 5;
- Windows Server 2008; and,
- Windows Server 2003.
15.6.2.2. Network Interface Statistics Sub-Collection
Copy linkLink copied to clipboard!
Each virtual machine's network interface exposes a
statistics sub-collection for network interface statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
nic id= | relationship | A relationship to the containing nic resource. |
The following table lists the statistic types for network interfaces on virtual machines.
|
Name
|
Description
|
|---|---|
data.current.rx |
The rate in bytes per second of data received.
|
data.current.tx |
The rate in bytes per second of data transmitted.
|
errors.total.rx |
Total errors from receiving data.
|
errors.total.tx |
Total errors from transmitting data.
|
Example 15.28. An XML representation of a virtual machine's NIC statistics sub-collection
Note
This
statistics sub-collection is read-only.
15.6.3. Virtual NUMA Nodes Sub-Collection
Copy linkLink copied to clipboard!
The
numanodes sub-collection represents all virtual NUMA nodes on a virtual machine. A vm_numa_node representation contains the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
index | integer | The index number of the virtual NUMA node. |
|
memory | integer | The amount of memory allocated to the virtual NUMA node, in MB. |
|
cpu | complex | The CPU topology associated with this virtual NUMA node. Each core element contains an index attribute with the associated core's index number. |
|
vm id= | GUID | The ID of the containing virtual machine. |
|
numa_node_pins | complex | Pins the virtual NUMA node to a host NUMA node. Each numa_node_pin element contains a pinned="true" boolean and the host NUMA node's index number. |
Example 15.29. An XML representation of a virtual NUMA node
When adding a new virtual NUMA node, the
index, memory, and cpu elements are required.
Example 15.30. Adding a new virtual NUMA node to a virtual machine
Update a virtual NUMA node with a
PUT request. You can use a PUT request to pin a virtual NUMA node to a physical NUMA node on a host.
Example 15.31. Updating a virtual NUMA node
Remove a virtual NUMA node with a
DELETE request.
Example 15.32. Removing a virtual NUMA node
DELETE /ovirt-engine/api/vms/c7ecd2dc-dbd3-4419-956f-1249651c0f2b/numanodes/3290b973-ed3e-4f0b-bbf5-9be10d229e50 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/vms/c7ecd2dc-dbd3-4419-956f-1249651c0f2b/numanodes/3290b973-ed3e-4f0b-bbf5-9be10d229e50 HTTP/1.1
HTTP/1.1 204 No Content15.6.4. CD-ROMs Sub-Collection
Copy linkLink copied to clipboard!
The
cdroms sub-collection represents the CD-ROM device on a virtual machine. A cdrom representation contains the following elements:
| Element | Type | Description | Properties |
|---|---|---|---|
file id= | string/filename | A reference to an ISO image. |
Example 15.33. An XML representation of a CD-ROM device
Send a
PUT request with a file id element to add a new CD-ROM resource.
Example 15.34. Adding a new CD-ROM file
The API changes the CD-ROM using a
PUT request:
Example 15.35. Changing a CD-ROM file
The API changes the CD-ROM for the current session only using a
PUT request with an additional current URI argument:
Example 15.36. Changing a CD-ROM file during a current session
To eject the CD-ROM temporarily, send a
PUT request to the cdroms sub-collection of a virtual machine, adding the current=true matrix parameter:
Example 15.37. Ejecting a CD-ROM file during a current session
Note
Rebooting the virtual machine will connect the CD-ROM again.
To eject the CD-ROM permanently, send a
PUT request to the cdroms sub-collection of a virtual machine:
Example 15.38. Ejecting a CD-ROM file permanently
Note
Virtual machines only contain a single CD-ROM device.
15.6.5. Snapshots Sub-Collection
Copy linkLink copied to clipboard!
15.6.5.1. Snapshots Sub-Collection
Copy linkLink copied to clipboard!
A virtual machine saves and restores disk state as a number of snapshots. These are represented and managed through a
rel="snapshot" sub-collection that behaves similar to other collections.
Each virtual machine snapshot is represented with an individual
snapshot element that contains the following sub-elements:
| Element | Type | Description | Properties |
|---|---|---|---|
vm id= | GUID | The ID and URI of the virtual machine to which this snapshot pertains. |
|
link rel="restore" | relationship | A link to restore the snapshot of the virtual machine. |
|
link rel="prev" | relationship | A link to the previous snapshot of this virtual machine. |
|
type | string | The type of the snapshot. For example, active or regular. |
|
date | xsd:dateTime format: YYYY-MM-DDThh:mm:ss | The date and time at which the snapshot was created. |
|
snapshot_status | string | The current status of the snapshot. |
|
persist_memorystate | Boolean | Defines whether the snapshot also includes the state of the memory of the virtual machine at the time the snapshot was taken. |
|
Note
It is not possible to modify snapshot elements using
PUT.
Example 15.39. An XML representation of a virtual machine snapshot
Use a
GET request for a virtual machine snapshot with the All-Content: true header to include additional OVF data with the representation of the snapshot.
The
Accept header defaults to application/xml if left blank, and the data is represented with HTML entities so as not to interfere with the XML tags. Specifying the Accept: application/json header will return the data in standard XML tagging. This example representation has been formatted from its standard block format to improve legibility.
Example 15.40. XML representation of additional ovf data for a snapshot
You can create a snapshot of a virtual machine that is running (a live snapshot) or shut down by using the
POST method:
Example 15.41. Creating a Virtual Machine Snapshot
Important
Before taking a live snapshot of a virtual machine that uses OpenStack Volume (Cinder) disks, you must freeze and thaw the guest filesystem manually. See Section 15.7.14, “Freeze Virtual Machine Filesystems Action” and Section 15.7.15, “Thaw Virtual Machine Filesystems Action” for more information.
You can restore a virtual machine snapshot using the
rel="restore" action link in the snapshot representation:
Example 15.42. Restoring a Virtual Machine Snapshot
15.6.5.2. Clone a Virtual Machine from a Snapshot
Copy linkLink copied to clipboard!
API provides a function to create virtual machines from a snapshot of a previous machine. API users create a new virtual machine while retaining the original virtual machine with all snapshots intact.
Creation of a virtual machines from a snapshot requires an additional
snapshots element to a standard representation of a virtual machine, which a user sends in a POST request to the vms collection.
The
snapshots element contains a snapshot id= element to define the specific snapshot to use as a basis for the virtual machine.
Example 15.43. Clone Virtual Machine from Snapshot
15.6.6. Statistics Sub-Collection
Copy linkLink copied to clipboard!
Each virtual machine resource exposes a
statistics sub-collection for virtual machine-specific statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
vm id= | relationship | A relationship to the containing vm resource. |
The following table lists the statistic types for virtual machines.
|
Name
|
Description
|
|---|---|
memory.installed |
Total memory in bytes allocated for the virtual machine's use.
|
memory.used |
Current memory in bytes used by the virtual machine.
|
cpu.current.guest |
Percentage of CPU used by the guest.
|
cpu.current.hypervisor |
Percentage of CPU overhead on the hypervisor.
|
cpu.current.total |
Total percentage of the current CPU in use.
|
Example 15.44. An XML representation of a virtual machine's statistics sub-collection
Note
A virtual machine's
statistics sub-collection is read-only.
15.6.7. Displaying Virtual Machine Session Information
Copy linkLink copied to clipboard!
Submit a
GET request for a virtual machine and use the session sub-collection to view the session information for the user that initiated the SPICE console session and the user logged in to the virtual machine.
The
session information of a virtual machine is listed as a sub-collection:
Example 15.45. Displaying the session information of a virtual machine
15.7. Actions
Copy linkLink copied to clipboard!
15.7.1. Start Virtual Machine Action
Copy linkLink copied to clipboard!
The start action launches a stopped, shutdown, or suspended virtual machine.
Example 15.46. Action to start a virtual machine
The start action allows a
vm element to be provided as a parameter. If a vm element is provided, the virtual machine uses the values from the provided element and overrides system settings at start time. Using the start action with the vm element in REST API is equivalent to using the Run Once window in the Administration or User Portal. These settings persist until a user stops the virtual machine. Examples of these elements include os, domain, placement_policy, cdroms, stateless and display type.
Example 15.47. Action to start a virtual machine with overridden parameters
Note
- The
domainelement is used for Windows systems only for overriding parameters on boot with thestartaction. Thedomainelement determines the domain that the Windows virtual machine joins. If the domain does not exist in thedomainscollection, this element requires additionaluserauthentication details, including auser_nameandpassword. If the domain exists in thedomainscollection, the action requires no additionaluserauthentication details. - The CD image and floppy disk file must be available in the ISO domain already. If not, use the ISO uploader tool to upload the files. See The ISO Uploader Tool for more information.
15.7.2. Start Virtual Machine with Cloud-Init Action
Copy linkLink copied to clipboard!
Cloud-Init is a tool for automating the initial setup of virtual machines. You can use the tool to configure the host name, network interfaces, the DNS service, authorized keys, and set user names and passwords. You can also use the
custom_script tag to specify a custom script to run on the virtual machine when it boots.
Note
The
cloud-init element can only be used to start virtual machines with the cloud-init package installed. When the cloud-init element is used, any element within the initialization element but outside the cloud-init element will be ignored.
Example 15.48. Action to start a virtual machine using Cloud-Init
This example shows you how to start a virtual machine using the Cloud-Init tool to set the host name, change the root password, set a static IP for the
eth0 interface, configure DNS, and add an SSH key for the root user.
15.7.3. Stop Virtual Machine Action
Copy linkLink copied to clipboard!
The stop action forces a virtual machine to power-off.
Example 15.49. Action to stop a virtual machine
15.7.4. Shutdown Virtual Machine Action
Copy linkLink copied to clipboard!
The shutdown action sends a shutdown request to a virtual machine.
Example 15.50. Action to send a shutdown request to a virtual machine
15.7.5. Suspend Virtual Machine Action
Copy linkLink copied to clipboard!
The suspend action saves the virtual machine state to disk and stops it. Start a suspended virtual machine and restore the virtual machine state with the start action.
Example 15.51. Action to save virtual machine state and suspend the machine
15.7.6. Reboot Virtual Machine Action
Copy linkLink copied to clipboard!
The reboot action sends a reboot request to a virtual machine.
Example 15.52. Action to send a reboot request to a virtual machine
15.7.7. Enable user logon to access a virtual machine from an external console
Copy linkLink copied to clipboard!
The logon action enables users to access a virtual machine from consoles outside of the Red Hat Virtualization environment.
This action requires the ovirt-guest-agent-gdm-plugin and the ovirt-guest-agent-pam-module packages to be installed and the
ovirt-guest-agent service to be running on the virtual machine.
Users require the appropriate user permissions for the virtual machine in order to access the virtual machine from an external console.
Example 15.53. Logging onto a virtual machine
15.7.8. Detach Virtual Machine from Pool Action
Copy linkLink copied to clipboard!
The detach action detaches a virtual machine from a pool.
Example 15.54. Action to detach a virtual machine
15.7.9. Migrate Virtual Machine Action
Copy linkLink copied to clipboard!
The migrate action migrates a virtual machine to another physical host. The destination
host element is an optional element as Red Hat Virtualization Manager automatically selects a default host for migration. If an API user requires a specific host, the user can specify the host with either an id or name parameter.
Example 15.55. Action to migrate a virtual machine to another host
15.7.10. Cancel Virtual Machine Migration Action
Copy linkLink copied to clipboard!
The cancel migration action stops any migration of a virtual machine to another physical host.
Example 15.56. Action to cancel migration of a virtual machine to another host
15.7.11. Export Virtual Machine Action
Copy linkLink copied to clipboard!
Note
The export storage domain is deprecated. Storage data domains can be unattached from a data center and imported to another data center in the same environment, or in a different environment. Virtual machines, floating virtual disk images, and templates can then be uploaded from the imported storage domain to the attached data center. See the Importing Existing Storage Domains section in the Red Hat Virtualization Administration Guide for information on importing storage domains.
The export action exports a virtual machine to an
export storage domain. A destination storage domain must be specified with a storage_domain reference.
The export action reports a failed action if a virtual machine of the same name exists in the destination domain. Set the
exclusive parameter to true to change this behavior and overwrite any existing virtual machine.
If snapshots of the virtual machine are not included with the exported virtual machine, set the
discard_snapshots parameter to true.
Example 15.57. Action to export a virtual machine to an export storage domain
15.7.12. Virtual Machine Ticket Action
Copy linkLink copied to clipboard!
The ticket action generates a time-sensitive authentication token for accessing a virtual machine's display. The client-provided
action optionally includes a ticket representation containing a value (if the token string needs to take on a particular form) and/or an expiry time in minutes. In any case, the response specifies the actual ticket value and expiry used.
Example 15.58. Action to generate authentication token for a virtual machine
15.7.13. Force Remove Virtual Machine Action
Copy linkLink copied to clipboard!
An API user forces the removal of a faulty virtual machine with the
force action. This action requires a DELETE method. The request body contains an action representation with the force parameter set to true. The request also requires an additional Content-type: application/xml header to process the XML representation in the body.
Example 15.59. Force remove action on a virtual machine
15.7.14. Freeze Virtual Machine Filesystems Action
Copy linkLink copied to clipboard!
The
freezefilesystems action freezes a virtual machine's filesystems using the QEMU guest agent when taking a live snapshot of a running virtual machine. Normally, this is done automatically by the Manager, but this must be executed manually with the REST API for virtual machines using OpenStack Volume (Cinder) disks.
Freezing the filesystems on the guest operating system ensures a consistent snapshot. Once the snapshot is finished, the guest filesystems must then be thawed. On virtual machines not using a OpenStack Volume disk, the freezing and thawing actions can also be invoked manually using the REST API, which can be useful in the case of a failure during the snapshot process.
Example 15.60. Action to freeze a virtual machine's filesystems
For more information on snapshots, see Section 15.6.5.1, “Snapshots Sub-Collection” or the Snapshots section in the Red Hat Virtualization Virtual Machine Management Guide.
15.7.15. Thaw Virtual Machine Filesystems Action
Copy linkLink copied to clipboard!
The
thawfilesystems action thaws a virtual machine's filesystems using the QEMU guest agent when taking a live snapshot of a running virtual machine. Normally, this is done automatically by the Manager, but this must be executed manually with the REST API for virtual machines using OpenStack Volume (Cinder) disks.
Freezing the filesystems on the guest operating system ensures a consistent snapshot. Once the snapshot is finished, the guest filesystems must then be thawed. On virtual machines not using a OpenStack Volume disk, the freezing and thawing actions can also be invoked manually using the REST API, which can be useful in the case of a failure during the snapshot process. For example, if the virtual machine became unresponsive during thaw, you can execute the thaw operation again manually; otherwise the virtual machine may remain unresponsive.
Example 15.61. Action to thaw a virtual machine's filesystems
For more information on snapshots, see Section 15.6.5.1, “Snapshots Sub-Collection” or the Snapshots section in the Red Hat Virtualization Virtual Machine Management Guide.
Chapter 16. Floating Disks
Copy linkLink copied to clipboard!
16.1. Floating Disk Elements
Copy linkLink copied to clipboard!
The
disks collection provides information about all disks in a Red Hat Virtualization environment. A user attaches and detaches disks from any virtual machine and floats them between virtual machines. An API user accesses this information through the rel="disks" link obtained from the entry point URI.
The following table shows specific elements contained in a
disks resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="statistics" | relationship | A link to the statistics sub-collection for a virtual machine's disk statistics. |
|
image_id | GUID | A reference to the virtual machine image stored on the defined storage domain. |
|
storage_domains | Complex | The storage domains associated with this disk. Each storage_domain element contains an id attribute with the associated storage domain's GUID. Update this element with POST to perform live migration of a disk from one data storage domain to another. |
|
size | integer | Size of the disk in bytes. |
|
provisioned_size | integer | The provisioned size of the disk in bytes. |
|
actual_size | integer | Actual size of the disk in bytes. |
|
status | One of illegal, invalid, locked or ok | The status of the disk device. These states are listed in disk_states under capabilities. |
|
interface | enumerated | The type of interface driver used to connect to the disk device. A list of enumerated values is available in capabilities. | |
format | enumerated | The underlying storage format. A list of enumerated values is available in capabilities. Copy On Write (COW) allows snapshots, with a small performance overhead. Raw does not allow snapshots, but offers improved performance. |
|
sparse | Boolean: true or false | true if the physical storage for the disk should not be preallocated. |
|
bootable | Boolean: true or false | true if this disk is to be marked as bootable. | |
shareable | Boolean: true or false | true to share the disk with multiple virtual machines. | |
wipe_after_delete | Boolean: true or false | true if the underlying physical storage for the disk should be zeroed when the disk is deleted. This increases security but is a more intensive operation and may prolong delete times. | |
propagate_errors | Boolean: true or false | true if disk errors should not cause virtual machine to be paused and, instead, disk errors should be propagated to the guest OS. | |
quota id= | GUID | Sets a quota for the disk. | |
lunStorage | complex | A reference to a direct LUN mapping for storage usage. Requires a storage element that contains iSCSI or FCP device details. |
|
active | Boolean | Defines if the disk is connected to the virtual machine. |
|
Important
Search queries for disks based upon name require the
alias search parameter instead of name.
16.2. XML Representation of a Floating Disk
Copy linkLink copied to clipboard!
Example 16.1. An XML representation of a disk device
16.3. Methods
Copy linkLink copied to clipboard!
16.3.1. Creating a Floating Disk
Copy linkLink copied to clipboard!
When creating a new floating disk, the API requires the
size and storage_domains elements.
Example 16.2. Creating a new a floating disk device
16.4. Sub-Collections
Copy linkLink copied to clipboard!
16.4.1. Statistics Sub-Collection
Copy linkLink copied to clipboard!
Each floating disk exposes a
statistics sub-collection for disk-specific statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
disk id= | relationship | A relationship to the containing disk resource. |
The following table lists the statistic types for floating disks.
|
Name
|
Description
|
|---|---|
data.current.read |
The data transfer rate in bytes per second when reading from the disk.
|
data.current.write |
The data transfer rate in bytes per second when writing to the disk.
|
Example 16.3. An XML representation of a virtual machine's statistics sub-collection
Note
This
statistics sub-collection is read-only.
16.5. Actions
Copy linkLink copied to clipboard!
16.5.1. Copying a Floating Disk
Copy linkLink copied to clipboard!
When copying a floating disk, the API requires the
storage_domain element. The optional name element specifies an alias for the disk.
Example 16.4. Copying a Floating Disk
Chapter 17. Templates
Copy linkLink copied to clipboard!
17.1. Virtual Machine Template Elements
Copy linkLink copied to clipboard!
The
templates collection provides information about the virtual machine templates in a Red Hat Virtualization environment. An API user accesses this information through the rel="templates" link obtained from the entry point URI.
Additional information can be retrieved for
GET requests using the All-Content: true header.
The following table shows specific elements contained in a virtual machine template resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="disks" | relationship | A link to the disks sub-collection for virtual machine template resources. |
|
link rel="nics" | relationship | A link to the nics sub-collection for virtual machine template resources. | |
link rel="cdroms" | relationship | A link to the cdroms sub-collection for virtual machine template resources. |
|
link rel="permissions" | relationship | A link to the permissions sub-collection for virtual machine template permissions. | |
type | enumerated | The type of virtual machine the template provides. A list of enumerated values are available in capabilities. | |
status | One of illegal, locked or ok | The template status. These states are listed in template_states under capabilities. |
|
memory | integer | The amount of memory allocated to the guest, in bytes. | |
cpu | complex | The CPU topology (i.e. number of sockets and cores) available to the guest. | |
os type= | string, e.g. RHEL5 or WindowsXP | The guest operating system type. | |
os boot dev= | enumerated | A list of boot devices, described by a dev attribute on a boot element. A list of enumerated values are available in capabilities. | |
os kernel | string | A path to a kernel image which the template is configured to boot from. | |
os initrd | string | A path to an initrd image to be used with the kernel above. | |
os cmdline | string | A kernel command line parameter string to be used with the kernel above. | |
cluster id= | GUID | A reference to the template's host cluster. |
|
vm id= | GUID | A reference to the VM on which this template is based. |
|
domain id= | GUID | A reference to the template's domain. |
|
creation_time | xsd:dateTime format: YYYY-MM-DDThh:mm:ss | The date and time at which this template was created. |
|
origin | One of rhev, ovirt, vmware or xen | The system from which this template originated. |
|
high_availability | complex | Set enabled to true if the VM should be automatically restarted if the host crashes. A priority element controls the order in which VMs are re-started. | |
display | complex | The display type (either vnc or spice), port, and the number of monitors. The allow_reconnect Boolean value specifies if a client can reconnect to the machine via display. | |
stateless | Boolean: true or false | A stateless template contains a snapshot of its disk image taken at boot and deleted at shutdown. This means state changes do not persist after a reboot. | |
usb | complex | Defines the USB policy for a virtual machine template. Requires an enabled element set to a Boolean value and a type element set to either native or legacy.
Important
The Legacy USB option has been deprecated and will be removed in Red Hat Virtualization 4.1.
| |
placement_policy | complex | Sets the placement policy for virtual machine migration. Requires a default host= and an affinity (one of migratable, user_migratable or pinned). Leave the host element empty to set no preferred host. | |
custom_properties | complex | A set of user-defined environment variable passed as parameters to custom scripts. Each custom_property contains name and value attributes. A list of enumerated values are available in capabilities. | |
timezone | tz database format: Area/Location | The the Sysprep timezone setting for a Windows virtual machine template. | |
domain | complex | The the Sysprep domain setting for a Windows virtual machine template. Requires a name from the domains collection. |
17.2. XML Representation of a Virtual Machine Template
Copy linkLink copied to clipboard!
Example 17.1. An XML representation of a virtual machine template
17.3. Methods
Copy linkLink copied to clipboard!
17.3.1. Creating a New Template
Copy linkLink copied to clipboard!
Creation of a new template requires the
name and vm elements. Identify the vm with the id attribute or name element.
Example 17.2. Creating a template from a virtual machine
17.3.2. Creating a New Template Sub Version
Copy linkLink copied to clipboard!
Creation of a new template sub version requires the
name and vm elements for the new template, and the base_template and version_name elements for the new template version. The base_template and version_name elements must be specified within a version section enclosed in the template section. Identify the vm with the id attribute or name element.
Example 17.3. Creating a template sub version from a virtual machine
17.3.3. Updating a Template
Copy linkLink copied to clipboard!
The
name, description, type, memory, cpu topology, os, high_availability, display, stateless, usb and timezone elements can be updated after a template has been created.
Example 17.4. Updating a virtual machine template to contain 1 GB of memory
17.3.4. Updating a Template Sub Version
Copy linkLink copied to clipboard!
Only the
version_name element can be updated after a template sub version has been created.
Example 17.5. Updating a virtual machine template sub version name
17.3.5. Removing a Template
Copy linkLink copied to clipboard!
Removal of a virtual machine template requires a
DELETE request.
Example 17.6. Removing a virtual machine template
DELETE /ovirt-engine/api/templates/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/templates/00000000-0000-0000-0000-000000000000 HTTP/1.1
HTTP/1.1 204 No Content
17.4. Actions
Copy linkLink copied to clipboard!
17.4.1. Export Template Action
Copy linkLink copied to clipboard!
Note
The export storage domain is deprecated. Storage data domains can be unattached from a data center and imported to another data center in the same environment, or in a different environment. Virtual machines, floating virtual disk images, and templates can then be uploaded from the imported storage domain to the attached data center. See the Importing Existing Storage Domains section in the Red Hat Virtualization Administration Guide for information on importing storage domains.
The
templates collection contains an export action.
The export action exports a template to an
Export storage domain. A destination storage domain is specified with a storage_domain reference.
The export action reports a failed action if a virtual machine template of the same name exists in the destination domain. Set the
exclusive parameter to true to change this behavior and overwrite any existing virtual machine template.
Example 17.7. Action to export a template to an export storage domain
Chapter 18. Virtual Machine Pools
Copy linkLink copied to clipboard!
18.1. Virtual Machine Pool Elements
Copy linkLink copied to clipboard!
The
vmpools collection provides information about the virtual machine pools in a Red Hat Virtualization environment. An API user accesses this information through the rel="vmpools" link obtained from the entry point URI.
The following table shows specific elements contained in a virtual machine pool resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | A user-supplied, human readable name for the pool. The name is unique across all pool resources. |
|
description | string | A user-supplied, human readable description of the virtual machine pool. | |
link rel="permissions" | relationship | A link to the permissions sub-collection for virtual machine pool permissions. | |
size | integer | The number of virtual machines in the pool. | |
cluster id= | GUID | A reference to the cluster resource in which virtual machines in this pool run. |
|
template id= | GUID | A reference to the template resource on which virtual machines in this pool are based. |
|
prestarted_vms | integer | The number of prestarted virtual machines in the virtual machine pool. | |
max_user_vms | integer | The maximum number of virtual machines any one user can take from the virtual machine pool. |
Important
The API as documented in this chapter is experimental and subject to change. It is not covered by the backwards compatibility statement.
18.2. XML Representation of a Virtual Machine Pool
Copy linkLink copied to clipboard!
Example 18.1. An XML representation of a virtual machine pool
18.3. Methods
Copy linkLink copied to clipboard!
18.3.1. Creating a New Virtual Machine Pool
Copy linkLink copied to clipboard!
A new pool requires the
name, cluster and template elements. Identify the cluster and template with the id attribute or name element.
Example 18.2. Creating a virtual machine pool
18.3.2. Updating a Virtual Machine Pool
Copy linkLink copied to clipboard!
The
name, description, size, prestarted_vms and max_user_vms can be updated after the virtual machine has been created.
Example 18.3. Updating a virtual machine pool
18.3.3. Removing a Virtual Machine Pool
Copy linkLink copied to clipboard!
Removal of a virtual machine pool requires a
DELETE request.
Example 18.4. Removing a virtual machine
DELETE /ovirt-engine/api/vmpools/2d2d5e26-1b6e-11e1-8cda-001320f76e8e HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/vmpools/2d2d5e26-1b6e-11e1-8cda-001320f76e8e HTTP/1.1
HTTP/1.1 204 No Content
18.4. Actions
Copy linkLink copied to clipboard!
18.4.1. Allocate Virtual Machine Action
Copy linkLink copied to clipboard!
The allocate virtual machine action allocates a virtual machine in the virtual machine pool.
Example 18.5. Action to allocate a virtual machine from a virtual machine pool
POST /ovirt-engine/api/vmpools/2d2d5e26-1b6e-11e1-8cda-001320f76e8e/allocatevm HTTP/1.1 Accept: application/xml Content-type: application/xml <action/>
POST /ovirt-engine/api/vmpools/2d2d5e26-1b6e-11e1-8cda-001320f76e8e/allocatevm HTTP/1.1
Accept: application/xml
Content-type: application/xml
<action/>Chapter 19. Domains
Copy linkLink copied to clipboard!
19.1. Domain Elements
Copy linkLink copied to clipboard!
The API provides the ability to access user and group information from the organization's directory service using the
domains collection. Domain information is referenced with the rel="domains" link.
| Element | Type | Description |
|---|---|---|
name | string | The domain name. |
link rel="users" | relationship | A link to the sub-collection for users associated with this domain. |
link rel="groups" | relationship | A link to the sub-collection for groups associated with this domain. |
The links to
users and groups sub-collections also accept search queries.
Note
The
domains collection and its sub-collections are read-only.
19.2. XML Representation of a Domain Resource
Copy linkLink copied to clipboard!
Example 19.1. An XML representation of a domain resource
19.3. Sub-Collections
Copy linkLink copied to clipboard!
19.3.1. Domain Users Sub-Collection
Copy linkLink copied to clipboard!
The
users sub-collection contains all users in the directory service. This information is used to add new users to the Red Hat Virtualization environment.
| Element | Type | Description |
|---|---|---|
name | string | The name of the user. |
last_name | string | The surname of the user. |
user_name | string | The user name from directory service. |
domain id | GUID | The containing directory service domain. |
groups | complex | A list of directory service groups for this user. |
Example 19.2. An XML representation of a user in the users sub-collection
19.3.2. Domain Groups Sub-Collection
Copy linkLink copied to clipboard!
The
groups sub-collection contains all groups in the directory service. A domain group resource contains a set of elements.
| Element | Type | Description |
|---|---|---|
name | string | The name of the group. |
domain id | GUID | The containing directory service domain. |
Example 19.3. An XML representation of a group in the groups sub-collection
Chapter 20. Groups
Copy linkLink copied to clipboard!
20.1. Imported Group Elements
Copy linkLink copied to clipboard!
The
groups collection contains imported groups from directory services. A group resource contains a set of elements.
| Element | Type | Description |
|---|---|---|
link rel="tags" | relationship | A link to the tags sub-collection for tags attached to this group. |
link rel="permissions" | relationship | A link to the permissions sub-collection for permissions attached to this group. |
link rel="roles" | relationship | A link to the roles sub-collection for roles attached to this group. |
20.2. XML Representation of a Group Resource
Copy linkLink copied to clipboard!
Example 20.1. An XML representation of a group resource
20.3. Adding a Group from a Directory Service
Copy linkLink copied to clipboard!
The API adds existing directory service groups to the Red Hat Virtualization Manager database with a
POST request to the groups collection.
Example 20.2. Adding a group from a directory service
Chapter 21. Roles
Copy linkLink copied to clipboard!
21.1. Role Elements
Copy linkLink copied to clipboard!
The
rel="roles" link obtained from the entry point URI provides access to a static set of system roles. Each individual role element contains the following:
| Element | Type | Description | Properties |
|---|---|---|---|
link="permits" | relationship | A link to the permits sub-collection for role permits. |
|
mutable | Boolean: true or false | Defines the ability to update or delete the role. Roles with mutable set to false are roles built into the Red Hat Virtualization environment. |
|
administrative | Boolean: true or false | Defines the role as administrative-only. |
21.2. XML Representation of the Roles Collection
Copy linkLink copied to clipboard!
Example 21.1. An XML representation of the roles collection
21.3. Methods
Copy linkLink copied to clipboard!
21.3.1. Creating a Role
Copy linkLink copied to clipboard!
Creation of a role requires values for
name, administrative and a list of initial permits.
Example 21.2. Creating a role
21.3.2. Updating a Role
Copy linkLink copied to clipboard!
The
name, description and administrative elements are updatable post-creation.
Example 21.3. Updating a role
21.3.3. Removing a Role
Copy linkLink copied to clipboard!
Removal of a role requires a
DELETE request.
Example 21.4. Removing a role
DELETE /ovirt-engine/api/roles/8de42ad7-f307-408b-80e8-9d28b85adfd7 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/roles/8de42ad7-f307-408b-80e8-9d28b85adfd7 HTTP/1.1
HTTP/1.1 204 No Content
21.4. Roles Permits Sub-Collection
Copy linkLink copied to clipboard!
21.4.1. Roles Permits Sub-Collection
Copy linkLink copied to clipboard!
Each role contains a set of allowable actions, or
permits, which the API lists in capabilities.
A role's
permits are listed as a sub-collection:
Example 21.5. Listing a role's permits
21.4.2. Assign a Permit to a Role
Copy linkLink copied to clipboard!
Assign a
permit to a role with a POST request to the permits sub-collection. Use either an id attribute or a name element to specify the permit to assign.
Example 21.6. Assign a permit to a role
21.4.3. Remove a Permit from a Role
Copy linkLink copied to clipboard!
Remove a
permit from a role with a DELETE request to the permit resource.
Example 21.7. Remove a permit from a role
DELETE /ovirt-engine/api/roles/b67dfbe2-0dbc-41e4-86d3-a2fbef02cfa9/permits/1 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/roles/b67dfbe2-0dbc-41e4-86d3-a2fbef02cfa9/permits/1 HTTP/1.1
HTTP/1.1 204 No Content
Chapter 22. Users
Copy linkLink copied to clipboard!
22.1. User Elements
Copy linkLink copied to clipboard!
Users are exposed in a top-level collection and are referenced with the
rel="users" link. Individual user elements contain the following:
| Element | Type | Description | Properties |
|---|---|---|---|
user_name | string | The user principal name (UPN). The UPN is used as a more convenient identifier when adding a new user. |
|
link rel="tags" | relationship | A link to the tags sub-collection for user resources. | |
link rel="roles" | relationship | A link to the roles sub-collection for user resources. | |
name | string | A free-text name for the user. |
|
domain | string | The containing directory service domain. |
|
groups | complex | A list of directory service groups for this user. |
|
22.2. XML representation of a User Resource
Copy linkLink copied to clipboard!
Example 22.1. An XML representation of a user resource
22.3. Methods
Copy linkLink copied to clipboard!
22.3.1. Adding a User
Copy linkLink copied to clipboard!
The API adds an existing directory service user to the Red Hat Virtualization Manager database with a
POST request to the users collection. The client-provided new user representation includes an embedded roles list with at least one initial role to assign to the user. For example, the following request assigns two initial roles to the user joe@domain.example.com:
Example 22.2. Adding a user from directory service and assigning two roles
The new user is identified either by Red Hat Virtualization Manager user ID or via the directory service user principal name (UPN). The user ID format reported from the directory service domain might be different to the expected Red Hat Virtualization Manager format, such as in LDIF [5] , the ID has the opposite byte order and is base-64 encoded. Hence it is usually more convenient to refer to the new user by UPN.
Note
The user exists in the directory service domain before it is added to the Red Hat Virtualization Manager database. An API user has the option to query this domain through the
domains collection prior to creation of the user.
Roles are identified either by name or ID. The example above shows both approaches.
22.3.2. Adding Roles to a User
Copy linkLink copied to clipboard!
Further roles are attached or detached with
POST or DELETE requests to the roles sub-collection of an individual user. The example below illustrates how the API adds the RHEVMVDIUser role to the role assignments for a particular user.
Note
The embedded user roles list of the
user element is only used for the initial creation. All interactions post-creation with the user's role assignments go through the roles sub-collection.
Example 22.3. Adding roles to a user
Chapter 23. MAC Address Pools
Copy linkLink copied to clipboard!
23.1. MAC Address Pool Elements
Copy linkLink copied to clipboard!
The
macpools collection provides information about the MAC address pools in a Red Hat Virtualization environment. An API user accesses this information through the rel="macpools" link obtained from the entry point URI. The following table shows specific elements contained in a MAC address pool resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | A plain text, human-readable name for the MAC address pool. |
|
description | string | A plain text, human-readable description of the MAC address pool. | |
allow_duplicates | Boolean: true or false | Defines whether duplicate MAC addresses are permitted in the pool. If not specified, allow_duplicates defaults to false. | |
default_pool | Boolean: true or false | Defines whether this is the default pool. If not specified, default_pool defaults to false. |
|
ranges | complex | Defines the range of MAC addresses for the pool. Multiple ranges can be defined within the ranges element. |
|
23.2. XML Representation of the MAC Address Pools Collection
Copy linkLink copied to clipboard!
Example 23.1. An XML representation of the MAC address pools collection
23.3. Methods
Copy linkLink copied to clipboard!
23.3.1. Creating a MAC Address Pool
Copy linkLink copied to clipboard!
Creation of a MAC address pool requires values for
name and ranges.
Example 23.2. Creating a MAC address pool
23.3.2. Updating a MAC Address Pool
Copy linkLink copied to clipboard!
The
name, description, allow_duplicates, and ranges elements are updatable post-creation.
Example 23.3. Updating a MAC address pool
23.3.3. Removing a MAC Address Pool
Copy linkLink copied to clipboard!
Removal of a MAC address pool requires a
DELETE request.
Example 23.4. Removing a MAC address pool
DELETE /ovirt-engine/api/macpools/ab39bbc1-1d64-4737-9b20-ce081f99b0e1 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/macpools/ab39bbc1-1d64-4737-9b20-ce081f99b0e1 HTTP/1.1
HTTP/1.1 204 No Content
Chapter 24. Tags
Copy linkLink copied to clipboard!
24.1. Tag Elements
Copy linkLink copied to clipboard!
The
tags collection provides information about tags in a Red Hat Virtualization environment. An API user accesses this information through the rel="tags" link obtained from the entry point URI.
The following table shows specific elements contained in a tag resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
host | GUID | A reference to the host which the tag is attached. |
|
user | GUID | A reference to the user which the tag is attached. |
|
vm | GUID | A reference to the VM which the tag is attached. |
|
parent | complex | A reference to the VM which the tag is attached. |
24.2. XML Representation of a Tag Resource
Copy linkLink copied to clipboard!
Example 24.1. An XML representation of a tag resource
24.3. Associating Tags
Copy linkLink copied to clipboard!
24.3.1. Associating Tags With a Host, User or VM
Copy linkLink copied to clipboard!
The collection referenced by
link rel="tags" from a host, user or vms represents the set of tags associated with the entity.
These
tag representations also contain a host id, user id or vm id reference to the entity in question.
Associating a tag with an entity is achieved by
POSTing a tag reference (identifying the tag either by its id or name) to the collection.
Example 24.2. Associating a tag with a virtual machine
24.3.2. Removing a Tag
Copy linkLink copied to clipboard!
Removing an association is achieved with a
DELETE request to the appropriate element in the collection.
Example 24.3. Removing a tag from a virtual machine
DELETE /ovirt-engine/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/tags/f436ebfc-67f2-41bd-8ec6-902b6f7dcb5e HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/tags/f436ebfc-67f2-41bd-8ec6-902b6f7dcb5e HTTP/1.1
HTTP/1.1 204 No Content
24.3.3. Querying a Collection for Tagged Resources
Copy linkLink copied to clipboard!
To query the set of entities associated with a given tag, the
collection/search URI template for the appropriate collection should be used to search for entities matching tag=MyTag.
Example 24.4. Querying a collection for tagged resources
24.4. Parent Tags
Copy linkLink copied to clipboard!
24.4.1. Parent Tags
Copy linkLink copied to clipboard!
An API user assigns a
parent element to a tag to create a hierarchical link to a parent tag. The tags are presented as a flat collection, which descends from the root tag, with tag representations containing a link element to a parent tag
Note
The
root tag is a special pseudo-tag assumed as the default parent tag if no parent tag is specified. The root tag cannot be deleted nor assigned a parent tag.
This tag hierarchy is expressed in the following way:
Example 24.5. Tag Hierarchy
In this XML representation, the tags follow this hierarchy:
root (id: -1)
- Finance (id: f436ebfc-67f2-41bd-8ec6-902b6f7dcb5e)
- Billing (id: ac18dabf-23e5-12be-a383-a38b165ca7bd)
root (id: -1)
- Finance (id: f436ebfc-67f2-41bd-8ec6-902b6f7dcb5e)
- Billing (id: ac18dabf-23e5-12be-a383-a38b165ca7bd)
24.4.2. Setting a Parent Tag
Copy linkLink copied to clipboard!
POSTing a new tag with a parent element creates an association with a parent tag, using either the id attribute or the name element to reference the parent tag
Example 24.6. Setting an association with a parent tag with the id attribute
Example 24.7. Setting an association with a parent tag with the name element
24.4.3. Changing a Parent Tag
Copy linkLink copied to clipboard!
A tag changes a parent using a
PUT request:
Example 24.8. Changing the parent tag
Chapter 25. Events
Copy linkLink copied to clipboard!
25.1. Event Elements
Copy linkLink copied to clipboard!
The
rel="events" link obtained from the entry point URI accesses the events collection and lists system events from Red Hat Virtualization Manager.
| Element | Type | Description |
|---|---|---|
description | string | A description of the system event |
code | integer | The integer event code. |
severity | One of normal, warning, error or alert | The level of severity for the event. |
time | xsd:dateTime format: YYYY-MM-DDThh:mm:ss | The timestamp indicating when the event happened. |
correlation_id | string | The identification string for an action that is spread across layers of Red Hat Virtualization. |
user id= | GUID | The identification code for the user who triggered the event. |
origin | string | The source of the event. Standard events are reported by oVirt. |
custom_id | integer | A custom identification number for custom events. Standard events have a custom_id of -1. |
flood_rate | integer | The time, in seconds, during which the same event cannot reoccur in the event list. The default value is 30. |
external_status | complex | The external health status of a host. Contains the state element, which can be one of ok, info, error, warning, or failure. |
25.2. XML Representation of the Events Collection
Copy linkLink copied to clipboard!
Example 25.1. An XML representation of the events collection
25.3. XML Representation of a Virtual Machine Creation Event
Copy linkLink copied to clipboard!
In addition to
user, an event representation also contains a set of XML element relationships to resources relevant to the event.
Example 25.2. An XML representation of a virtual machine creation event
This example representation provides XML element relationships to a virtual machine resource and a storage domain resource.
25.4. Methods
Copy linkLink copied to clipboard!
25.4.1. Searching Events
Copy linkLink copied to clipboard!
The
events collection provides search queries similar to other resource collections. An additional feature when searching the events collection is the ability to search from a certain event. This queries all of events since a specified event.
Querying from an event requires an additional
from parameter added before the search query. This from argument references an event id code.
Example 25.3. Searching from an event
GET /ovirt-engine/api/events;from=1012?search=type%3D30 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/events;from=1012?search=type%3D30 HTTP/1.1
Accept: application/xml
This displays all events with
type set to 30 since id="1012"
Example 25.4. Searching using a specific event severity
GET /ovirt-engine/api/events?search=severity>normal HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/events?search=severity>normal HTTP/1.1
Accept: application/xml
This displays all events with severity higher than
normal. Severity levels include normal, warning, error and alert.
25.4.2. Paginating Events
Copy linkLink copied to clipboard!
A virtualization environment generates a large amount of events after a period of time. However, the API only displays a default number of events for one search query. To display more than the default, the API separates results into pages with the
page command in a search query.
The following search query tells the API to paginate results using a
page value in combination with the sortby clause:
sortby time asc page 1
The
sortby clause defines the base element to order of the results and whether the results are ascending or descending. For search queries of events, set the base element to time and the order to ascending (asc) so the API displays all events from the creation of your virtualization environment.
The
page condition defines the page number. One page equals the default number of events to list. Pagination begins at page 1. To view more pages, increase the page value:
sortby time asc page 2
sortby time asc page 3
sortby time asc page 4
Example 25.5. Paginating events
This example paginates
event resources. The URL-encoded request is:
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%201 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%201 HTTP/1.1
Accept: application/xml
Increase the
page value to view the next page of results.
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%202 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%202 HTTP/1.1
Accept: application/xml
Use an additional
from argument to set the starting id.
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%202&from=30 HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%202&from=30 HTTP/1.1
Accept: application/xml
25.4.3. Adding Events
Copy linkLink copied to clipboard!
The API can add custom events with a
POST request to the events collection. A new event requires the description, severity, origin, and custom_id elements. Custom events can also include flood_rate, user id, and the id codes of any resources relevant to the event. host and storage_domain elements can contain the external_status element to set an external health status.
Example 25.6. Adding a custom event to the event list
25.4.4. Removing Events
Copy linkLink copied to clipboard!
Removal of an event from the event list requires a
DELETE request.
Example 25.7. Removing an event
DELETE /ovirt-engine/api/events/1705 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /ovirt-engine/api/events/1705 HTTP/1.1
HTTP/1.1 204 No ContentAppendix A. API Usage with cURL
Copy linkLink copied to clipboard!
A.1. API Usage with cURL
Copy linkLink copied to clipboard!
This appendix provides instructions on adapting REST requests for use with cURL. cURL is a command line tool for transferring data across various protocols, including HTTP, and supports multiple platforms such as Linux, Windows, Mac and Solaris. Most Linux distributions include cURL as a package.
A.2. Installing cURL
Copy linkLink copied to clipboard!
A Red Hat Enterprise Linux user installs cURL with the following terminal command:
yum install curl
For other platforms, seek installation instructions on the cURL website (http://curl.haxx.se/).
A.3. Using cURL
Copy linkLink copied to clipboard!
cURL uses a command line interface to send requests to a HTTP server. Integrating a request requires the following command syntax:
Usage: curl [options] uri
Usage: curl [options] uri
The
uri refers to target HTTP address to send the request. This is a location on your Red Hat Virtualization Manager host within the API entry point path (/ovirt-engine/api).
cURL options
- -X COMMAND, --request COMMAND
- The request command to use. In the context of the REST API, use
GET,POST,PUTorDELETE.Example:-X GET - -H LINE, --header LINE
- HTTP header to include with the request. Use multiple header options if more than one header is required.Example:
-H "Accept: application/xml" -H "Content-Type: application/xml" - -u USERNAME:PASSWORD, --user USERNAME:PASSWORD
- The user name and password of the Red Hat Virtualization user. This attribute acts as a convenient replacement for the
Authorization:header.Example:-u admin@internal:p@55w0rd! - --cacert CERTIFICATE
- The location of the certificate file for SSL communication to the REST API. The certificate file is saved locally on the client machine. Use the
-kattribute to bypass SSL.Example:--cacert ~/Certificates/rhevm.cer - -d BODY, --data BODY
- The body to send for requests. Use with
POST,PUTandDELETErequests. Ensure to specify theContent-Type: application/xmlheader if a body exists in the request.Example:-d "<cdrom><file id='rhel-server-6.0-x86_64-dvd.iso'/></cdrom>"
A.4. Examples
Copy linkLink copied to clipboard!
A.4.1. GET Request with cURL
Copy linkLink copied to clipboard!
Example A.1. GET request
The following
GET request lists the virtual machines in the vms collection. Note that a GET request does not contain a body.
GET /ovirt-engine/api/vms HTTP/1.1 Accept: application/xml
GET /ovirt-engine/api/vms HTTP/1.1
Accept: application/xml
Adapt the method (
GET), header (Accept: application/xml) and URI (https://[RHEVM-Host]:443/ovirt-engine/api/vms) into the following cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHEVM-Host]:443/ovirt-engine/api/vms
$ curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHEVM-Host]:443/ovirt-engine/api/vms
An XML representation of the
vms collection displays.
A.4.2. POST Request with cURL
Copy linkLink copied to clipboard!
Example A.2. POST request
The following
POST request creates a virtual machine in the vms collection. Note that a POST request requires a body.
Adapt the method (
POST), headers (Accept: application/xml and Content-type: application/xml), URI (https://[RHEVM-Host]:443/ovirt-engine/api/vms) and request body into the following cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<vm><name>vm1</name><cluster><name>default</name></cluster><template><name>Blank</name></template><memory>536870912</memory><os><boot dev='hd'/></os></vm>" https://[RHEVM-Host]:443/ovirt-engine/api/vms
$ curl -X POST -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<vm><name>vm1</name><cluster><name>default</name></cluster><template><name>Blank</name></template><memory>536870912</memory><os><boot dev='hd'/></os></vm>" https://[RHEVM-Host]:443/ovirt-engine/api/vms
The REST API creates a new virtual machine and displays an XML representation of the resource.
A.4.3. PUT Request with cURL
Copy linkLink copied to clipboard!
Example A.3. PUT request
The following
PUT request updates the memory of a virtual machine resource. Note that a PUT request requires a body.
Adapt the method (
PUT), headers (Accept: application/xml and Content-type: application/xml), URI (https://[RHEVM-Host]:443/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399) and request body into the following cURL command:
curl -X PUT -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<vm><memory>1073741824</memory></vm>" https://[RHEVM-Host]:443//ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c039
$ curl -X PUT -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<vm><memory>1073741824</memory></vm>" https://[RHEVM-Host]:443//ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c039
The REST API updates the virtual machine with a new memory configuration.
A.4.4. DELETE Request with cURL
Copy linkLink copied to clipboard!
Example A.4. DELETE request
The following
DELETE request removes a virtual machine resource.
DELETE /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1
DELETE /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1
Adapt the method (
DELETE) and URI (https://[RHEVM-Host]:443/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399) into the following cURL command:
curl -X DELETE -u [USER:PASS] --cacert [CERT] https://[RHEVM-Host]:443//ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c039
$ curl -X DELETE -u [USER:PASS] --cacert [CERT] https://[RHEVM-Host]:443//ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c039
The REST API removes the virtual machine. Note the
Accept: application/xml request header is optional due to the empty result of DELETE requests.
A.4.5. DELETE Request Including Body with cURL
Copy linkLink copied to clipboard!
Example A.5. DELETE request with body
The following
DELETE request force removes a virtual machine resource as indicated with the optional body.
Adapt the method (
DELETE), headers (Accept: application/xml and Content-type: application/xml), URI (https://[RHEVM-Host]:443/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399) and request body into the following cURL command:
curl -X DELETE -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<action><force>true</force></action>" https://[RHEVM-Host]:443//ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c039
$ curl -X DELETE -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<action><force>true</force></action>" https://[RHEVM-Host]:443//ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c039
The REST API force removes the virtual machine.
Appendix B. Enumerated Value Translation
Copy linkLink copied to clipboard!
B.1. Enumerated Value Translation
Copy linkLink copied to clipboard!
The API uses Red Hat Virtualization Query Language to perform search queries. For more information on the Query Language, read the full specification in Performing Searches in Red Hat Virtualization of the Red Hat Virtualization Administration Guide.
Note that certain enumerated values in the API require a different search query when using the Query Language. The following table provides a translation for these key enumerated values.
|
Resource Type
|
API Enumerable Type
|
API Enumerable Value
|
Query Language Property
|
Query Language Value
|
|---|---|---|---|---|
|
Data Centers
| data_center_states | not_operational | status | notoperational |
|
Hosts
| host_states | non_responsive | status | nonresponsive |
install_failed | installfailed | |||
preparing_for_maintenance | preparingformaintenance | |||
non_operational | nonoperational | |||
pending_approval | pendingapproval | |||
|
Virtual Machines
| vm_states | powering_up | status | poweringup |
powering_down | poweringdown | |||
migrating | migratingfrom | |||
migrating | migratingto | |||
not_responding | notresponding | |||
wait_for_launch | waitforlaunch | |||
reboot_in_progress | rebootinprogress | |||
saving_state | savingstate | |||
restoring_state | restoringstate | |||
image_locked | imagelocked |
Appendix C. Event Codes
Copy linkLink copied to clipboard!
C.1. Event Codes
Copy linkLink copied to clipboard!
This table lists all event codes.
| Code | Name | Severity | Message |
|---|---|---|---|
0 | UNASSIGNED | Info | |
1 | VDC_START | Info | Starting oVirt Engine. |
2 | VDC_STOP | Info | Stopping oVirt Engine. |
12 | VDS_FAILURE | Error | Host ${VdsName} is non responsive. |
13 | VDS_DETECTED | Info | Status of host ${VdsName} was set to ${HostStatus}. |
14 | VDS_RECOVER | Info | Host ${VdsName} is rebooting. |
15 | VDS_MAINTENANCE | Normal | Host ${VdsName} was switched to Maintenance Mode. |
16 | VDS_ACTIVATE | Info | Activation of host ${VdsName} initiated by ${UserName}. |
17 | VDS_MAINTENANCE_FAILED | Error | Failed to switch Host ${VdsName} to Maintenance mode. |
18 | VDS_ACTIVATE_FAILED | Error | Failed to activate Host ${VdsName}.(User: ${UserName}). |
19 | VDS_RECOVER_FAILED | Error | Host ${VdsName} failed to recover. |
20 | USER_VDS_START | Info | Host ${VdsName} was started by ${UserName}. |
21 | USER_VDS_STOP | Info | Host ${VdsName} was stopped by ${UserName}. |
22 | IRS_FAILURE | Error | Failed to access Storage on Host ${VdsName}. |
23 | VDS_LOW_DISK_SPACE | Warning | Warning, Low disk space. Host ${VdsName} has less than ${DiskSpace} MB of free space left on: ${Disks}. |
24 | VDS_LOW_DISK_SPACE_ERROR | Error | Critical, Low disk space. Host ${VdsName} has less than ${DiskSpace} MB of free space left on: ${Disks}. Low disk space might cause an issue upgrading this host. |
25 | VDS_NO_SELINUX_ENFORCEMENT | Warning | Host ${VdsName} does not enforce SELinux. Current status: ${Mode} |
26 | IRS_DISK_SPACE_LOW | Warning | Warning, Low disk space. ${StorageDomainName} domain has ${DiskSpace} GB of free space. |
27 | VDS_STATUS_CHANGE_FAILED_DUE_TO_STOP_SPM_FAILURE | Warning | Failed to change status of host ${VdsName} due to a failure to stop the spm. |
28 | VDS_PROVISION | Warning | Installing OS on Host ${VdsName} using Hostgroup ${HostGroupName}. |
29 | USER_ADD_VM_TEMPLATE_SUCCESS | Info | Template ${VmTemplateName} was created successfully. |
31 | USER_VDC_LOGOUT | Info | User ${UserName} logged out. |
32 | USER_RUN_VM | Info | VM ${VmName} started on Host ${VdsName} |
33 | USER_STOP_VM | Info | VM ${VmName} powered off by ${UserName} (Host: ${VdsName})${OptionalReason}. |
34 | USER_ADD_VM | Info | VM ${VmName} was created by ${UserName}. |
35 | USER_UPDATE_VM | Info | VM ${VmName} configuration was updated by ${UserName}. |
36 | USER_ADD_VM_TEMPLATE_FAILURE | Error | Failed creating Template ${VmTemplateName}. |
37 | USER_ADD_VM_STARTED | Info | VM ${VmName} creation was initiated by ${UserName}. |
38 | USER_CHANGE_DISK_VM | Info | CD ${DiskName} was inserted to VM ${VmName} by ${UserName}. |
39 | USER_PAUSE_VM | Info | VM ${VmName} was suspended by ${UserName} (Host: ${VdsName}). |
40 | USER_RESUME_VM | Info | VM ${VmName} was resumed by ${UserName} (Host: ${VdsName}). |
41 | USER_VDS_RESTART | Info | Host ${VdsName} was restarted by ${UserName}. |
42 | USER_ADD_VDS | Info | Host ${VdsName} was added by ${UserName}. |
43 | USER_UPDATE_VDS | Info | Host ${VdsName} configuration was updated by ${UserName}. |
44 | USER_REMOVE_VDS | Info | Host ${VdsName} was removed by ${UserName}. |
45 | USER_CREATE_SNAPSHOT | Info | Snapshot '${SnapshotName}' creation for VM '${VmName}' was initiated by ${UserName}. |
46 | USER_TRY_BACK_TO_SNAPSHOT | Info | Snapshot-Preview ${SnapshotName} for VM ${VmName} was initiated by ${UserName}. |
47 | USER_RESTORE_FROM_SNAPSHOT | Info | VM ${VmName} restored from Snapshot by ${UserName}. |
48 | USER_ADD_VM_TEMPLATE | Info | Creation of Template ${VmTemplateName} from VM ${VmName} was initiated by ${UserName}. |
49 | USER_UPDATE_VM_TEMPLATE | Info | Template ${VmTemplateName} configuration was updated by ${UserName}. |
50 | USER_REMOVE_VM_TEMPLATE | Info | Removal of Template ${VmTemplateName} was initiated by ${UserName}. |
51 | USER_ADD_VM_TEMPLATE_FINISHED_SUCCESS | Info | Creation of Template ${VmTemplateName} from VM ${VmName} has been completed. |
52 | USER_ADD_VM_TEMPLATE_FINISHED_FAILURE | Error | Failed to complete creation of Template ${VmTemplateName} from VM ${VmName}. |
53 | USER_ADD_VM_FINISHED_SUCCESS | Info | VM ${VmName} creation has been completed. |
54 | USER_FAILED_RUN_VM | Error | Failed to run VM ${VmName} (User: ${UserName}). |
55 | USER_FAILED_PAUSE_VM | Error | Failed to suspend VM ${VmName} (Host: ${VdsName}, User: ${UserName}). |
56 | USER_FAILED_STOP_VM | Error | Failed to power off VM ${VmName} (Host: ${VdsName}, User: ${UserName}). |
57 | USER_FAILED_ADD_VM | Error | Failed to create VM ${VmName} (User: ${UserName}). |
58 | USER_FAILED_UPDATE_VM | Error | Failed to update VM ${VmName} (User: ${UserName}). |
59 | USER_FAILED_REMOVE_VM | Error | |
60 | USER_ADD_VM_FINISHED_FAILURE | Error | Failed to complete VM ${VmName} creation. |
61 | VM_DOWN | Info | VM ${VmName} is down. ${ExitMessage} |
62 | VM_MIGRATION_START | Info | Migration started (VM: ${VmName}, Source: ${VdsName}, Destination: ${DestinationVdsName}, User: ${UserName}). ${OptionalReason} |
63 | VM_MIGRATION_DONE | Info | Migration completed (VM: ${VmName}, Source: ${VdsName}, Destination: ${DestinationVdsName}, Duration: ${Duration}, Total: ${TotalDuration}, Actual downtime: ${ActualDowntime}) |
64 | VM_MIGRATION_ABORT | Error | Migration failed: ${MigrationError} (VM: ${VmName}, Source: ${VdsName}). |
65 | VM_MIGRATION_FAILED | Error | Migration failed${DueToMigrationError} (VM: ${VmName}, Source: ${VdsName}). |
66 | VM_FAILURE | Error | VM ${VmName} cannot be found on Host ${VdsName}. |
67 | VM_MIGRATION_START_SYSTEM_INITIATED | Info | Migration initiated by system (VM: ${VmName}, Source: ${VdsName}, Destination: ${DestinationVdsName}, Reason: ${OptionalReason}). |
68 | USER_CREATE_SNAPSHOT_FINISHED_SUCCESS | Info | Snapshot '${SnapshotName}' creation for VM '${VmName}' has been completed. |
69 | USER_CREATE_SNAPSHOT_FINISHED_FAILURE | Error | Failed to complete snapshot '${SnapshotName}' creation for VM '${VmName}'. |
70 | USER_RUN_VM_AS_STATELESS_FINISHED_FAILURE | Error | Failed to complete starting of VM ${VmName}. |
71 | USER_TRY_BACK_TO_SNAPSHOT_FINISH_SUCCESS | Info | Snapshot-Preview ${SnapshotName} for VM ${VmName} has been completed. |
73 | USER_INITIATED_SHUTDOWN_VM | Info | VM shutdown initiated by ${UserName} on VM ${VmName} (Host: ${VdsName})${OptionalReason}. |
74 | USER_FAILED_SHUTDOWN_VM | Error | Failed to initiate shutdown on VM ${VmName} (Host: ${VdsName}, User: ${UserName}). |
76 | USER_STOPPED_VM_INSTEAD_OF_SHUTDOWN | Info | VM ${VmName} was powered off ungracefully by ${UserName} (Host: ${VdsName})${OptionalReason}. |
77 | USER_FAILED_STOPPING_VM_INSTEAD_OF_SHUTDOWN | Error | Failed to power off VM ${VmName} (Host: ${VdsName}, User: ${UserName}). |
78 | USER_ADD_DISK_TO_VM | Info | Add-Disk operation of ${DiskAlias} was initiated on VM ${VmName} by ${UserName}. |
79 | USER_FAILED_ADD_DISK_TO_VM | Error | Add-Disk operation failed on VM ${VmName} (User: ${UserName}). |
80 | USER_REMOVE_DISK_FROM_VM | Info | Disk was removed from VM ${VmName} by ${UserName}. |
81 | USER_FAILED_REMOVE_DISK_FROM_VM | Error | Failed to remove Disk from VM ${VmName} (User: ${UserName}). |
88 | USER_UPDATE_VM_DISK | Info | VM ${VmName} ${DiskAlias} disk was updated by ${UserName}. |
89 | USER_FAILED_UPDATE_VM_DISK | Error | Failed to update VM ${VmName} disk ${DiskAlias} (User: ${UserName}). |
90 | VDS_FAILED_TO_GET_HOST_HARDWARE_INFO | Warning | Could not get hardware information for host ${VdsName} |
97 | USER_ADD_DISK_TO_VM_FINISHED_SUCCESS | Info | The disk ${DiskAlias} was successfully added to VM ${VmName}. |
98 | USER_ADD_DISK_TO_VM_FINISHED_FAILURE | Error | Add-Disk operation failed to complete on VM ${VmName}. |
99 | USER_TRY_BACK_TO_SNAPSHOT_FINISH_FAILURE | Error | Failed to complete Snapshot-Preview ${SnapshotName} for VM ${VmName}. |
100 | USER_RESTORE_FROM_SNAPSHOT_FINISH_SUCCESS | Info | VM ${VmName} restoring from Snapshot has been completed. |
101 | USER_RESTORE_FROM_SNAPSHOT_FINISH_FAILURE | Error | Failed to complete restoring from Snapshot of VM ${VmName}. |
102 | USER_FAILED_CHANGE_DISK_VM | Error | Failed to change disk in VM ${VmName} (Host: ${VdsName}, User: ${UserName}). |
103 | USER_FAILED_RESUME_VM | Error | Failed to resume VM ${VmName} (Host: ${VdsName}, User: ${UserName}). |
104 | USER_FAILED_ADD_VDS | Error | Failed to add Host ${VdsName} (User: ${UserName}). |
105 | USER_FAILED_UPDATE_VDS | Error | Failed to update Host ${VdsName} (User: ${UserName}). |
106 | USER_FAILED_REMOVE_VDS | Error | Failed to remove Host ${VdsName} (User: ${UserName}). |
107 | USER_FAILED_VDS_RESTART | Error | Failed to restart Host ${VdsName}, (User: ${UserName}). |
108 | USER_FAILED_ADD_VM_TEMPLATE | Error | Failed to initiate creation of Template ${VmTemplateName} from VM ${VmName} (User: ${UserName}). |
109 | USER_FAILED_UPDATE_VM_TEMPLATE | Error | Failed to update Template ${VmTemplateName} (User: ${UserName}). |
110 | USER_FAILED_REMOVE_VM_TEMPLATE | Error | Failed to initiate removal of Template ${VmTemplateName} (User: ${UserName}). |
111 | USER_STOP_SUSPENDED_VM | Info | Suspended VM ${VmName} has had its save state cleared by ${UserName}${OptionalReason}. |
112 | USER_STOP_SUSPENDED_VM_FAILED | Error | Failed to power off suspended VM ${VmName} (User: ${UserName}). |
113 | USER_REMOVE_VM_FINISHED | Info | VM ${VmName} was successfully removed. |
114 | USER_VDC_LOGIN_FAILED | Error | User ${UserName} failed to log in. |
115 | USER_FAILED_TRY_BACK_TO_SNAPSHOT | Error | Failed to preview Snapshot ${SnapshotName} for VM ${VmName} (User: ${UserName}). |
116 | USER_FAILED_RESTORE_FROM_SNAPSHOT | Error | Failed to restore VM ${VmName} from Snapshot (User: ${UserName}). |
117 | USER_FAILED_CREATE_SNAPSHOT | Error | Failed to create Snapshot ${SnapshotName} for VM ${VmName} (User: ${UserName}). |
118 | USER_FAILED_VDS_START | Error | Failed to start Host ${VdsName}, (User: ${UserName}). |
119 | VM_DOWN_ERROR | Error | VM ${VmName} is down with error. ${ExitMessage}. |
120 | VM_MIGRATION_TO_SERVER_FAILED | Error | Migration failed${DueToMigrationError} (VM: ${VmName}, Source: ${VdsName}, Destination: ${DestinationVdsName}). |
121 | SYSTEM_VDS_RESTART | Info | Host ${VdsName} was restarted by the engine. |
122 | SYSTEM_FAILED_VDS_RESTART | Error | A restart initiated by the engine to Host ${VdsName} has failed. |
123 | VDS_SLOW_STORAGE_RESPONSE_TIME | Warning | Slow storage response time on Host ${VdsName}. |
124 | VM_IMPORT | Info | Started VM import of ${ImportedVmName} (User: ${UserName}) |
125 | VM_IMPORT_FAILED | Error | Failed to import VM ${ImportedVmName} (User: ${UserName}) |
126 | VM_NOT_RESPONDING | Warning | VM ${VmName} is not responding. |
127 | VDS_RUN_IN_NO_KVM_MODE | Error | Host ${VdsName} running without virtualization hardware acceleration |
128 | VM_MIGRATION_TRYING_RERUN | Warning | Failed to migrate VM ${VmName} to Host ${DestinationVdsName}${DueToMigrationError}. Trying to migrate to another Host. |
129 | VM_CLEARED | Info | Unused |
130 | USER_SUSPEND_VM_FINISH_FAILURE_WILL_TRY_AGAIN | Error | Failed to complete suspending of VM ${VmName}, will try again. |
131 | USER_EXPORT_VM | Info | VM ${VmName} exported to ${ExportPath} by ${UserName} |
132 | USER_EXPORT_VM_FAILED | Error | Failed to export VM ${VmName} to ${ExportPath} (User: ${UserName}) |
133 | USER_EXPORT_TEMPLATE | Info | Template ${VmTemplateName} exported to ${ExportPath} by ${UserName} |
134 | USER_EXPORT_TEMPLATE_FAILED | Error | Failed to export Template ${VmTemplateName} to ${ExportPath} (User: ${UserName}) |
135 | TEMPLATE_IMPORT | Info | Started Template import of ${ImportedVmTemplateName} (User: ${UserName}) |
136 | TEMPLATE_IMPORT_FAILED | Error | Failed to import Template ${ImportedVmTemplateName} (User: ${UserName}) |
137 | USER_FAILED_VDS_STOP | Error | Failed to stop Host ${VdsName}, (User: ${UserName}). |
138 | VM_PAUSED_ENOSPC | Error | VM ${VmName} has been paused due to no Storage space error. |
139 | VM_PAUSED_ERROR | Error | VM ${VmName} has been paused due to unknown storage error. |
140 | VM_MIGRATION_FAILED_DURING_MOVE_TO_MAINTENANCE | Error | Migration failed${DueToMigrationError} while Host is in 'preparing for maintenance' state.\n Consider manual intervention\: stopping/migrating Vms as Host's state will not\n turn to maintenance while VMs are still running on it.(VM: ${VmName}, Source: ${VdsName}, Destination: ${DestinationVdsName}). |
141 | VDS_VERSION_NOT_SUPPORTED_FOR_CLUSTER | Error | Host ${VdsName} is installed with VDSM version (${VdsSupportedVersions}) and cannot join cluster ${ClusterName} which is compatible with VDSM versions ${CompatibilityVersion}. |
142 | VM_SET_TO_UNKNOWN_STATUS | Warning | VM ${VmName} was set to the Unknown status. |
143 | VM_WAS_SET_DOWN_DUE_TO_HOST_REBOOT_OR_MANUAL_FENCE | Info | Vm ${VmName} was shut down due to ${VdsName} host reboot or manual fence |
144 | VM_IMPORT_INFO | Info | Value of field ${FieldName} of imported VM ${VmName} is ${FieldValue}. The field is reset to the default value |
145 | VM_PAUSED_EIO | Error | VM ${VmName} has been paused due to storage I/O problem. |
146 | VM_PAUSED_EPERM | Error | VM ${VmName} has been paused due to storage permissions problem. |
147 | VM_POWER_DOWN_FAILED | Warning | Shutdown of VM ${VmName} failed. |
148 | VM_MEMORY_UNDER_GUARANTEED_VALUE | Error | VM ${VmName} on host ${VdsName} was guaranteed ${MemGuaranteed} MB but currently has ${MemActual} MB |
149 | USER_ADD | Info | User '${NewUserName}' was added successfully to the system. |
150 | USER_INITIATED_RUN_VM | Info | Starting VM ${VmName} was initiated by ${UserName}. |
151 | USER_INITIATED_RUN_VM_FAILED | Warning | Failed to run VM ${VmName} on Host ${VdsName}. |
152 | USER_RUN_VM_ON_NON_DEFAULT_VDS | Warning | Guest ${VmName} started on Host ${VdsName}. (Default Host parameter was ignored - assigned Host was not available). |
153 | USER_STARTED_VM | Info | VM ${VmName} was started by ${UserName} (Host: ${VdsName}). |
154 | VDS_CLUSTER_VERSION_NOT_SUPPORTED | Error | Host ${VdsName} is compatible with versions (${VdsSupportedVersions}) and cannot join Cluster ${ClusterName} which is set to version ${CompatibilityVersion}. |
155 | VDS_ARCHITECTURE_NOT_SUPPORTED_FOR_CLUSTER | Error | Host ${VdsName} has architecture ${VdsArchitecture} and cannot join Cluster ${ClusterName} which has architecture ${ClusterArchitecture}. |
156 | CPU_TYPE_UNSUPPORTED_IN_THIS_CLUSTER_VERSION | Error | Host ${VdsName} moved to Non-Operational state as host CPU type is not supported in this cluster compatibility version or is not supported at all |
157 | USER_REBOOT_VM | Info | User ${UserName} initiated reboot of VM ${VmName}. |
158 | USER_FAILED_REBOOT_VM | Error | Failed to reboot VM ${VmName} (User: ${UserName}). |
159 | USER_FORCE_SELECTED_SPM | Info | Host ${VdsName} was force selected by ${UserName} |
160 | USER_ACCOUNT_DISABLED_OR_LOCKED | Error | User ${UserName} cannot login, as it got disabled or locked. Please contact the system administrator. |
161 | VM_CANCEL_MIGRATION | Info | Migration cancelled (VM: ${VmName}, Source: ${VdsName}, User: ${UserName}). |
162 | VM_CANCEL_MIGRATION_FAILED | Error | Failed to cancel migration for VM: ${VmName} |
163 | VM_STATUS_RESTORED | Info | VM ${VmName} status was restored to ${VmStatus}. |
164 | VM_SET_TICKET | Info | User ${UserName} initiated console session for VM ${VmName} |
165 | VM_SET_TICKET_FAILED | Error | User ${UserName} failed to initiate a console session for VM ${VmName} |
166 | VM_MIGRATION_NO_VDS_TO_MIGRATE_TO | Warning | No available host was found to migrate VM ${VmName} to. |
167 | VM_CONSOLE_CONNECTED | Info | User ${UserName} is connected to VM ${VmName}. |
168 | VM_CONSOLE_DISCONNECTED | Info | User ${UserName} got disconnected from VM ${VmName}. |
169 | VM_FAILED_TO_PRESTART_IN_POOL | Warning | Cannot pre-start VM in pool '${VmPoolName}'. The system will continue trying. |
170 | USER_CREATE_LIVE_SNAPSHOT_FINISHED_FAILURE | Warning | Failed to create live snapshot '${SnapshotName}' for VM '${VmName}'. VM restart is recommended. Note that using the created snapshot might cause data inconsistency. |
171 | USER_RUN_VM_AS_STATELESS_WITH_DISKS_NOT_ALLOWING_SNAPSHOT | Warning | VM ${VmName} was run as stateless with one or more of disks that do not allow snapshots (User:${UserName}). |
172 | USER_REMOVE_VM_FINISHED_WITH_ILLEGAL_DISKS | Warning | VM ${VmName} has been removed, but the following disks could not be removed: ${DisksNames}. These disks will appear in the main disks tab in illegal state, please remove manually when possible. |
173 | USER_CREATE_LIVE_SNAPSHOT_NO_MEMORY_FAILURE | Error | Failed to save memory as part of Snapshot ${SnapshotName} for VM ${VmName} (User: ${UserName}). |
174 | VM_IMPORT_FROM_CONFIGURATION_EXECUTED_SUCCESSFULLY | Info | VM ${VmName} has been successfully imported from the given configuration. |
175 | VM_IMPORT_FROM_CONFIGURATION_ATTACH_DISKS_FAILED | Warning | VM ${VmName} has been imported from the given configuration but the following disk(s) failed to attach: ${DiskAliases}. |
176 | VM_BALLOON_DRIVER_ERROR | Error | The Balloon driver on VM ${VmName} on host ${VdsName} is requested but unavailable. |
177 | VM_BALLOON_DRIVER_UNCONTROLLED | Error | The Balloon device on VM ${VmName} on host ${VdsName} is inflated but the device cannot be controlled (guest agent is down). |
178 | VM_MEMORY_NOT_IN_RECOMMENDED_RANGE | Warning | VM ${VmName} was configured with ${VmMemInMb}mb of memory while the recommended value range is ${VmMinMemInMb}mb - ${VmMaxMemInMb}mb |
179 | USER_INITIATED_RUN_VM_AND_PAUSE | Info | Starting in paused mode VM ${VmName} was initiated by ${UserName}. |
180 | TEMPLATE_IMPORT_FROM_CONFIGURATION_SUCCESS | Info | Template ${VmTemplateName} has been successfully imported from the given configuration. |
181 | TEMPLATE_IMPORT_FROM_CONFIGURATION_FAILED | Error | Failed to import Template ${VmTemplateName} from the given configuration. |
182 | USER_FAILED_ATTACH_USER_TO_VM | Error | Failed to attach User ${AdUserName} to VM ${VmName} (User: ${UserName}). |
183 | USER_ATTACH_TAG_TO_TEMPLATE | Info | Tag ${TagName} was attached to Templates(s) ${TemplatesNames} by ${UserName}. |
184 | USER_ATTACH_TAG_TO_TEMPLATE_FAILED | Error | Failed to attach Tag ${TagName} to Templates(s) ${TemplatesNames} (User: ${UserName}). |
185 | USER_DETACH_TEMPLATE_FROM_TAG | Info | Tag ${TagName} was detached from Template(s) ${TemplatesNames} by ${UserName}. |
186 | USER_DETACH_TEMPLATE_FROM_TAG_FAILED | Error | Failed to detach Tag ${TagName} from TEMPLATE(s) ${TemplatesNames} (User: ${UserName}). |
187 | VDS_STORAGE_CONNECTION_FAILED_BUT_LAST_VDS | Error | Failed to connect Host ${VdsName} to Data Center, due to connectivity errors with the Storage. Host ${VdsName} will remain in Up state (but inactive), as it is the last Host in the Data Center, to enable manual intervention by the Administrator. |
188 | VDS_STORAGES_CONNECTION_FAILED | Error | Failed to connect Host ${VdsName} to the Storage Domains ${failedStorageDomains}. |
189 | VDS_STORAGE_VDS_STATS_FAILED | Error | Host ${VdsName} reports about one of the Active Storage Domains as Problematic. |
190 | UPDATE_OVF_FOR_STORAGE_DOMAIN_FAILED | Warning | Failed to update VMs/Templates OVF data for Storage Domain ${StorageDomainName} in Data Center ${StoragePoolName}. |
191 | CREATE_OVF_STORE_FOR_STORAGE_DOMAIN_FAILED | Warning | Failed to create OVF store disk for Storage Domain ${StorageDomainName}.\n The Disk with the id ${DiskId} might be removed manually for automatic attempt to create new one. \n OVF updates won't be attempted on the created disk. |
192 | CREATE_OVF_STORE_FOR_STORAGE_DOMAIN_INITIATE_FAILED | Warning | Failed to create OVF store disk for Storage Domain ${StorageDomainName}. \n OVF data won't be updated meanwhile for that domain. |
193 | DELETE_OVF_STORE_FOR_STORAGE_DOMAIN_FAILED | Warning | Failed to delete the OVF store disk for Storage Domain ${StorageDomainName}.\n In order to detach the domain please remove it manually or try to detach the domain again for another attempt. |
194 | VM_CANCEL_CONVERSION | Info | Conversion cancelled (VM: ${VmName}, Source: ${VdsName}, User: ${UserName}). |
195 | VM_CANCEL_CONVERSION_FAILED | Error | Failed to cancel conversion for VM: ${VmName} |
196 | VM_RECOVERED_FROM_PAUSE_ERROR | Normal | VM ${VmName} has recovered from paused back to up. |
197 | SYSTEM_SSH_HOST_RESTART | Info | Host ${VdsName} was restarted using SSH by the engine. |
198 | SYSTEM_FAILED_SSH_HOST_RESTART | Error | A restart using SSH initiated by the engine to Host ${VdsName} has failed. |
199 | USER_UPDATE_OVF_STORE | Info | OVF_STORE for domain ${StorageDomainName} was updated by ${UserName}. |
200 | IMPORTEXPORT_GET_VMS_INFO_FAILED | Error | Failed to retrieve VM/Templates information from export domain ${StorageDomainName} |
201 | IRS_DISK_SPACE_LOW_ERROR | Error | Critical, Low disk space. ${StorageDomainName} domain has ${DiskSpace} GB of free space. |
202 | IMPORTEXPORT_GET_EXTERNAL_VMS_INFO_FAILED | Error | Failed to retrieve VMs information from external server ${URL} |
204 | IRS_HOSTED_ON_VDS | Info | Storage Pool Manager runs on Host ${VdsName} (Address: ${ServerIp}). |
205 | PROVIDER_ADDED | Info | Provider ${ProviderName} was added. (User: ${UserName}) |
206 | PROVIDER_ADDITION_FAILED | Error | Failed to add provider ${ProviderName}. (User: ${UserName}) |
207 | PROVIDER_UPDATED | Info | Provider ${ProviderName} was updated. (User: ${UserName}) |
208 | PROVIDER_UPDATE_FAILED | Error | Failed to update provider ${ProviderName}. (User: ${UserName}) |
209 | PROVIDER_REMOVED | Info | Provider ${ProviderName} was removed. (User: ${UserName}) |
210 | PROVIDER_REMOVAL_FAILED | Error | Failed to remove provider ${ProviderName}. (User: ${UserName}) |
213 | PROVIDER_CERTIFICATE_IMPORTED | Info | Certificate for provider ${ProviderName} was imported. (User: ${UserName}) |
214 | PROVIDER_CERTIFICATE_IMPORT_FAILED | Error | Failed importing Certificate for provider ${ProviderName}. (User: ${UserName}) |
250 | USER_UPDATE_VM_CLUSTER_DEFAULT_HOST_CLEARED | Info | ${VmName} cluster was updated by ${UserName}, Default host was reset to auto assign. |
251 | USER_REMOVE_VM_TEMPLATE_FINISHED | Info | Removal of Template ${VmTemplateName} has been completed. |
252 | SYSTEM_FAILED_UPDATE_VM | Error | Failed to Update VM ${VmName} that was initiated by system. |
253 | SYSTEM_UPDATE_VM | Info | VM ${VmName} configuration was updated by system. |
254 | VM_ALREADY_IN_REQUESTED_STATUS | Info | VM ${VmName} is already ${VmStatus}, ${Action} was skipped. User: ${UserName}. |
302 | USER_ADD_VM_POOL_WITH_VMS | Info | VM Pool ${VmPoolName} (containing ${VmsCount} VMs) was created by ${UserName}. |
303 | USER_ADD_VM_POOL_WITH_VMS_FAILED | Error | Failed to create VM Pool ${VmPoolName} (User: ${UserName}). |
304 | USER_REMOVE_VM_POOL | Info | VM Pool ${VmPoolName} was removed by ${UserName}. |
305 | USER_REMOVE_VM_POOL_FAILED | Error | Failed to remove VM Pool ${VmPoolName} (User: ${UserName}). |
306 | USER_ADD_VM_TO_POOL | Info | VM ${VmName} was added to VM Pool ${VmPoolName} by ${UserName}. |
307 | USER_ADD_VM_TO_POOL_FAILED | Error | Failed to add VM ${VmName} to VM Pool ${VmPoolName}(User: ${UserName}). |
308 | USER_REMOVE_VM_FROM_POOL | Info | VM ${VmName} was removed from VM Pool ${VmPoolName} by ${UserName}. |
309 | USER_REMOVE_VM_FROM_POOL_FAILED | Error | Failed to remove VM ${VmName} from VM Pool ${VmPoolName} (User: ${UserName}). |
310 | USER_ATTACH_USER_TO_POOL | Info | User ${AdUserName} was attached to VM Pool ${VmPoolName} by ${UserName}. |
311 | USER_ATTACH_USER_TO_POOL_FAILED | Error | Failed to attach User ${AdUserName} to VM Pool ${VmPoolName} (User: ${UserName}). |
312 | USER_DETACH_USER_FROM_POOL | Info | User ${AdUserName} was detached from VM Pool ${VmPoolName} by ${UserName}. |
313 | USER_DETACH_USER_FROM_POOL_FAILED | Error | Failed to detach User ${AdUserName} from VM Pool ${VmPoolName} (User: ${UserName}). |
314 | USER_UPDATE_VM_POOL | Info | VM Pool ${VmPoolName} configuration was updated by ${UserName}. |
315 | USER_UPDATE_VM_POOL_FAILED | Error | Failed to update VM Pool ${VmPoolName} configuration (User: ${UserName}). |
316 | USER_ATTACH_USER_TO_VM_FROM_POOL | Info | Attaching User ${AdUserName} to VM ${VmName} in VM Pool ${VmPoolName} was initiated by ${UserName}. |
317 | USER_ATTACH_USER_TO_VM_FROM_POOL_FAILED | Error | Failed to attach User ${AdUserName} to VM from VM Pool ${VmPoolName} (User: ${UserName}). |
318 | USER_ATTACH_USER_TO_VM_FROM_POOL_FINISHED_SUCCESS | Info | User ${AdUserName} successfully attached to VM ${VmName} in VM Pool ${VmPoolName}. |
319 | USER_ATTACH_USER_TO_VM_FROM_POOL_FINISHED_FAILURE | Error | Failed to attach user ${AdUserName} to VM ${VmName} in VM Pool ${VmPoolName}. |
320 | USER_ADD_VM_POOL_WITH_VMS_ADD_VDS_FAILED | Error | Pool ${VmPoolName} Created, but some Vms failed to create (User: ${UserName}). |
321 | USER_REMOVE_VM_POOL_INITIATED | Info | VM Pool ${VmPoolName} removal was initiated by ${UserName}. |
325 | USER_REMOVE_ADUSER | Info | User ${AdUserName} was removed by ${UserName}. |
326 | USER_FAILED_REMOVE_ADUSER | Error | Failed to remove User ${AdUserName} (User: ${UserName}). |
327 | USER_FAILED_ADD_ADUSER | Warning | Failed to add User '${NewUserName}' to the system. |
342 | USER_REMOVE_SNAPSHOT | Info | Snapshot '${SnapshotName}' deletion for VM '${VmName}' was initiated by ${UserName}. |
343 | USER_FAILED_REMOVE_SNAPSHOT | Error | Failed to remove Snapshot ${SnapshotName} for VM ${VmName} (User: ${UserName}). |
344 | USER_UPDATE_VM_POOL_WITH_VMS | Info | VM Pool ${VmPoolName} was updated by ${UserName}, ${VmsCount} VMs were added. |
345 | USER_UPDATE_VM_POOL_WITH_VMS_FAILED | Error | Failed to update VM Pool ${VmPoolName}(User: ${UserName}). |
346 | USER_PASSWORD_CHANGED | Info | Password changed successfully for ${UserName} |
347 | USER_PASSWORD_CHANGE_FAILED | Error | Failed to change password. (User: ${UserName}) |
348 | USER_CLEAR_UNKNOWN_VMS | Info | All VMs' status on Non Responsive Host ${VdsName} were changed to 'Down' by ${UserName} |
349 | USER_FAILED_CLEAR_UNKNOWN_VMS | Error | Failed to clear VMs' status on Non Responsive Host ${VdsName}. (User: ${UserName}). |
350 | USER_ADD_BOOKMARK | Info | Bookmark ${BookmarkName} was added by ${UserName}. |
351 | USER_ADD_BOOKMARK_FAILED | Error | Failed to add bookmark: ${BookmarkName} (User: ${UserName}). |
352 | USER_UPDATE_BOOKMARK | Info | Bookmark ${BookmarkName} was updated by ${UserName}. |
353 | USER_UPDATE_BOOKMARK_FAILED | Error | Failed to update bookmark: ${BookmarkName} (User: ${UserName}) |
354 | USER_REMOVE_BOOKMARK | Info | Bookmark ${BookmarkName} was removed by ${UserName}. |
355 | USER_REMOVE_BOOKMARK_FAILED | Error | Failed to remove bookmark ${BookmarkName} (User: ${UserName}) |
356 | USER_REMOVE_SNAPSHOT_FINISHED_SUCCESS | Info | Snapshot '${SnapshotName}' deletion for VM '${VmName}' has been completed. |
357 | USER_REMOVE_SNAPSHOT_FINISHED_FAILURE | Error | Failed to delete snapshot '${SnapshotName}' for VM '${VmName}'. |
358 | USER_VM_POOL_MAX_SUBSEQUENT_FAILURES_REACHED | Warning | Not all VMs where successfully created in VM Pool ${VmPoolName}. |
359 | USER_REMOVE_SNAPSHOT_FINISHED_FAILURE_PARTIAL_SNAPSHOT | Warning | Due to partial snapshot removal, Snapshot '${SnapshotName}' of VM '${VmName}' now contains only the following disks: '${DiskAliases}'. |
360 | USER_DETACH_USER_FROM_VM | Info | User ${AdUserName} was detached from VM ${VmName} by ${UserName}. |
361 | USER_FAILED_DETACH_USER_FROM_VM | Error | Failed to detach User ${AdUserName} from VM ${VmName} (User: ${UserName}). |
362 | USER_REMOVE_SNAPSHOT_FINISHED_FAILURE_BASE_IMAGE_NOT_FOUND | Error | Failed to merge images of snapshot '${SnapshotName}': base volume '${BaseVolumeId}' is missing. This may have been caused by a failed attempt to remove the parent snapshot; if this is the case, please retry deletion of the parent snapshot before deleting this one. |
370 | USER_EXTEND_DISK_SIZE_FAILURE | Error | Failed to extend size of the disk '${DiskAlias}' to ${NewSize} GB, User: ${UserName}. |
371 | USER_EXTEND_DISK_SIZE_SUCCESS | Info | Size of the disk '${DiskAlias}' was successfully updated to ${NewSize} GB by ${UserName}. |
372 | USER_EXTEND_DISK_SIZE_UPDATE_VM_FAILURE | Warning | Failed to update VM '${VmName}' with the new volume size. VM restart is recommended. |
373 | USER_REMOVE_DISK_SNAPSHOT | Info | Disk '${DiskAlias}' from Snapshot(s) '${Snapshots}' of VM '${VmName}' deletion was initiated by ${UserName}. |
374 | USER_FAILED_REMOVE_DISK_SNAPSHOT | Error | Failed to delete Disk '${DiskAlias}' from Snapshot(s) ${Snapshots} of VM ${VmName} (User: ${UserName}). |
375 | USER_REMOVE_DISK_SNAPSHOT_FINISHED_SUCCESS | Info | Disk '${DiskAlias}' from Snapshot(s) '${Snapshots}' of VM '${VmName}' deletion has been completed (User: ${UserName}). |
376 | USER_REMOVE_DISK_SNAPSHOT_FINISHED_FAILURE | Error | Failed to complete deletion of Disk '${DiskAlias}' from snapshot(s) '${Snapshots}' of VM '${VmName}' (User: ${UserName}). |
377 | USER_EXTENDED_DISK_SIZE | Info | Extending disk '${DiskAlias}' to ${NewSize} GB was initiated by ${UserName}. |
378 | USER_REGISTER_DISK_FINISHED_SUCCESS | Info | Disk '${DiskAlias}' has been successfully registered as a floating disk. |
379 | USER_REGISTER_DISK_FINISHED_FAILURE | Error | Failed to register Disk '${DiskAlias}'. |
380 | USER_EXTEND_DISK_SIZE_UPDATE_HOST_FAILURE | Warning | Failed to refresh volume size on host '${VdsName}'. Please try the operation again. |
381 | USER_REGISTER_DISK_INITIATED | Info | Registering Disk '${DiskAlias}' has been initiated. |
400 | USER_ATTACH_VM_TO_AD_GROUP | Info | Group ${GroupName} was attached to VM ${VmName} by ${UserName}. |
401 | USER_ATTACH_VM_TO_AD_GROUP_FAILED | Error | Failed to attach Group ${GroupName} to VM ${VmName} (User: ${UserName}). |
402 | USER_DETACH_VM_TO_AD_GROUP | Info | Group ${GroupName} was detached from VM ${VmName} by ${UserName}. |
403 | USER_DETACH_VM_TO_AD_GROUP_FAILED | Error | Failed to detach Group ${GroupName} from VM ${VmName} (User: ${UserName}). |
404 | USER_ATTACH_VM_POOL_TO_AD_GROUP | Info | Group ${GroupName} was attached to VM Pool ${VmPoolName} by ${UserName}. |
405 | USER_ATTACH_VM_POOL_TO_AD_GROUP_FAILED | Error | Failed to attach Group ${GroupName} to VM Pool ${VmPoolName} (User: ${UserName}). |
406 | USER_DETACH_VM_POOL_TO_AD_GROUP | Info | Group ${GroupName} was detached from VM Pool ${VmPoolName} by ${UserName}. |
407 | USER_DETACH_VM_POOL_TO_AD_GROUP_FAILED | Error | Failed to detach Group ${GroupName} from VM Pool ${VmPoolName} (User: ${UserName}). |
408 | USER_REMOVE_AD_GROUP | Info | Group ${GroupName} was removed by ${UserName}. |
409 | USER_REMOVE_AD_GROUP_FAILED | Error | Failed to remove group ${GroupName} (User: ${UserName}). |
430 | USER_UPDATE_TAG | Info | Tag ${TagName} configuration was updated by ${UserName}. |
431 | USER_UPDATE_TAG_FAILED | Error | Failed to update Tag ${TagName} (User: ${UserName}). |
432 | USER_ADD_TAG | Info | New Tag ${TagName} was created by ${UserName}. |
433 | USER_ADD_TAG_FAILED | Error | Failed to create Tag named ${TagName} (User: ${UserName}). |
434 | USER_REMOVE_TAG | Info | Tag ${TagName} was removed by ${UserName}. |
435 | USER_REMOVE_TAG_FAILED | Error | Failed to remove Tag ${TagName} (User: ${UserName}). |
436 | USER_ATTACH_TAG_TO_USER | Info | Tag ${TagName} was attached to User(s) ${AttachUsersNames} by ${UserName}. |
437 | USER_ATTACH_TAG_TO_USER_FAILED | Error | Failed to attach Tag ${TagName} to User(s) ${AttachUsersNames} (User: ${UserName}). |
438 | USER_ATTACH_TAG_TO_USER_GROUP | Info | Tag ${TagName} was attached to Group(s) ${AttachGroupsNames} by ${UserName}. |
439 | USER_ATTACH_TAG_TO_USER_GROUP_FAILED | Error | Failed to attach Group(s) ${AttachGroupsNames} to Tag ${TagName} (User: ${UserName}). |
440 | USER_ATTACH_TAG_TO_VM | Info | Tag ${TagName} was attached to VM(s) ${VmsNames} by ${UserName}. |
441 | USER_ATTACH_TAG_TO_VM_FAILED | Error | Failed to attach Tag ${TagName} to VM(s) ${VmsNames} (User: ${UserName}). |
442 | USER_ATTACH_TAG_TO_VDS | Info | Tag ${TagName} was attached to Host(s) ${VdsNames} by ${UserName}. |
443 | USER_ATTACH_TAG_TO_VDS_FAILED | Error | Failed to attach Tag ${TagName} to Host(s) ${VdsNames} (User: ${UserName}). |
444 | USER_DETACH_VDS_FROM_TAG | Info | Tag ${TagName} was detached from Host(s) ${VdsNames} by ${UserName}. |
445 | USER_DETACH_VDS_FROM_TAG_FAILED | Error | Failed to detach Tag ${TagName} from Host(s) ${VdsNames} (User: ${UserName}). |
446 | USER_DETACH_VM_FROM_TAG | Info | Tag ${TagName} was detached from VM(s) ${VmsNames} by ${UserName}. |
447 | USER_DETACH_VM_FROM_TAG_FAILED | Error | Failed to detach Tag ${TagName} from VM(s) ${VmsNames} (User: ${UserName}). |
448 | USER_DETACH_USER_FROM_TAG | Info | Tag ${TagName} detached from User(s) ${DetachUsersNames} by ${UserName}. |
449 | USER_DETACH_USER_FROM_TAG_FAILED | Error | Failed to detach Tag ${TagName} from User(s) ${DetachUsersNames} (User: ${UserName}). |
450 | USER_DETACH_USER_GROUP_FROM_TAG | Info | Tag ${TagName} was detached from Group(s) ${DetachGroupsNames} by ${UserName}. |
451 | USER_DETACH_USER_GROUP_FROM_TAG_FAILED | Error | Failed to detach Tag ${TagName} from Group(s) ${DetachGroupsNames} (User: ${UserName}). |
452 | USER_ATTACH_TAG_TO_USER_EXISTS | Warning | Tag ${TagName} already attached to User(s) ${AttachUsersNamesExists}. |
453 | USER_ATTACH_TAG_TO_USER_GROUP_EXISTS | Warning | Tag ${TagName} already attached to Group(s) ${AttachGroupsNamesExists}. |
454 | USER_ATTACH_TAG_TO_VM_EXISTS | Warning | Tag ${TagName} already attached to VM(s) ${VmsNamesExists}. |
455 | USER_ATTACH_TAG_TO_VDS_EXISTS | Warning | Tag ${TagName} already attached to Host(s) ${VdsNamesExists}. |
456 | USER_LOGGED_IN_VM | Info | User ${GuestUser} logged in to VM ${VmName}. |
457 | USER_LOGGED_OUT_VM | Info | User ${GuestUser} logged out from VM ${VmName}. |
458 | USER_LOCKED_VM | Info | User ${GuestUser} locked VM ${VmName}. |
459 | USER_UNLOCKED_VM | Info | User ${GuestUser} unlocked VM ${VmName}. |
460 | USER_ATTACH_TAG_TO_TEMPLATE_EXISTS | Warning | Tag ${TagName} already attached to Template(s) ${TemplatesNamesExists}. |
467 | UPDATE_TAGS_VM_DEFAULT_DISPLAY_TYPE | Info | Vm ${VmName} tag default display type was updated |
468 | UPDATE_TAGS_VM_DEFAULT_DISPLAY_TYPE_FAILED | Info | Failed to update Vm ${VmName} tag default display type |
470 | USER_ATTACH_VM_POOL_TO_AD_GROUP_INTERNAL | Info | Group ${GroupName} was attached to VM Pool ${VmPoolName}. |
471 | USER_ATTACH_VM_POOL_TO_AD_GROUP_FAILED_INTERNAL | Error | Failed to attach Group ${GroupName} to VM Pool ${VmPoolName}. |
472 | USER_ATTACH_USER_TO_POOL_INTERNAL | Info | User ${AdUserName} was attached to VM Pool ${VmPoolName}. |
473 | USER_ATTACH_USER_TO_POOL_FAILED_INTERNAL | Error | Failed to attach User ${AdUserName} to VM Pool ${VmPoolName} (User: ${UserName}). |
493 | VDS_ALREADY_IN_REQUESTED_STATUS | Warning | Host ${HostName} is already ${AgentStatus}, Power Management ${Operation} operation skipped. |
494 | VDS_MANUAL_FENCE_STATUS | Info | Manual fence for host ${VdsName} was started. |
495 | VDS_MANUAL_FENCE_STATUS_FAILED | Error | Manual fence for host ${VdsName} failed. |
496 | VDS_FENCE_STATUS | Info | Host ${VdsName} power management was verified successfully. |
497 | VDS_FENCE_STATUS_FAILED | Error | Failed to verify Host ${VdsName} power management. |
498 | VDS_APPROVE | Info | Host ${VdsName} was successfully approved by user ${UserName}. |
499 | VDS_APPROVE_FAILED | Error | Failed to approve Host ${VdsName}. |
500 | VDS_FAILED_TO_RUN_VMS | Error | Host ${VdsName} will be switched to Error status for ${Time} minutes because it failed to run a VM. |
501 | USER_SUSPEND_VM | Info | Suspending VM ${VmName} was initiated by User ${UserName} (Host: ${VdsName}). |
502 | USER_FAILED_SUSPEND_VM | Error | Failed to suspend VM ${VmName} (Host: ${VdsName}). |
503 | USER_SUSPEND_VM_OK | Info | VM ${VmName} on Host ${VdsName} is suspended. |
504 | VDS_INSTALL | Info | Host ${VdsName} installed |
505 | VDS_INSTALL_FAILED | Error | Host ${VdsName} installation failed. ${FailedInstallMessage}. |
506 | VDS_INITIATED_RUN_VM | Info | Trying to restart VM ${VmName} on Host ${VdsName} |
509 | VDS_INSTALL_IN_PROGRESS | Info | Installing Host ${VdsName}. ${Message}. |
510 | VDS_INSTALL_IN_PROGRESS_WARNING | Warning | Host ${VdsName} installation in progress . ${Message}. |
511 | VDS_INSTALL_IN_PROGRESS_ERROR | Error | Failed to install Host ${VdsName}. ${Message}. |
512 | USER_SUSPEND_VM_FINISH_SUCCESS | Info | Suspending VM ${VmName} has been completed. |
513 | VDS_RECOVER_FAILED_VMS_UNKNOWN | Error | Host ${VdsName} cannot be reached, VMs state on this host are marked as Unknown. |
514 | VDS_INITIALIZING | Warning | Host ${VdsName} is initializing. Message: ${ErrorMessage} |
515 | VDS_CPU_LOWER_THAN_CLUSTER | Warning | Host ${VdsName} moved to Non-Operational state as host does not meet the cluster's minimum CPU level. Missing CPU features : ${CpuFlags} |
516 | VDS_CPU_RETRIEVE_FAILED | Warning | Failed to determine Host ${VdsName} CPU level - could not retrieve CPU flags. |
517 | VDS_SET_NONOPERATIONAL | Info | Host ${VdsName} moved to Non-Operational state. |
518 | VDS_SET_NONOPERATIONAL_FAILED | Error | Failed to move Host ${VdsName} to Non-Operational state. |
519 | VDS_SET_NONOPERATIONAL_NETWORK | Warning | Host ${VdsName} does not comply with the cluster ${ClusterName} networks, the following networks are missing on host: '${Networks}' |
520 | USER_ATTACH_USER_TO_VM | Info | User ${AdUserName} was attached to VM ${VmName} by ${UserName}. |
521 | USER_SUSPEND_VM_FINISH_FAILURE | Error | Failed to complete suspending of VM ${VmName}. |
522 | VDS_SET_NONOPERATIONAL_DOMAIN | Warning | Host ${VdsName} cannot access the Storage Domain(s) ${StorageDomainNames} attached to the Data Center ${StoragePoolName}. Setting Host state to Non-Operational. |
523 | VDS_SET_NONOPERATIONAL_DOMAIN_FAILED | Error | Host ${VdsName} cannot access the Storage Domain(s) ${StorageDomainNames} attached to the Data Center ${StoragePoolName}. Failed to set Host state to Non-Operational. |
524 | VDS_DOMAIN_DELAY_INTERVAL | Warning | Storage domain ${StorageDomainName} experienced a high latency of ${Delay} seconds from host ${VdsName}. This may cause performance and functional issues. Please consult your Storage Administrator. |
525 | VDS_INITIATED_RUN_AS_STATELESS_VM_NOT_YET_RUNNING | Info | Starting VM ${VmName} as stateless was initiated. |
528 | USER_EJECT_VM_DISK | Info | CD was ejected from VM ${VmName} by ${UserName}. |
530 | VDS_MANUAL_FENCE_FAILED_CALL_FENCE_SPM | Warning | Manual fence did not revoke the selected SPM (${VdsName}) since the master storage domain\n was not active or could not use another host for the fence operation. |
531 | VDS_LOW_MEM | Warning | Available memory of host ${HostName} [${AvailableMemory} MB] is under defined threshold [${Threshold} MB]. |
532 | VDS_HIGH_MEM_USE | Warning | Used memory of host ${HostName} [${UsedMemory}%] exceeded defined threshold [${Threshold}%]. |
533 | VDS_HIGH_NETWORK_USE | Warning | |
534 | VDS_HIGH_CPU_USE | Warning | Used CPU of host ${HostName} [${UsedCpu}%] exceeded defined threshold [${Threshold}%]. |
535 | VDS_HIGH_SWAP_USE | Warning | Used swap memory of host ${HostName} [${UsedSwap}%] exceeded defined threshold [${Threshold}%]. |
536 | VDS_LOW_SWAP | Warning | Available swap memory of host ${HostName} [${AvailableSwapMemory} MB] is under defined threshold [${Threshold} MB]. |
537 | VDS_INITIATED_RUN_VM_AS_STATELESS | Info | VM ${VmName} was restarted on Host ${VdsName} as stateless |
538 | USER_RUN_VM_AS_STATELESS | Info | VM ${VmName} started on Host ${VdsName} as stateless |
539 | VDS_AUTO_FENCE_STATUS | Info | Auto fence for host ${VdsName} was started. |
540 | VDS_AUTO_FENCE_STATUS_FAILED | Error | Auto fence for host ${VdsName} failed. |
541 | VDS_AUTO_FENCE_FAILED_CALL_FENCE_SPM | Warning | Auto fence did not revoke the selected SPM (${VdsName}) since the master storage domain\n was not active or could not use another host for the fence operation. |
550 | VDS_PACKAGES_IN_PROGRESS | Info | Package update Host ${VdsName}. ${Message}. |
551 | VDS_PACKAGES_IN_PROGRESS_WARNING | Warning | Host ${VdsName} update packages in progress . ${Message}. |
552 | VDS_PACKAGES_IN_PROGRESS_ERROR | Error | Failed to update packages Host ${VdsName}. ${Message}. |
555 | USER_MOVE_TAG | Info | Tag ${TagName} was moved from ${OldParnetTagName} to ${NewParentTagName} by ${UserName}. |
556 | USER_MOVE_TAG_FAILED | Error | Failed to move Tag ${TagName} from ${OldParnetTagName} to ${NewParentTagName} (User: ${UserName}). |
600 | USER_VDS_MAINTENANCE | Info | Host ${VdsName} was switched to Maintenance mode by ${UserName} (Reason: ${Reason}). |
601 | CPU_FLAGS_NX_IS_MISSING | Warning | Host ${VdsName} is missing the NX cpu flag. This flag can be enabled via the host BIOS. Please set Disable Execute (XD) for an Intel host, or No Execute (NX) for AMD. Please make sure to completely power off the host for this change to take effect. |
602 | USER_VDS_MAINTENANCE_MIGRATION_FAILED | Warning | Host ${VdsName} cannot change into maintenance mode - not all Vms have been migrated successfully. Consider manual intervention: stopping/migrating Vms: ${failedVms} (User: ${UserName}). |
603 | VDS_SET_NONOPERATIONAL_IFACE_DOWN | Warning | Host ${VdsName} moved to Non-Operational state because interfaces which are down are needed by required networks in the current cluster: '${NicsWithNetworks}'. |
604 | VDS_TIME_DRIFT_ALERT | Warning | Host ${VdsName} has time-drift of ${Actual} seconds while maximum configured value is ${Max} seconds. |
605 | PROXY_HOST_SELECTION | Info | Host ${Proxy} from ${Origin} was chosen as a proxy to execute fencing on Host ${VdsName}. |
606 | HOST_REFRESHED_CAPABILITIES | Info | Successfully refreshed the capabilities of host ${VdsName}. |
607 | HOST_REFRESH_CAPABILITIES_FAILED | Error | Failed to refresh the capabilities of host ${VdsName}. |
608 | HOST_INTERFACE_HIGH_NETWORK_USE | Warning | Host ${HostName} has network interface which exceeded the defined threshold [${Threshold}%] (${InterfaceName}: transmit rate[${TransmitRate}%], receive rate [${ReceiveRate}%]) |
609 | HOST_INTERFACE_STATE_UP | Normal | Interface ${InterfaceName} on host ${VdsName}, changed state to up |
610 | HOST_INTERFACE_STATE_DOWN | Warning | Interface ${InterfaceName} on host ${VdsName}, changed state to down |
611 | HOST_BOND_SLAVE_STATE_UP | Normal | Slave ${SlaveName} of bond ${BondName} on host ${VdsName}, changed state to up |
612 | HOST_BOND_SLAVE_STATE_DOWN | Warning | Slave ${SlaveName} of bond ${BondName} on host ${VdsName}, changed state to down |
613 | FENCE_KDUMP_LISTENER_IS_NOT_ALIVE | Error | Unable to determine if Kdump is in progress on host ${VdsName}, because fence_kdump listener is not running. |
614 | KDUMP_FLOW_DETECTED_ON_VDS | Info | Kdump flow is in progress on host ${VdsName}. |
615 | KDUMP_FLOW_NOT_DETECTED_ON_VDS | Info | Kdump flow is not in progress on host ${VdsName}. |
616 | KDUMP_FLOW_FINISHED_ON_VDS | Info | Kdump flow finished on host ${VdsName}. |
617 | KDUMP_DETECTION_NOT_CONFIGURED_ON_VDS | Warning | Kdump integration is enabled for host ${VdsName}, but kdump is not configured properly on host. |
618 | HOST_REGISTRATION_FAILED_INVALID_CLUSTER | Info | No default or valid cluster was found, Host ${VdsName} registration failed |
619 | HOST_PROTOCOL_INCOMPATIBLE_WITH_CLUSTER | Warning | Host ${VdsName} uses not compatible protocol during activation (xmlrpc instead of jsonrpc). Please examine installation logs and VDSM logs for failures and reinstall the host. |
620 | USER_VDS_MAINTENANCE_WITHOUT_REASON | Info | Host ${VdsName} was switched to Maintenance mode by ${UserName}. |
700 | DISK_ALIGNMENT_SCAN_START | Info | Starting alignment scan of disk '${DiskAlias}'. |
701 | DISK_ALIGNMENT_SCAN_FAILURE | Warning | Alignment scan of disk '${DiskAlias}' failed. |
702 | DISK_ALIGNMENT_SCAN_SUCCESS | Info | Alignment scan of disk '${DiskAlias}' is complete. |
809 | USER_ADD_CLUSTER | Info | Cluster ${ClusterName} was added by ${UserName} |
810 | USER_ADD_CLUSTER_FAILED | Error | Failed to add Host cluster (User: ${UserName}) |
811 | USER_UPDATE_CLUSTER | Info | Host cluster ${ClusterName} was updated by ${UserName} |
812 | USER_UPDATE_CLUSTER_FAILED | Error | Failed to update Host cluster (User: ${UserName}) |
813 | USER_REMOVE_CLUSTER | Info | Host cluster ${ClusterName} was removed by ${UserName} |
814 | USER_REMOVE_CLUSTER_FAILED | Error | Failed to remove Host cluster (User: ${UserName}) |
815 | USER_VDC_LOGOUT_FAILED | Error | Failed to log User ${UserName} out. |
816 | MAC_POOL_EMPTY | Warning | No MAC addresses left in the MAC Address Pool. |
817 | CERTIFICATE_FILE_NOT_FOUND | Error | Could not find oVirt Engine Certificate file. |
818 | RUN_VM_FAILED | Error | Cannot run VM ${VmName} on Host ${VdsName}. Error: ${ErrMsg} |
819 | VDS_REGISTER_ERROR_UPDATING_HOST | Error | Host registration failed - cannot update Host Name for Host ${VdsName2}. (Host: ${VdsName1}) |
820 | VDS_REGISTER_ERROR_UPDATING_HOST_ALL_TAKEN | Error | Host registration failed - all available Host Names are taken. (Host: ${VdsName1}) |
821 | VDS_REGISTER_HOST_IS_ACTIVE | Error | Host registration failed - cannot change Host Name of active Host ${VdsName2}. (Host: ${VdsName1}) |
822 | VDS_REGISTER_ERROR_UPDATING_NAME | Error | Host registration failed - cannot update Host Name for Host ${VdsName2}. (Host: ${VdsName1}) |
823 | VDS_REGISTER_ERROR_UPDATING_NAMES_ALL_TAKEN | Error | Host registration failed - all available Host Names are taken. (Host: ${VdsName1}) |
824 | VDS_REGISTER_NAME_IS_ACTIVE | Error | Host registration failed - cannot change Host Name of active Host ${VdsName2}. (Host: ${VdsName1}) |
825 | VDS_REGISTER_AUTO_APPROVE_PATTERN | Error | Host registration failed - auto approve pattern error. (Host: ${VdsName1}) |
826 | VDS_REGISTER_FAILED | Error | Host registration failed. (Host: ${VdsName1}) |
827 | VDS_REGISTER_EXISTING_VDS_UPDATE_FAILED | Error | Host registration failed - cannot update existing Host. (Host: ${VdsName1}) |
828 | VDS_REGISTER_SUCCEEDED | Info | Host ${VdsName1} registered. |
829 | VM_MIGRATION_ON_CONNECT_CHECK_FAILED | Error | VM migration logic failed. (VM name: ${VmName}) |
830 | VM_MIGRATION_ON_CONNECT_CHECK_SUCCEEDED | Info | Migration check failed to execute. |
831 | USER_VDC_SESSION_TERMINATED | Info | User ${UserName} forcibly logout user ${TerminatedSessionUsername}. |
832 | USER_VDC_SESSION_TERMINATION_FAILED | Error | User ${UserName} failed to forcibly logout user ${TerminatedSessionUsername}. |
833 | MAC_ADDRESS_IS_IN_USE | Warning | Network Interface ${IfaceName} has MAC address ${MACAddr} which is in use. |
834 | VDS_REGISTER_EMPTY_ID | Warning | Host registration failed, empty host id (Host: ${VdsHostName}) |
835 | SYSTEM_UPDATE_CLUSTER | Info | Host cluster ${ClusterName} was updated by system |
836 | SYSTEM_UPDATE_CLUSTER_FAILED | Info | Failed to update Host cluster by system |
837 | MAC_ADDRESSES_POOL_NOT_INITIALIZED | Warning | Mac Address Pool is not initialized. ${Message} |
838 | MAC_ADDRESS_IS_IN_USE_UNPLUG | Warning | Network Interface ${IfaceName} has MAC address ${MACAddr} which is in use, therefore it is being unplugged from VM ${VmName}. |
839 | HOST_AVAILABLE_UPDATES_FAILED | Error | Failed to check for available updates on host ${VdsName} with message '${Message}'. |
840 | HOST_UPGRADE_STARTED | Info | Host ${VdsName} upgrade was started (User: ${UserName}). |
841 | HOST_UPGRADE_FAILED | Error | Failed to upgrade Host ${VdsName} (User: ${UserName}). |
842 | HOST_UPGRADE_FINISHED | Info | Host ${VdsName} upgrade was completed successfully. |
845 | HOST_CERTIFICATION_IS_ABOUT_TO_EXPIRE | Warning | Host ${VdsName} certification is about to expire at ${ExpirationDate}. Please renew the host's certification. |
846 | ENGINE_CERTIFICATION_HAS_EXPIRED | Info | Engine's certification has expired at ${ExpirationDate}. Please renew the engine's certification. |
847 | ENGINE_CERTIFICATION_IS_ABOUT_TO_EXPIRE | Warning | Engine's certification is about to expire at ${ExpirationDate}. Please renew the engine's certification. |
848 | ENGINE_CA_CERTIFICATION_HAS_EXPIRED | Info | Engine's CA certification has expired at ${ExpirationDate}. |
849 | ENGINE_CA_CERTIFICATION_IS_ABOUT_TO_EXPIRE | Warning | Engine's CA certification is about to expire at ${ExpirationDate}. |
850 | USER_ADD_PERMISSION | Info | User/Group ${SubjectName}, Namespace ${Namespace}, Authorization provider: ${Authz} was granted permission for Role ${RoleName} on ${VdcObjectType} ${VdcObjectName}, by ${UserName}. |
851 | USER_ADD_PERMISSION_FAILED | Error | User ${UserName} failed to grant permission for Role ${RoleName} on ${VdcObjectType} ${VdcObjectName} to User/Group ${SubjectName}. |
852 | USER_REMOVE_PERMISSION | Info | User/Group ${SubjectName} Role ${RoleName} permission was removed from ${VdcObjectType} ${VdcObjectName} by ${UserName} |
853 | USER_REMOVE_PERMISSION_FAILED | Error | User ${UserName} failed to remove permission for Role ${RoleName} from ${VdcObjectType} ${VdcObjectName} to User/Group ${SubjectName} |
854 | USER_ADD_ROLE | Info | Role ${RoleName} granted to ${UserName} |
855 | USER_ADD_ROLE_FAILED | Error | Failed to grant role ${RoleName} (User ${UserName}) |
856 | USER_UPDATE_ROLE | Info | ${UserName} Role was updated to the ${RoleName} Role |
857 | USER_UPDATE_ROLE_FAILED | Error | Failed to update role ${RoleName} to ${UserName} |
858 | USER_REMOVE_ROLE | Info | Role ${RoleName} removed from ${UserName} |
859 | USER_REMOVE_ROLE_FAILED | Error | Failed to remove role ${RoleName} (User ${UserName}) |
860 | USER_ATTACHED_ACTION_GROUP_TO_ROLE | Info | Action group ${ActionGroup} was attached to Role ${RoleName} by ${UserName} |
861 | USER_ATTACHED_ACTION_GROUP_TO_ROLE_FAILED | Error | Failed to attach Action group ${ActionGroup} to Role ${RoleName} (User: ${UserName}) |
862 | USER_DETACHED_ACTION_GROUP_FROM_ROLE | Info | Action group ${ActionGroup} was detached from Role ${RoleName} by ${UserName} |
863 | USER_DETACHED_ACTION_GROUP_FROM_ROLE_FAILED | Error | Failed to attach Action group ${ActionGroup} to Role ${RoleName} by ${UserName} |
864 | USER_ADD_ROLE_WITH_ACTION_GROUP | Info | Role ${RoleName} was added by ${UserName} |
865 | USER_ADD_ROLE_WITH_ACTION_GROUP_FAILED | Error | Failed to add role ${RoleName} |
866 | USER_ADD_SYSTEM_PERMISSION | Info | User/Group ${SubjectName} was granted permission for Role ${RoleName} on ${VdcObjectType} by ${UserName}. |
867 | USER_ADD_SYSTEM_PERMISSION_FAILED | Error | User ${UserName} failed to grant permission for Role ${RoleName} on ${VdcObjectType} to User/Group ${SubjectName}. |
868 | USER_REMOVE_SYSTEM_PERMISSION | Info | User/Group ${SubjectName} Role ${RoleName} permission was removed from ${VdcObjectType} by ${UserName} |
869 | USER_REMOVE_SYSTEM_PERMISSION_FAILED | Error | User ${UserName} failed to remove permission for Role ${RoleName} from ${VdcObjectType} to User/Group ${SubjectName} |
870 | USER_ADD_PROFILE | Info | Profile created for ${UserName} |
871 | USER_ADD_PROFILE_FAILED | Error | Failed to create profile for ${UserName} |
872 | USER_UPDATE_PROFILE | Info | Updated profile for ${UserName} |
873 | USER_UPDATE_PROFILE_FAILED | Error | Failed to update profile for ${UserName} |
874 | USER_REMOVE_PROFILE | Info | Removed profile for ${UserName} |
875 | USER_REMOVE_PROFILE_FAILED | Error | Failed to remove profile for ${UserName} |
876 | HOST_CERTIFICATION_IS_INVALID | Error | Host ${VdsName} certification is invalid. The certification has no peer certificates. |
877 | HOST_CERTIFICATION_HAS_EXPIRED | Info | Host ${VdsName} certification has expired at ${ExpirationDate}. Please renew the host's certification. |
878 | ENGINE_CERTIFICATION_IS_ABOUT_TO_EXPIRE_ALERT | Info | Engine's certification is about to expire at ${ExpirationDate}. Please renew the engine's certification. |
879 | HOST_CERTIFICATION_IS_ABOUT_TO_EXPIRE_ALERT | Info | Host ${VdsName} certification is about to expire at ${ExpirationDate}. Please renew the host's certification. |
880 | HOST_CERTIFICATION_ENROLLMENT_STARTED | Normal | Enrolling certificate for host ${VdsName} was started (User: ${UserName}). |
881 | HOST_CERTIFICATION_ENROLLMENT_FINISHED | Normal | Enrolling certificate for host ${VdsName} was completed successfully (User: ${UserName}). |
882 | HOST_CERTIFICATION_ENROLLMENT_FAILED | Error | Failed to enroll certificate for host ${VdsName} (User: ${UserName}). |
883 | ENGINE_CA_CERTIFICATION_IS_ABOUT_TO_EXPIRE_ALERT | Info | Engine's CA certification is about to expire at ${ExpirationDate}. |
884 | HOST_AVAILABLE_UPDATES_STARTED | Info | Started to check for available updates on host ${VdsName}. |
885 | HOST_AVAILABLE_UPDATES_FINISHED | Info | Check for available updates on host ${VdsName} was completed successfully with message '${Message}'. |
886 | HOST_AVAILABLE_UPDATES_PROCESS_IS_ALREADY_RUNNING | Warning | Failed to check for available updates on host ${VdsName}: Another process is already running. |
890 | HOST_UPGRADE_FINISHED_MANUAL_HA | Warning | Host ${VdsName} upgrade was completed successfully, but the Hosted Engine HA service may still be in maintenance mode. If necessary, please correct this manually. |
900 | AD_COMPUTER_ACCOUNT_SUCCEEDED | Info | Account creation successful. |
901 | AD_COMPUTER_ACCOUNT_FAILED | Error | Account creation failed. |
918 | USER_FORCE_REMOVE_STORAGE_POOL | Info | Data Center ${StoragePoolName} was forcibly removed by ${UserName} |
919 | USER_FORCE_REMOVE_STORAGE_POOL_FAILED | Error | Failed to forcibly remove Data Center ${StoragePoolName}. (User: ${UserName}) |
925 | MAC_ADDRESS_IS_EXTERNAL | Warning | VM ${VmName} has MAC address(es) ${MACAddr}, which is/are out of its MAC pool definitions. |
926 | NETWORK_REMOVE_BOND | Info | Remove bond: ${BondName} for Host: ${VdsName} (User:${UserName}). |
927 | NETWORK_REMOVE_BOND_FAILED | Error | Failed to remove bond: ${BondName} for Host: ${VdsName} (User:${UserName}). |
928 | NETWORK_VDS_NETWORK_MATCH_CLUSTER | Info | Vds ${VdsName} network match to cluster ${ClusterName} |
929 | NETWORK_VDS_NETWORK_NOT_MATCH_CLUSTER | Error | Vds ${VdsName} network does not match to cluster ${ClusterName} |
930 | NETWORK_REMOVE_VM_INTERFACE | Info | Interface ${InterfaceName} (${InterfaceType}) was removed from VM ${VmName}. (User: ${UserName}) |
931 | NETWORK_REMOVE_VM_INTERFACE_FAILED | Error | Failed to remove Interface ${InterfaceName} (${InterfaceType}) from VM ${VmName}. (User: ${UserName}) |
932 | NETWORK_ADD_VM_INTERFACE | Info | Interface ${InterfaceName} (${InterfaceType}) was added to VM ${VmName}. (User: ${UserName}) |
933 | NETWORK_ADD_VM_INTERFACE_FAILED | Error | Failed to add Interface ${InterfaceName} (${InterfaceType}) to VM ${VmName}. (User: ${UserName}) |
934 | NETWORK_UPDATE_VM_INTERFACE | Info | Interface ${InterfaceName} (${InterfaceType}) was updated for VM ${VmName}. ${LinkState} (User: ${UserName}) |
935 | NETWORK_UPDATE_VM_INTERFACE_FAILED | Error | Failed to update Interface ${InterfaceName} (${InterfaceType}) for VM ${VmName}. (User: ${UserName}) |
936 | NETWORK_ADD_TEMPLATE_INTERFACE | Info | Interface ${InterfaceName} (${InterfaceType}) was added to Template ${VmTemplateName}. (User: ${UserName}) |
937 | NETWORK_ADD_TEMPLATE_INTERFACE_FAILED | Error | Failed to add Interface ${InterfaceName} (${InterfaceType}) to Template ${VmTemplateName}. (User: ${UserName}) |
938 | NETWORK_REMOVE_TEMPLATE_INTERFACE | Info | Interface ${InterfaceName} (${InterfaceType}) was removed from Template ${VmTemplateName}. (User: ${UserName}) |
939 | NETWORK_REMOVE_TEMPLATE_INTERFACE_FAILED | Error | Failed to remove Interface ${InterfaceName} (${InterfaceType}) from Template ${VmTemplateName}. (User: ${UserName}) |
940 | NETWORK_UPDATE_TEMPLATE_INTERFACE | Info | Interface ${InterfaceName} (${InterfaceType}) was updated for Template ${VmTemplateName}. (User: ${UserName}) |
941 | NETWORK_UPDATE_TEMPLATE_INTERFACE_FAILED | Error | Failed to update Interface ${InterfaceName} (${InterfaceType}) for Template ${VmTemplateName}. (User: ${UserName}) |
942 | NETWORK_ADD_NETWORK | Info | Network ${NetworkName} was added to Data Center: ${StoragePoolName} |
943 | NETWORK_ADD_NETWORK_FAILED | Error | Failed to add Network ${NetworkName} to Data Center: ${StoragePoolName} |
944 | NETWORK_REMOVE_NETWORK | Info | Network ${NetworkName} was removed from Data Center: ${StoragePoolName} |
945 | NETWORK_REMOVE_NETWORK_FAILED | Error | Failed to remove Network ${NetworkName} from Data Center: ${StoragePoolName} |
946 | NETWORK_ATTACH_NETWORK_TO_CLUSTER | Info | Network ${NetworkName} attached to Cluster ${ClusterName} |
947 | NETWORK_ATTACH_NETWORK_TO_CLUSTER_FAILED | Error | Failed to attach Network ${NetworkName} to Cluster ${ClusterName} |
948 | NETWORK_DETACH_NETWORK_TO_CLUSTER | Info | Network ${NetworkName} detached from Cluster ${ClusterName} |
949 | NETWORK_DETACH_NETWORK_TO_CLUSTER_FAILED | Error | Failed to detach Network ${NetworkName} from Cluster ${ClusterName} |
950 | USER_ADD_STORAGE_POOL | Info | Data Center ${StoragePoolName}, Compatibility Version ${CompatibilityVersion} and Quota Type ${QuotaEnforcementType} was added by ${UserName} |
951 | USER_ADD_STORAGE_POOL_FAILED | Error | Failed to add Data Center ${StoragePoolName}. (User: ${UserName}) |
952 | USER_UPDATE_STORAGE_POOL | Info | Data Center ${StoragePoolName} was updated by ${UserName} |
953 | USER_UPDATE_STORAGE_POOL_FAILED | Error | Failed to update Data Center ${StoragePoolName}. (User: ${UserName}) |
954 | USER_REMOVE_STORAGE_POOL | Info | Data Center ${StoragePoolName} was removed by ${UserName} |
955 | USER_REMOVE_STORAGE_POOL_FAILED | Error | Failed to remove Data Center ${StoragePoolName}. (User: ${UserName}) |
956 | USER_ADD_STORAGE_DOMAIN | Info | Storage Domain ${StorageDomainName} was added by ${UserName} |
957 | USER_ADD_STORAGE_DOMAIN_FAILED | Error | Failed to add Storage Domain ${StorageDomainName}. (User: ${UserName}) |
958 | USER_UPDATE_STORAGE_DOMAIN | Info | Storage Domain ${StorageDomainName} was updated by ${UserName} |
959 | USER_UPDATE_STORAGE_DOMAIN_FAILED | Error | Failed to update Storage Domain ${StorageDomainName}. (User: ${UserName}) |
960 | USER_REMOVE_STORAGE_DOMAIN | Info | Storage Domain ${StorageDomainName} was removed by ${UserName} |
961 | USER_REMOVE_STORAGE_DOMAIN_FAILED | Error | Failed to remove Storage Domain ${StorageDomainName}. (User: ${UserName}) |
962 | USER_ATTACH_STORAGE_DOMAIN_TO_POOL | Info | Storage Domain ${StorageDomainName} was attached to Data Center ${StoragePoolName} by ${UserName} |
963 | USER_ATTACH_STORAGE_DOMAIN_TO_POOL_FAILED | Error | Failed to attach Storage Domain ${StorageDomainName} to Data Center ${StoragePoolName}. (User: ${UserName}) |
964 | USER_DETACH_STORAGE_DOMAIN_FROM_POOL | Info | Storage Domain ${StorageDomainName} was detached from Data Center ${StoragePoolName} by ${UserName} |
965 | USER_DETACH_STORAGE_DOMAIN_FROM_POOL_FAILED | Error | Failed to detach Storage Domain ${StorageDomainName} from Data Center ${StoragePoolName}. (User: ${UserName}) |
966 | USER_ACTIVATED_STORAGE_DOMAIN | Info | Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}) was activated by ${UserName} |
967 | USER_ACTIVATE_STORAGE_DOMAIN_FAILED | Error | Failed to activate Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}) by ${UserName} |
968 | USER_DEACTIVATED_STORAGE_DOMAIN | Info | Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}) was deactivated and has moved to 'Preparing for maintenance' until it will no longer be accessed by any Host of the Data Center. |
969 | USER_DEACTIVATE_STORAGE_DOMAIN_FAILED | Error | Failed to deactivate Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}). |
970 | SYSTEM_DEACTIVATED_STORAGE_DOMAIN | Warning | Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}) was deactivated by system because it's not visible by any of the hosts. |
971 | SYSTEM_DEACTIVATE_STORAGE_DOMAIN_FAILED | Error | Failed to deactivate Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}). |
972 | USER_EXTENDED_STORAGE_DOMAIN | Info | Storage ${StorageDomainName} has been extended by ${UserName}. Please wait for refresh. |
973 | USER_EXTENDED_STORAGE_DOMAIN_FAILED | Error | Failed to extend Storage Domain ${StorageDomainName}. (User: ${UserName}) |
974 | USER_REMOVE_VG | Info | Volume group ${VgId} was removed by ${UserName}. |
975 | USER_REMOVE_VG_FAILED | Error | Failed to remove Volume group ${VgId}. (User: UserName) |
976 | USER_ACTIVATE_STORAGE_POOL | Info | Data Center ${StoragePoolName} was activated. (User: ${UserName}) |
977 | USER_ACTIVATE_STORAGE_POOL_FAILED | Error | Failed to activate Data Center ${StoragePoolName}. (User: ${UserName}) |
978 | SYSTEM_FAILED_CHANGE_STORAGE_POOL_STATUS | Error | Failed to change Data Center ${StoragePoolName} status. |
979 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_NO_HOST_FOR_SPM | Error | Fencing failed on Storage Pool Manager ${VdsName} for Data Center ${StoragePoolName}. Setting status to Non-Operational. |
980 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC | Warning | Invalid status on Data Center ${StoragePoolName}. Setting status to Non Responsive. |
981 | USER_FORCE_REMOVE_STORAGE_DOMAIN | Info | Storage Domain ${StorageDomainName} was forcibly removed by ${UserName} |
982 | USER_FORCE_REMOVE_STORAGE_DOMAIN_FAILED | Error | Failed to forcibly remove Storage Domain ${StorageDomainName}. (User: ${UserName}) |
983 | RECONSTRUCT_MASTER_FAILED_NO_MASTER | Warning | No valid Data Storage Domains are available in Data Center ${StoragePoolName} (please check your storage infrastructure). |
984 | RECONSTRUCT_MASTER_DONE | Info | Reconstruct Master Domain for Data Center ${StoragePoolName} completed. |
985 | RECONSTRUCT_MASTER_FAILED | Error | Failed to Reconstruct Master Domain for Data Center ${StoragePoolName}. |
986 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC_SEARCHING_NEW_SPM | Warning | Data Center is being initialized, please wait for initialization to complete. |
987 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC_WITH_ERROR | Warning | Invalid status on Data Center ${StoragePoolName}. Setting Data Center status to Non Responsive (On host ${VdsName}, Error: ${Error}). |
988 | USER_CONNECT_HOSTS_TO_LUN_FAILED | Error | Failed to connect Host ${VdsName} to device. (User: ${UserName}) |
989 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC_FROM_NON_OPERATIONAL | Info | Try to recover Data Center ${StoragePoolName}. Setting status to Non Responsive. |
990 | SYSTEM_MASTER_DOMAIN_NOT_IN_SYNC | Warning | Sync Error on Master Domain between Host ${VdsName} and oVirt Engine. Domain: ${StorageDomainName} is marked as Master in oVirt Engine database but not on the Storage side. Please consult with Support on how to fix this issue. |
991 | RECOVERY_STORAGE_POOL | Info | Data Center ${StoragePoolName} was recovered by ${UserName} |
992 | RECOVERY_STORAGE_POOL_FAILED | Error | Failed to recover Data Center ${StoragePoolName} (User:${UserName}) |
993 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_RESET_IRS | Info | Data Center ${StoragePoolName} was reset. Setting status to Non Responsive (Elect new Storage Pool Manager). |
994 | CONNECT_STORAGE_SERVERS_FAILED | Warning | Failed to connect Host ${VdsName} to Storage Servers |
995 | CONNECT_STORAGE_POOL_FAILED | Warning | Failed to connect Host ${VdsName} to Storage Pool ${StoragePoolName} |
996 | STORAGE_DOMAIN_ERROR | Error | The error message for connection ${Connection} returned by VDSM was: ${ErrorMessage} |
997 | REFRESH_REPOSITORY_IMAGE_LIST_FAILED | Error | Refresh image list failed for domain(s): ${imageDomains}. Please check domain activity. |
998 | REFRESH_REPOSITORY_IMAGE_LIST_SUCCEEDED | Info | Refresh image list succeeded for domain(s): ${imageDomains} |
999 | STORAGE_ALERT_VG_METADATA_CRITICALLY_FULL | Error | The system has reached the 80% watermark on the VG metadata area size on ${StorageDomainName}.\nThis is due to a high number of Vdisks or large Vdisks size allocated on this specific VG. |
1000 | STORAGE_ALERT_SMALL_VG_METADATA | Warning | The allocated VG metadata area size is smaller than 50MB on ${StorageDomainName},\nwhich might limit its capacity (the number of Vdisks and/or their size). |
1001 | USER_RUN_VM_FAILURE_STATELESS_SNAPSHOT_LEFT | Error | Failed to start VM ${VmName}, because exist snapshot for stateless state. Snapshot will be deleted. |
1002 | USER_ATTACH_STORAGE_DOMAINS_TO_POOL | Info | Storage Domains were attached to Data Center ${StoragePoolName} by ${UserName} |
1003 | USER_ATTACH_STORAGE_DOMAINS_TO_POOL_FAILED | Error | Failed to attach Storage Domains to Data Center ${StoragePoolName}. (User: ${UserName}) |
1004 | STORAGE_DOMAIN_TASKS_ERROR | Warning | Storage Domain ${StorageDomainName} is down while there are tasks running on it. These tasks may fail. |
1005 | UPDATE_OVF_FOR_STORAGE_POOL_FAILED | Warning | Failed to update VMs/Templates OVF data in Data Center ${StoragePoolName}. |
1006 | UPGRADE_STORAGE_POOL_ENCOUNTERED_PROBLEMS | Warning | Data Center ${StoragePoolName} has encountered problems during upgrade process. |
1007 | REFRESH_REPOSITORY_IMAGE_LIST_INCOMPLETE | Warning | Refresh image list probably incomplete for domain ${imageDomain}, only ${imageListSize} images discovered. |
1008 | NUMBER_OF_LVS_ON_STORAGE_DOMAIN_EXCEEDED_THRESHOLD | Warning | The number of LVs on the domain ${storageDomainName} exceeded ${maxNumOfLVs}, you are approaching the limit where performance may degrade. |
1009 | USER_DEACTIVATE_STORAGE_DOMAIN_OVF_UPDATE_INCOMPLETE | Warning | Failed to deactivate Storage Domain ${StorageDomainName} as the engine was restarted during the operation, please retry. (Data Center ${StoragePoolName}). |
1010 | RELOAD_CONFIGURATIONS_SUCCESS | Info | System Configurations reloaded successfully. |
1011 | RELOAD_CONFIGURATIONS_FAILURE | Error | System Configurations failed to reload. |
1012 | NETWORK_ACTIVATE_VM_INTERFACE_SUCCESS | Info | Network Interface ${InterfaceName} (${InterfaceType}) was plugged to VM ${VmName}. (User: ${UserName}) |
1013 | NETWORK_ACTIVATE_VM_INTERFACE_FAILURE | Error | Failed to plug Network Interface ${InterfaceName} (${InterfaceType}) to VM ${VmName}. (User: ${UserName}) |
1014 | NETWORK_DEACTIVATE_VM_INTERFACE_SUCCESS | Info | Network Interface ${InterfaceName} (${InterfaceType}) was unplugged from VM ${VmName}. (User: ${UserName}) |
1015 | NETWORK_DEACTIVATE_VM_INTERFACE_FAILURE | Error | Failed to unplug Network Interface ${InterfaceName} (${InterfaceType}) from VM ${VmName}. (User: ${UserName}) |
1016 | UPDATE_FOR_OVF_STORES_FAILED | Warning | Failed to update OVF disks ${DisksIds}, OVF data isn't updated on those OVF stores (Data Center ${DataCenterName}, Storage Domain ${StorageDomainName}). |
1017 | RETRIEVE_OVF_STORE_FAILED | Warning | Failed to retrieve VMs and Templates from the OVF disk of Storage Domain ${StorageDomainName}. |
1018 | OVF_STORE_DOES_NOT_EXISTS | Warning | This Data center compatibility version does not support importing a data domain with its entities (VMs and Templates). The imported domain will be imported without them. |
1019 | UPDATE_DESCRIPTION_FOR_DISK_FAILED | Error | Failed to update the meta data description of disk ${DiskName} (Data Center ${DataCenterName}, Storage Domain ${StorageDomainName}). |
1020 | UPDATE_DESCRIPTION_FOR_DISK_SKIPPED_SINCE_STORAGE_DOMAIN_NOT_ACTIVE | Warning | Not updating the metadata of Disk ${DiskName} (Data Center ${DataCenterName}. Since the Storage Domain ${StorageDomainName} is not in active. |
1022 | USER_REFRESH_LUN_STORAGE_DOMAIN | Info | Resize LUNs operation succeeded. |
1023 | USER_REFRESH_LUN_STORAGE_DOMAIN_FAILED | Error | Failed to resize LUNs. |
1024 | USER_REFRESH_LUN_STORAGE_DIFFERENT_SIZE_DOMAIN_FAILED | Error | Failed to resize LUNs.\n Not all the hosts are seeing the same LUN size. |
1025 | VM_PAUSED | Info | VM ${VmName} has been paused. |
1026 | FAILED_TO_STORE_ENTIRE_DISK_FIELD_IN_DISK_DESCRIPTION_METADATA | Warning | Failed to store field ${DiskFieldName} as a part of ${DiskAlias}'s description metadata due to storage space limitations. The field ${DiskFieldName} will be truncated. |
1027 | FAILED_TO_STORE_ENTIRE_DISK_FIELD_AND_REST_OF_FIELDS_IN_DISK_DESCRIPTION_METADATA | Warning | Failed to store field ${DiskFieldName} as a part of ${DiskAlias}'s description metadata due to storage space limitations. The value will be truncated and the following fields will not be stored at all: ${DiskFieldsNames}. |
1028 | FAILED_TO_STORE_DISK_FIELDS_IN_DISK_DESCRIPTION_METADATA | Warning | Failed to store the following fields in the description metadata of disk ${DiskAlias} due to storage space limitations: ${DiskFieldsNames}. |
1029 | STORAGE_DOMAIN_MOVED_TO_MAINTENANCE | Info | Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}) successfully moved to Maintenance as it's no longer accessed by any Host of the Data Center. |
1030 | USER_DEACTIVATED_LAST_MASTER_STORAGE_DOMAIN | Info | Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}) was deactivated. |
1031 | TRANSFER_IMAGE_INITIATED | Info | Image ${TransferType} with disk ${DiskAlias} was initiated by ${UserName}. |
1032 | TRANSFER_IMAGE_SUCCEEDED | Info | Image ${TransferType} with disk ${DiskAlias} succeeded. |
1033 | TRANSFER_IMAGE_CANCELLED | Info | Image ${TransferType} with disk ${DiskAlias} was cancelled. |
1034 | TRANSFER_IMAGE_FAILED | Error | Image ${TransferType} with disk ${DiskAlias} failed. |
1035 | TRANSFER_IMAGE_TEARDOWN_FAILED | Info | Failed to tear down image ${DiskAlias} after image transfer session. |
1036 | USER_SCAN_STORAGE_DOMAIN_FOR_UNREGISTERED_DISKS | Info | Storage Domain ${StorageDomainName} has finished to scan for unregistered disks by ${UserName}. |
1037 | USER_SCAN_STORAGE_DOMAIN_FOR_UNREGISTERED_DISKS_FAILED | Error | Storage Domain ${StorageDomainName} failed to scan for unregistered disks by ${UserName}. |
1038 | UPLOAD_IMAGE_NETWORK_ERROR | Warning | Unable to upload image to disk ${DiskId} due to a network error. Make sure ovirt-imageio-proxy service is installed and configured, and ovirt-engine's certificate is registered as a valid CA in the browser. The certificate can be fetched from https://<engine_url>/ovirt-engine/services/pki-resource?resource |
1039 | LUNS_BROKE_SD_PASS_DISCARD_SUPPORT | Warning | Luns with IDs: [${LunsIds}] were updated in the db but caused the storage domain with id ${storageDomainId} to stop supporting passing discard from the guest to the underlying storage. Please configure these luns' discard support in the underlying storage or disable 'Enable Discard' for vm disks on this storage domain. |
1040 | DISKS_WITH_ILLEGAL_PASS_DISCARD_EXIST | Warning | Disks with IDs: [${DisksIds}] have their 'Enable Discard' on even though the underlying storage does not support it. Please configure the underlying storage to support discard or disable 'Enable Discard' for these disks. |
1041 | USER_REMOVE_DEVICE_FROM_STORAGE_DOMAIN_FAILED | Error | Failed to remove ${LunId} from Storage Domain ${StorageDomainName}. (User: ${UserName}) |
1042 | USER_REMOVE_DEVICE_FROM_STORAGE_DOMAIN | Info | ${LunId} was removed from Storage Domain ${StorageDomainName}. (User: ${UserName}) |
1043 | USER_REMOVE_DEVICE_FROM_STORAGE_DOMAIN_STARTED | Info | Started to remove ${LunId} from Storage Domain ${StorageDomainName}. (User: ${UserName}) |
1044 | ILLEGAL_STORAGE_DOMAIN_DISCARD_AFTER_DELETE | Warning | The storage domain with id ${storageDomainId} has its 'Discard After Delete' enabled even though the underlying storage does not support discard. Therefore, disks and snapshots on this storage domain will not be discarded before they are removed. |
1045 | LUNS_BROKE_SD_DISCARD_AFTER_DELETE_SUPPORT | Warning | Luns with IDs: [${LunsIds}] were updated in the db but caused the storage domain with id ${storageDomainId} to stop supporting discard after delete. Please configure these luns' discard support in the underlying storage or disable 'Discard After Delete' for this storage domain. |
1046 | STORAGE_DOMAINS_COULD_NOT_BE_SYNCED | Info | Storage domains with IDs [${StorageDomainsIds}] could not be synchronized. To synchronize them, please move them to maintenance and then activate. |
1047 | UPLOAD_IMAGE_CLIENT_ERROR | Error | Unable to upload image to disk ${DiskId} due to a client error. Make sure the selected file is readable. |
1098 | NETWORK_UPDATE_DISPLAY_FOR_HOST_WITH_ACTIVE_VM | Warning | Display Network was updated on Host ${VdsName} with active VMs attached. The change will be applied to those VMs after their next reboot. Running VMs might loose display connectivity until then. |
1099 | NETWORK_UPDATE_DISPLAY_FOR_CLUSTER_WITH_ACTIVE_VM | Warning | Display Network (${NetworkName}) was updated for Cluster ${ClusterName} with active VMs attached. The change will be applied to those VMs after their next reboot. |
1100 | NETWORK_UPDATE_DISPLAY_TO_CLUSTER | Info | Update Display Network (${NetworkName}) for Cluster ${ClusterName}. (User: ${UserName}) |
1101 | NETWORK_UPDATE_DISPLAY_TO_CLUSTER_FAILED | Error | Failed to update Display Network (${NetworkName}) for Cluster ${ClusterName}. (User: ${UserName}) |
1102 | NETWORK_UPDATE_NETWORK_TO_VDS_INTERFACE | Info | Update Network ${NetworkName} in Host ${VdsName}. (User: ${UserName}) |
1103 | NETWORK_UPDATE_NETWORK_TO_VDS_INTERFACE_FAILED | Error | Failed to update Network ${NetworkName} in Host ${VdsName}. (User: ${UserName}) |
1104 | NETWORK_COMMINT_NETWORK_CHANGES | Info | Network changes were saved on host ${VdsName} |
1105 | NETWORK_COMMINT_NETWORK_CHANGES_FAILED | Error | Failed to commit network changes on ${VdsName} |
1106 | NETWORK_HOST_USING_WRONG_CLUSER_VLAN | Warning | ${VdsName} is having wrong vlan id: ${VlanIdHost}, expected vlan id: ${VlanIdCluster} |
1107 | NETWORK_HOST_MISSING_CLUSER_VLAN | Warning | ${VdsName} is missing vlan id: ${VlanIdCluster} that is expected by the cluster |
1108 | VDS_NETWORK_MTU_DIFFER_FROM_LOGICAL_NETWORK | Info | |
1109 | BRIDGED_NETWORK_OVER_MULTIPLE_INTERFACES | Warning | Bridged network ${NetworkName} is attached to multiple interfaces: ${Interfaces} on Host ${VdsName}. |
1110 | VDS_NETWORKS_OUT_OF_SYNC | Warning | Host ${VdsName}'s following network(s) are not synchronized with their Logical Network configuration: ${Networks}. |
1112 | NETWORK_UPDTAE_NETWORK_ON_CLUSTER | Info | Network ${NetworkName} on Cluster ${ClusterName} updated. |
1113 | NETWORK_UPDTAE_NETWORK_ON_CLUSTER_FAILED | Error | Failed to update Network ${NetworkName} on Cluster ${ClusterName}. |
1114 | NETWORK_UPDATE_NETWORK | Info | Network ${NetworkName} was updated on Data Center: ${StoragePoolName} |
1115 | NETWORK_UPDATE_NETWORK_FAILED | Error | Failed to update Network ${NetworkName} on Data Center: ${StoragePoolName} |
1116 | NETWORK_UPDATE_VM_INTERFACE_LINK_UP | Info | Link State is UP. |
1117 | NETWORK_UPDATE_VM_INTERFACE_LINK_DOWN | Info | Link State is DOWN. |
1118 | INVALID_BOND_INTERFACE_FOR_MANAGEMENT_NETWORK_CONFIGURATION | Error | Failed to configure management network on host ${VdsName}. Host ${VdsName} has an invalid bond interface (${InterfaceName} contains less than 2 active slaves) for the management network configuration. |
1119 | VLAN_ID_MISMATCH_FOR_MANAGEMENT_NETWORK_CONFIGURATION | Error | Failed to configure management network on host ${VdsName}. Host ${VdsName} has an interface ${InterfaceName} for the management network configuration with VLAN-ID (${VlanId}), which is different from data-center definition (${MgmtVlanId}). |
1120 | SETUP_NETWORK_FAILED_FOR_MANAGEMENT_NETWORK_CONFIGURATION | Error | Failed to configure management network on host ${VdsName} due to setup networks failure. |
1121 | PERSIST_NETWORK_FAILED_FOR_MANAGEMENT_NETWORK | Warning | Failed to activate host ${VdsName} due to failure in persisting the management network configuration. |
1122 | ADD_VNIC_PROFILE | Info | VM network interface profile ${VnicProfileName} was added to network ${NetworkName} in Data Center: ${DataCenterName}. (User: ${UserName}) |
1123 | ADD_VNIC_PROFILE_FAILED | Error | Failed to add VM network interface profile ${VnicProfileName} to network ${NetworkName} in Data Center: ${DataCenterName} (User: ${UserName}) |
1124 | UPDATE_VNIC_PROFILE | Info | VM network interface profile ${VnicProfileName} was updated for network ${NetworkName} in Data Center: ${DataCenterName}. (User: ${UserName}) |
1125 | UPDATE_VNIC_PROFILE_FAILED | Error | Failed to update VM network interface profile ${VnicProfileName} for network ${NetworkName} in Data Center: ${DataCenterName}. (User: ${UserName}) |
1126 | REMOVE_VNIC_PROFILE | Info | VM network interface profile ${VnicProfileName} was removed from network ${NetworkName} in Data Center: ${DataCenterName}. (User: ${UserName}) |
1127 | REMOVE_VNIC_PROFILE_FAILED | Error | Failed to remove VM network interface profile ${VnicProfileName} from network ${NetworkName} in Data Center: ${DataCenterName}. (User: ${UserName}) |
1128 | NETWORK_WITHOUT_INTERFACES | Warning | Network ${NetworkName} is not attached to any interface on host ${VdsName}. |
1129 | VNIC_PROFILE_UNSUPPORTED_FEATURES | Warning | VM ${VmName} has network interface ${NicName} which is using profile ${VnicProfile} with unsupported feature(s) '${UnsupportedFeatures}' by VM cluster ${ClusterName} (version ${CompatibilityVersion}). |
1131 | REMOVE_NETWORK_BY_LABEL_FAILED | Error | Network ${Network} cannot be removed from the following hosts: ${HostNames} in data-center ${StoragePoolName}. |
1132 | LABEL_NETWORK | Info | Network ${NetworkName} was labeled ${Label} in data-center ${StoragePoolName}. |
1133 | LABEL_NETWORK_FAILED | Error | Failed to label network ${NetworkName} with label ${Label} in data-center ${StoragePoolName}. |
1134 | UNLABEL_NETWORK | Info | Network ${NetworkName} was unlabeled in data-center ${StoragePoolName}. |
1135 | UNLABEL_NETWORK_FAILED | Error | Failed to unlabel network ${NetworkName} in data-center ${StoragePoolName}. |
1136 | LABEL_NIC | Info | Network interface card ${NicName} was labeled ${Label} on host ${VdsName}. |
1137 | LABEL_NIC_FAILED | Error | Failed to label network interface card ${NicName} with label ${Label} on host ${VdsName}. |
1138 | UNLABEL_NIC | Info | Label ${Label} was removed from network interface card ${NicName} on host ${VdsName}. |
1139 | UNLABEL_NIC_FAILED | Error | Failed to remove label ${Label} from network interface card ${NicName} on host ${VdsName}. |
1140 | SUBNET_REMOVED | Info | Subnet ${SubnetName} was removed from provider ${ProviderName}. (User: ${UserName}) |
1141 | SUBNET_REMOVAL_FAILED | Error | Failed to remove subnet ${SubnetName} from provider ${ProviderName}. (User: ${UserName}) |
1142 | SUBNET_ADDED | Info | Subnet ${SubnetName} was added on provider ${ProviderName}. (User: ${UserName}) |
1143 | SUBNET_ADDITION_FAILED | Error | Failed to add subnet ${SubnetName} on provider ${ProviderName}. (User: ${UserName}) |
1144 | CONFIGURE_NETWORK_BY_LABELS_WHEN_CHANGING_CLUSTER_FAILED | Error | Failed to configure networks on host ${VdsName} while changing its cluster. |
1145 | PERSIST_NETWORK_ON_HOST | Info | (${Sequence}/${Total}): Applying changes for network(s) ${NetworkNames} on host ${VdsName}. (User: ${UserName}) |
1146 | PERSIST_NETWORK_ON_HOST_FINISHED | Info | (${Sequence}/${Total}): Successfully applied changes for network(s) ${NetworkNames} on host ${VdsName}. (User: ${UserName}) |
1147 | PERSIST_NETWORK_ON_HOST_FAILED | Error | (${Sequence}/${Total}): Failed to apply changes for network(s) ${NetworkNames} on host ${VdsName}. (User: ${UserName}) |
1148 | MULTI_UPDATE_NETWORK_NOT_POSSIBLE | Warning | Cannot apply network ${NetworkName} changes to hosts on unsupported data center ${StoragePoolName}. (User: ${UserName}) |
1149 | REMOVE_PORT_FROM_EXTERNAL_PROVIDER_FAILED | Warning | Failed to remove vNIC ${NicName} from external network provider ${ProviderName}. The vNIC can be identified on the provider by device id ${NicId}. |
1150 | IMPORTEXPORT_EXPORT_VM | Info | Vm ${VmName} was exported successfully to ${StorageDomainName} |
1151 | IMPORTEXPORT_EXPORT_VM_FAILED | Error | Failed to export Vm ${VmName} to ${StorageDomainName} |
1152 | IMPORTEXPORT_IMPORT_VM | Info | Vm ${VmName} was imported successfully to Data Center ${StoragePoolName}, Cluster ${ClusterName} |
1153 | IMPORTEXPORT_IMPORT_VM_FAILED | Error | Failed to import Vm ${VmName} to Data Center ${StoragePoolName}, Cluster ${ClusterName} |
1154 | IMPORTEXPORT_REMOVE_TEMPLATE | Info | Template ${VmTemplateName} was removed from ${StorageDomainName} |
1155 | IMPORTEXPORT_REMOVE_TEMPLATE_FAILED | Error | Failed to remove Template ${VmTemplateName} from ${StorageDomainName} |
1156 | IMPORTEXPORT_EXPORT_TEMPLATE | Info | Template ${VmTemplateName} was exported successfully to ${StorageDomainName} |
1157 | IMPORTEXPORT_EXPORT_TEMPLATE_FAILED | Error | Failed to export Template ${VmTemplateName} to ${StorageDomainName} |
1158 | IMPORTEXPORT_IMPORT_TEMPLATE | Info | Template ${VmTemplateName} was imported successfully to Data Center ${StoragePoolName}, Cluster ${ClusterName} |
1159 | IMPORTEXPORT_IMPORT_TEMPLATE_FAILED | Error | Failed to import Template ${VmTemplateName} to Data Center ${StoragePoolName}, Cluster ${ClusterName} |
1160 | IMPORTEXPORT_REMOVE_VM | Info | Vm ${VmName} was removed from ${StorageDomainName} |
1161 | IMPORTEXPORT_REMOVE_VM_FAILED | Error | Failed to remove Vm ${VmName} remove from ${StorageDomainName} |
1162 | IMPORTEXPORT_STARTING_EXPORT_VM | Info | Starting export Vm ${VmName} to ${StorageDomainName} |
1163 | IMPORTEXPORT_STARTING_IMPORT_TEMPLATE | Info | Starting to import Template ${VmTemplateName} to Data Center ${StoragePoolName}, Cluster ${ClusterName} |
1164 | IMPORTEXPORT_STARTING_EXPORT_TEMPLATE | Info | Starting to export Template ${VmTemplateName} to ${StorageDomainName} |
1165 | IMPORTEXPORT_STARTING_IMPORT_VM | Info | Starting to import Vm ${VmName} to Data Center ${StoragePoolName}, Cluster ${ClusterName} |
1166 | IMPORTEXPORT_STARTING_REMOVE_TEMPLATE | Info | Starting to remove Template ${VmTemplateName} remove ${StorageDomainName} |
1167 | IMPORTEXPORT_STARTING_REMOVE_VM | Info | Starting to remove Vm ${VmName} remove from ${StorageDomainName} |
1168 | IMPORTEXPORT_FAILED_TO_IMPORT_VM | Warning | Failed to read VM '${ImportedVmName}' OVF, it may be corrupted. Underlying error message: ${ErrorMessage} |
1169 | IMPORTEXPORT_FAILED_TO_IMPORT_TEMPLATE | Warning | Failed to read Template '${Template}' OVF, it may be corrupted. Underlying error message: ${ErrorMessage} |
1170 | IMPORTEXPORT_IMPORT_TEMPLATE_INVALID_INTERFACES | Normal | While importing Template ${EntityName}, the Network/s ${Networks} were found to be Non-VM Networks or do not exist in Cluster. Network Name was not set in the Interface/s ${Interfaces}. |
1171 | USER_ACCOUNT_PASSWORD_EXPIRED | Error | User ${UserName} cannot login, as the user account password has expired. Please contact the system administrator. |
1172 | AUTH_FAILED_INVALID_CREDENTIALS | Error | User ${UserName} cannot login, please verify the username and password. |
1173 | AUTH_FAILED_CLOCK_SKEW_TOO_GREAT | Error | User ${UserName} cannot login, the engine clock is not synchronized with directory services. Please contact the system administrator. |
1174 | AUTH_FAILED_NO_KDCS_FOUND | Error | User ${UserName} cannot login, authentication domain cannot be found. Please contact the system administrator. |
1175 | AUTH_FAILED_DNS_ERROR | Error | User ${UserName} cannot login, there's an error in DNS configuration. Please contact the system administrator. |
1176 | AUTH_FAILED_OTHER | Error | User ${UserName} cannot login, unknown kerberos error. Please contact the system administrator. |
1177 | AUTH_FAILED_DNS_COMMUNICATION_ERROR | Error | User ${UserName} cannot login, cannot lookup DNS for SRV records. Please contact the system administrator. |
1178 | AUTH_FAILED_CONNECTION_TIMED_OUT | Error | User ${UserName} cannot login, connection to LDAP server has timed out. Please contact the system administrator. |
1179 | AUTH_FAILED_WRONG_REALM | Error | User ${UserName} cannot login, please verify your domain name. |
1180 | AUTH_FAILED_CONNECTION_ERROR | Error | User ${UserName} cannot login, connection refused or some configuration problems exist. Possible DNS error. Please contact the system administrator. |
1181 | AUTH_FAILED_CANNOT_FIND_LDAP_SERVER_FOR_DOMAIN | Error | User ${UserName} cannot login, cannot find valid LDAP server for domain. Please contact the system administrator. |
1182 | AUTH_FAILED_NO_USER_INFORMATION_WAS_FOUND | Error | User ${UserName} cannot login, no user information was found. Please contact the system administrator. |
1183 | AUTH_FAILED_CLIENT_NOT_FOUND_IN_KERBEROS_DATABASE | Error | User ${UserName} cannot login, user was not found in domain. Please contact the system administrator. |
1184 | AUTH_FAILED_INTERNAL_KERBEROS_ERROR | Error | User ${UserName} cannot login, an internal error has ocurred in the Kerberos implementation of the JVM. Please contact the system administrator. |
1185 | USER_ACCOUNT_EXPIRED | Error | The account for ${UserName} got expired. Please contact the system administrator. |
1186 | IMPORTEXPORT_NO_PROXY_HOST_AVAILABLE_IN_DC | Error | No Host in Data Center '${StoragePoolName}' can serve as a proxy to retrieve remote VMs information (User: ${UserName}). |
1187 | IMPORTEXPORT_HOST_CANNOT_SERVE_AS_PROXY | Error | Host ${VdsName} cannot be used as a proxy to retrieve remote VMs information since it is not up (User: ${UserName}). |
1188 | IMPORTEXPORT_PARTIAL_VM_DISKS_NOT_EXISTS | Warning | The following disks could not be verified and will not be part of the imported VM ${VmName}: '${DiskAliases}' (User: ${UserName}). |
1189 | IMPORTEXPORT_IMPORT_VM_FAILED_UPDATING_OVF | Error | Failed to import Vm ${VmName} to Data Center ${StoragePoolName}, Cluster ${ClusterName}, could not update VM data in export. |
1190 | USER_RESTORE_FROM_SNAPSHOT_START | Info | Restoring VM ${VmName} from snapshot started by user ${UserName}. |
1191 | VM_DISK_ALREADY_CHANGED | Info | CD ${DiskName} is already inserted to VM ${VmName}, disk change action was skipped. User: ${UserName}. |
1192 | VM_DISK_ALREADY_EJECTED | Info | CD is already ejected from VM ${VmName}, disk change action was skipped. User: ${UserName}. |
1193 | IMPORTEXPORT_STARTING_CONVERT_VM | Info | Starting to convert Vm ${VmName} |
1194 | IMPORTEXPORT_CONVERT_FAILED | Info | Failed to convert Vm ${VmName} |
1195 | IMPORTEXPORT_CANNOT_GET_OVF | Info | Failed to get the configuration of converted Vm ${VmName} |
1196 | IMPORTEXPORT_INVALID_OVF | Info | Failed to process the configuration of converted Vm ${VmName} |
1197 | IMPORTEXPORT_PARTIAL_TEMPLATE_DISKS_NOT_EXISTS | Warning | The following disks could not be verified and will not be part of the imported Template ${VmTemplateName}: '${DiskAliases}' (User: ${UserName}). |
1200 | ENTITY_RENAMED | Info | ${EntityType} ${OldEntityName} was renamed from ${OldEntityName} to ${NewEntityName} by ${UserName}. |
1201 | UPDATE_HOST_NIC_VFS_CONFIG | Info | The VFs configuration of network interface card ${NicName} on host ${VdsName} was updated. |
1202 | UPDATE_HOST_NIC_VFS_CONFIG_FAILED | Error | Failed to update the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1203 | ADD_VFS_CONFIG_NETWORK | Info | Network ${NetworkName} was added to the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1204 | ADD_VFS_CONFIG_NETWORK_FAILED | Info | Failed to add ${NetworkName} to the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1205 | REMOVE_VFS_CONFIG_NETWORK | Info | Network ${NetworkName} was removed from the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1206 | REMOVE_VFS_CONFIG_NETWORK_FAILED | Info | Failed to remove ${NetworkName} from the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1207 | ADD_VFS_CONFIG_LABEL | Info | Label ${Label} was added to the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1208 | ADD_VFS_CONFIG_LABEL_FAILED | Info | Failed to add ${Label} to the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1209 | REMOVE_VFS_CONFIG_LABEL | Info | Label ${Label} was removed from the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1210 | REMOVE_VFS_CONFIG_LABEL_FAILED | Info | Failed to remove ${Label} from the VFs configuration of network interface card ${NicName} on host ${VdsName}. |
1211 | USER_REDUCE_DOMAIN_DEVICES_STARTED | Info | Started to reduce Storage ${StorageDomainName} devices. (User: ${UserName}). |
1212 | USER_REDUCE_DOMAIN_DEVICES_FAILED_METADATA_DEVICES | Error | Failed to reduce Storage ${StorageDomainName}. The following devices contains the domain metadata ${deviceIds} and can't be reduced from the domain. (User: ${UserName}). |
1213 | USER_REDUCE_DOMAIN_DEVICES_FAILED | Error | Failed to reduce Storage ${StorageDomainName}. (User: ${UserName}). |
1214 | USER_REDUCE_DOMAIN_DEVICES_SUCCEEDED | Info | Storage ${StorageDomainName} has been reduced. (User: ${UserName}). |
1215 | USER_REDUCE_DOMAIN_DEVICES_FAILED_NO_FREE_SPACE | Error | Can't reduce Storage ${StorageDomainName}. There is not enough space on the destination devices of the storage domain. (User: ${UserName}). |
1216 | USER_REDUCE_DOMAIN_DEVICES_FAILED_TO_GET_DOMAIN_INFO | Error | Can't reduce Storage ${StorageDomainName}. Failed to get the domain info. (User: ${UserName}). |
1217 | CANNOT_IMPORT_VM_WITH_LEASE_COMPAT_VERSION | Warning | The VM ${VmName} has a VM lease defined yet will be imported without it as the VM compatibility version does not support VM leases. |
1218 | CANNOT_IMPORT_VM_WITH_LEASE_STORAGE_DOMAIN | Warning | The VM ${VmName} has a VM lease defined yet will be imported without it as the Storage Domain for the lease does not exist or is not active. |
1300 | NUMA_ADD_VM_NUMA_NODE_SUCCESS | Info | Add VM NUMA node successfully. |
1301 | NUMA_ADD_VM_NUMA_NODE_FAILED | Error | Add VM NUMA node failed. |
1310 | NUMA_UPDATE_VM_NUMA_NODE_SUCCESS | Info | Update VM NUMA node successfully. |
1311 | NUMA_UPDATE_VM_NUMA_NODE_FAILED | Error | Update VM NUMA node failed. |
1320 | NUMA_REMOVE_VM_NUMA_NODE_SUCCESS | Info | Remove VM NUMA node successfully. |
1321 | NUMA_REMOVE_VM_NUMA_NODE_FAILED | Error | Remove VM NUMA node failed. |
1322 | USER_ADD_VM_TEMPLATE_CREATE_TEMPLATE_FAILURE | Error | Failed to create Template ${VmTemplateName} or its disks from VM ${VmName}. |
1323 | USER_ADD_VM_TEMPLATE_ASSIGN_ILLEGAL_FAILURE | Error | Failed preparing Template ${VmTemplateName} for sealing (VM: ${VmName}). |
1324 | USER_ADD_VM_TEMPLATE_SEAL_FAILURE | Error | Failed to seal Template ${VmTemplateName} (VM: ${VmName}). |
1325 | USER_SPARSIFY_IMAGE_START | Info | Started to sparsify ${DiskAlias} |
1326 | USER_SPARSIFY_IMAGE_FINISH_SUCCESS | Info | ${DiskAlias} sparsified successfully. |
1327 | USER_SPARSIFY_IMAGE_FINISH_FAILURE | Error | Failed to sparsify ${DiskAlias}. |
1328 | USER_AMEND_IMAGE_START | Info | Started to amend ${DiskAlias} |
1329 | USER_AMEND_IMAGE_FINISH_SUCCESS | Info | ${DiskAlias} has been amended successfully. |
1330 | USER_AMEND_IMAGE_FINISH_FAILURE | Error | Failed to amend ${DiskAlias}. |
1402 | USER_LOGIN_ON_BEHALF_FAILED | Error | Failed to execute login on behalf - ${LoginOnBehalfLogInfo}. |
2000 | USER_HOTPLUG_DISK | Info | VM ${VmName} disk ${DiskAlias} was plugged by ${UserName}. |
2001 | USER_FAILED_HOTPLUG_DISK | Error | Failed to plug disk ${DiskAlias} to VM ${VmName} (User: ${UserName}). |
2002 | USER_HOTUNPLUG_DISK | Info | VM ${VmName} disk ${DiskAlias} was unplugged by ${UserName}. |
2003 | USER_FAILED_HOTUNPLUG_DISK | Error | Failed to unplug disk ${DiskAlias} from VM ${VmName} (User: ${UserName}). |
2004 | USER_COPIED_DISK | Info | User ${UserName} is copying disk ${DiskAlias} to domain ${StorageDomainName}. |
2005 | USER_FAILED_COPY_DISK | Error | User ${UserName} failed to copy disk ${DiskAlias} to domain ${StorageDomainName}. |
2006 | USER_COPIED_DISK_FINISHED_SUCCESS | Info | User ${UserName} finished copying disk ${DiskAlias} to domain ${StorageDomainName}. |
2007 | USER_COPIED_DISK_FINISHED_FAILURE | Error | User ${UserName} finished with error copying disk ${DiskAlias} to domain ${StorageDomainName}. |
2008 | USER_MOVED_DISK | Info | User ${UserName} moving disk ${DiskAlias} to domain ${StorageDomainName}. |
2009 | USER_FAILED_MOVED_VM_DISK | Error | User ${UserName} failed to move disk ${DiskAlias} to domain ${StorageDomainName}. |
2010 | USER_MOVED_DISK_FINISHED_SUCCESS | Info | User ${UserName} finished moving disk ${DiskAlias} to domain ${StorageDomainName}. |
2011 | USER_MOVED_DISK_FINISHED_FAILURE | Error | User ${UserName} have failed to move disk ${DiskAlias} to domain ${StorageDomainName}. |
2012 | USER_FINISHED_REMOVE_DISK_NO_DOMAIN | Info | Disk ${DiskAlias} was successfully removed (User ${UserName}). |
2013 | USER_FINISHED_FAILED_REMOVE_DISK_NO_DOMAIN | Warning | Failed to remove disk ${DiskAlias} (User ${UserName}). |
2014 | USER_FINISHED_REMOVE_DISK | Info | Disk ${DiskAlias} was successfully removed from domain ${StorageDomainName} (User ${UserName}). |
2015 | USER_FINISHED_FAILED_REMOVE_DISK | Warning | Failed to remove disk ${DiskAlias} from storage domain ${StorageDomainName} (User: ${UserName}). |
2016 | USER_ATTACH_DISK_TO_VM | Info | Disk ${DiskAlias} was successfully attached to VM ${VmName} by ${UserName}. |
2017 | USER_FAILED_ATTACH_DISK_TO_VM | Error | Failed to attach Disk ${DiskAlias} to VM ${VmName} (User: ${UserName}). |
2018 | USER_DETACH_DISK_FROM_VM | Info | Disk ${DiskAlias} was successfully detached from VM ${VmName} by ${UserName}. |
2019 | USER_FAILED_DETACH_DISK_FROM_VM | Error | Failed to detach Disk ${DiskAlias} from VM ${VmName} (User: ${UserName}). |
2020 | USER_ADD_DISK | Info | Add-Disk operation of '${DiskAlias}' was initiated by ${UserName}. |
2021 | USER_ADD_DISK_FINISHED_SUCCESS | Info | The disk '${DiskAlias}' was successfully added. |
2022 | USER_ADD_DISK_FINISHED_FAILURE | Error | Add-Disk operation failed to complete. |
2023 | USER_FAILED_ADD_DISK | Error | Add-Disk operation failed (User: ${UserName}). |
2024 | USER_RUN_UNLOCK_ENTITY_SCRIPT | Info | |
2025 | USER_MOVE_IMAGE_GROUP_FAILED_TO_DELETE_SRC_IMAGE | Warning | Possible failure while deleting ${DiskAlias} from the source Storage Domain ${StorageDomainName} during the move operation. The Storage Domain may be manually cleaned-up from possible leftovers (User:${UserName}). |
2026 | USER_MOVE_IMAGE_GROUP_FAILED_TO_DELETE_DST_IMAGE | Warning | Possible failure while clearing possible leftovers of ${DiskAlias} from the target Storage Domain ${StorageDomainName} after the move operation failed to copy the image to it properly. The Storage Domain may be manually cleaned-up from possible leftovers (User:${UserName}). |
2027 | USER_IMPORT_IMAGE | Info | User ${UserName} importing image ${RepoImageName} to domain ${StorageDomainName}. |
2028 | USER_IMPORT_IMAGE_FINISHED_SUCCESS | Info | User ${UserName} successfully imported image ${RepoImageName} to domain ${StorageDomainName}. |
2029 | USER_IMPORT_IMAGE_FINISHED_FAILURE | Error | User ${UserName} failed to import image ${RepoImageName} to domain ${StorageDomainName}. |
2030 | USER_EXPORT_IMAGE | Info | User ${UserName} exporting image ${RepoImageName} to domain ${DestinationStorageDomainName}. |
2031 | USER_EXPORT_IMAGE_FINISHED_SUCCESS | Info | User ${UserName} successfully exported image ${RepoImageName} to domain ${DestinationStorageDomainName}. |
2032 | USER_EXPORT_IMAGE_FINISHED_FAILURE | Error | User ${UserName} failed to export image ${RepoImageName} to domain ${DestinationStorageDomainName}. |
2033 | HOT_SET_NUMBER_OF_CPUS | Info | Hotplug CPU: changed the number of CPUs on VM ${vmName} from ${previousNumberOfCpus} to ${numberOfCpus} |
2034 | FAILED_HOT_SET_NUMBER_OF_CPUS | Error | Failed to hot set number of CPUS to VM ${vmName}. Underlying error message: ${ErrorMessage} |
2035 | USER_ISCSI_BOND_HOST_RESTART_WARNING | Warning | The following Networks has been removed from the iSCSI bond ${IscsiBondName}: ${NetworkNames}. for those changes to take affect, the hosts must be moved to maintenance and activated again. |
2036 | ADD_DISK_INTERNAL | Info | Add-Disk operation of '${DiskAlias}' was initiated by the system. |
2037 | ADD_DISK_INTERNAL_FAILURE | Info | Add-Disk operation of '${DiskAlias}' failed to complete. |
2038 | USER_REMOVE_DISK_INITIATED | Info | Removal of Disk ${DiskAlias} from domain ${StorageDomainName} was initiated by ${UserName}. |
2039 | HOT_SET_MEMORY | Info | Hotset memory: changed the amount of memory on VM ${vmName} from ${previousMem} to ${newMem} |
2040 | FAILED_HOT_SET_MEMORY | Error | Failed to hot set memory to VM ${vmName}. Underlying error message: ${ErrorMessage} |
2041 | DISK_PREALLOCATION_FAILED | Error | |
2042 | USER_FINISHED_REMOVE_DISK_ATTACHED_TO_VMS | Info | Disk ${DiskAlias} associated to the VMs ${VmNames} was successfully removed from domain ${StorageDomainName} (User ${UserName}). |
2043 | USER_FINISHED_REMOVE_DISK_ATTACHED_TO_VMS_NO_DOMAIN | Info | Disk ${DiskAlias} associated to the VMs ${VmNames} was successfully removed (User ${UserName}). |
2044 | USER_REMOVE_DISK_ATTACHED_TO_VMS_INITIATED | Info | Removal of Disk ${DiskAlias} associated to the VMs ${VmNames} from domain ${StorageDomainName} was initiated by ${UserName}. |
2045 | USER_COPY_IMAGE_GROUP_FAILED_TO_DELETE_DST_IMAGE | Warning | Possible failure while clearing possible leftovers of ${DiskAlias} from the target Storage Domain ${StorageDomainName} after the operation failed. The Storage Domain may be manually cleaned-up from possible leftovers (User:${UserName}). |
3000 | USER_ADD_QUOTA | Info | Quota ${QuotaName} has been added by ${UserName}. |
3001 | USER_FAILED_ADD_QUOTA | Error | Failed to add Quota ${QuotaName}. The operation was initiated by ${UserName}. |
3002 | USER_UPDATE_QUOTA | Info | Quota ${QuotaName} has been updated by ${UserName}. |
3003 | USER_FAILED_UPDATE_QUOTA | Error | Failed to update Quota ${QuotaName}. The operation was initiated by ${UserName}.. |
3004 | USER_DELETE_QUOTA | Info | Quota ${QuotaName} has been deleted by ${UserName}. |
3005 | USER_FAILED_DELETE_QUOTA | Error | Failed to delete Quota ${QuotaName}. The operation was initiated by ${UserName}.. |
3006 | USER_EXCEEDED_QUOTA_CLUSTER_GRACE_LIMIT | Error | Cluster-Quota ${QuotaName} limit exceeded and operation was blocked. Utilization: ${Utilization}, Requested: ${Requested} - Please select a different quota or contact your administrator to extend the quota. |
3007 | USER_EXCEEDED_QUOTA_CLUSTER_LIMIT | Warning | Cluster-Quota ${QuotaName} limit exceeded and entered the grace zone. Utilization: ${Utilization} (It is advised to select a different quota or contact your administrator to extend the quota). |
3008 | USER_EXCEEDED_QUOTA_CLUSTER_THRESHOLD | Warning | Cluster-Quota ${QuotaName} is about to exceed. Utilization: ${Utilization} |
3009 | USER_EXCEEDED_QUOTA_STORAGE_GRACE_LIMIT | Error | Storage-Quota ${QuotaName} limit exceeded and operation was blocked. Utilization(used/requested): ${CurrentStorage}%/${Requested}% - Please select a different quota or contact your administrator to extend the quota. |
3010 | USER_EXCEEDED_QUOTA_STORAGE_LIMIT | Warning | Storage-Quota ${QuotaName} limit exceeded and entered the grace zone. Utilization: ${CurrentStorage}% (It is advised to select a different quota or contact your administrator to extend the quota). |
3011 | USER_EXCEEDED_QUOTA_STORAGE_THRESHOLD | Warning | Storage-Quota ${QuotaName} is about to exceed. Utilization: ${CurrentStorage}% |
3012 | QUOTA_STORAGE_RESIZE_LOWER_THEN_CONSUMPTION | Warning | Storage-Quota ${QuotaName}: the new size set for this quota is less than current disk utilization. |
3013 | MISSING_QUOTA_STORAGE_PARAMETERS_PERMISSIVE_MODE | Warning | Missing Quota for Disk, proceeding since in Permissive (Audit) mode. |
3014 | MISSING_QUOTA_CLUSTER_PARAMETERS_PERMISSIVE_MODE | Warning | Missing Quota for VM ${VmName}, proceeding since in Permissive (Audit) mode. |
3015 | USER_EXCEEDED_QUOTA_CLUSTER_GRACE_LIMIT_PERMISSIVE_MODE | Warning | Cluster-Quota ${QuotaName} limit exceeded, proceeding since in Permissive (Audit) mode. Utilization: ${Utilization}, Requested: ${Requested} - Please select a different quota or contact your administrator to extend the quota. |
3016 | USER_EXCEEDED_QUOTA_STORAGE_GRACE_LIMIT_PERMISSIVE_MODE | Warning | Storage-Quota ${QuotaName} limit exceeded, proceeding since in Permissive (Audit) mode. Utilization(used/requested): ${CurrentStorage}%/${Requested}% - Please select a different quota or contact your administrator to extend the quota. |
3017 | USER_IMPORT_IMAGE_AS_TEMPLATE | Info | User ${UserName} importing image ${RepoImageName} as template ${TemplateName} to domain ${StorageDomainName}. |
3018 | USER_IMPORT_IMAGE_AS_TEMPLATE_FINISHED_SUCCESS | Info | User ${UserName} successfully imported image ${RepoImageName} as template ${TemplateName} to domain ${StorageDomainName}. |
3019 | USER_IMPORT_IMAGE_AS_TEMPLATE_FINISHED_FAILURE | Error | User ${UserName} failed to import image ${RepoImageName} as template ${TemplateName} to domain ${StorageDomainName}. |
4000 | GLUSTER_VOLUME_CREATE | Info | Gluster Volume ${glusterVolumeName} created on cluster ${clusterName}. |
4001 | GLUSTER_VOLUME_CREATE_FAILED | Error | Creation of Gluster Volume ${glusterVolumeName} failed on cluster ${clusterName}. |
4002 | GLUSTER_VOLUME_OPTION_ADDED | Info | Volume Option ${Key} |
4003 | GLUSTER_VOLUME_OPTION_SET_FAILED | Error | Volume Option ${Key} |
4004 | GLUSTER_VOLUME_START | Info | Gluster Volume ${glusterVolumeName} of cluster ${clusterName} started. |
4005 | GLUSTER_VOLUME_START_FAILED | Error | Could not start Gluster Volume ${glusterVolumeName} of cluster ${clusterName}. |
4006 | GLUSTER_VOLUME_STOP | Info | Gluster Volume ${glusterVolumeName} stopped on cluster ${clusterName}. |
4007 | GLUSTER_VOLUME_STOP_FAILED | Error | Could not stop Gluster Volume ${glusterVolumeName} on cluster ${clusterName}. |
4008 | GLUSTER_VOLUME_OPTIONS_RESET | Info | Volume Option ${Key} |
4009 | GLUSTER_VOLUME_OPTIONS_RESET_FAILED | Error | Could not reset Gluster Volume ${glusterVolumeName} Options on cluster ${clusterName}. |
4010 | GLUSTER_VOLUME_DELETE | Info | Gluster Volume ${glusterVolumeName} deleted on cluster ${clusterName}. |
4011 | GLUSTER_VOLUME_DELETE_FAILED | Error | Could not delete Gluster Volume ${glusterVolumeName} on cluster ${clusterName}. |
4012 | GLUSTER_VOLUME_REBALANCE_START | Info | Gluster Volume ${glusterVolumeName} rebalance started on cluster ${clusterName}. |
4013 | GLUSTER_VOLUME_REBALANCE_START_FAILED | Error | Could not start Gluster Volume ${glusterVolumeName} rebalance on cluster ${clusterName}. |
4014 | GLUSTER_VOLUME_REMOVE_BRICKS | Info | Bricks removed from Gluster Volume ${glusterVolumeName} of cluster ${clusterName}. |
4015 | GLUSTER_VOLUME_REMOVE_BRICKS_FAILED | Error | Could not remove bricks from Gluster Volume ${glusterVolumeName} of cluster ${clusterName}. |
4016 | GLUSTER_VOLUME_REPLACE_BRICK_FAILED | Error | Replace Gluster Volume ${glusterVolumeName} Brick failed on cluster ${clusterName} |
4017 | GLUSTER_VOLUME_REPLACE_BRICK_START | Info | Gluster Volume ${glusterVolumeName} Replace Brick started on cluster ${clusterName}. |
4018 | GLUSTER_VOLUME_REPLACE_BRICK_START_FAILED | Error | Could not start Gluster Volume ${glusterVolumeName} Replace Brick on cluster ${clusterName}. |
4019 | GLUSTER_VOLUME_ADD_BRICK | Info | ${NoOfBricks} brick(s) added to volume ${glusterVolumeName} of cluster ${clusterName}. |
4020 | GLUSTER_VOLUME_ADD_BRICK_FAILED | Error | Failed to add bricks to the Gluster Volume ${glusterVolumeName} of cluster ${clusterName}. |
4021 | GLUSTER_SERVER_REMOVE_FAILED | Error | Failed to remove host ${VdsName} from Cluster ${ClusterName}. |
4022 | GLUSTER_VOLUME_PROFILE_START | Info | Gluster Volume ${glusterVolumeName} profiling started on cluster ${clusterName}. |
4023 | GLUSTER_VOLUME_PROFILE_START_FAILED | Error | Could not start profiling on gluster volume ${glusterVolumeName} of cluster ${clusterName} |
4024 | GLUSTER_VOLUME_PROFILE_STOP | Info | Gluster Volume ${glusterVolumeName} profiling stopped on cluster ${clusterName}. |
4025 | GLUSTER_VOLUME_PROFILE_STOP_FAILED | Error | Could not stop Profiling on gluster volume ${glusterVolumeName} of cluster ${clusterName}. |
4026 | GLUSTER_VOLUME_CREATED_FROM_CLI | Warning | Detected new volume ${glusterVolumeName} on cluster ${ClusterName}, and added it to engine DB. |
4027 | GLUSTER_VOLUME_DELETED_FROM_CLI | Info | Detected deletion of volume ${glusterVolumeName} on cluster ${ClusterName}, and deleted it from engine DB. |
4028 | GLUSTER_VOLUME_OPTION_SET_FROM_CLI | Warning | Detected new option ${key} |
4029 | GLUSTER_VOLUME_OPTION_RESET_FROM_CLI | Warning | Detected option ${key} |
4030 | GLUSTER_VOLUME_PROPERTIES_CHANGED_FROM_CLI | Warning | Detected changes in properties of volume ${glusterVolumeName} of cluster ${ClusterName}, and updated the same in engine DB. |
4031 | GLUSTER_VOLUME_BRICK_ADDED_FROM_CLI | Warning | Detected new brick ${brick} on volume ${glusterVolumeName} of cluster ${ClusterName}, and added it to engine DB. |
4032 | GLUSTER_VOLUME_BRICK_REMOVED_FROM_CLI | Info | Detected brick ${brick} removed from Volume ${glusterVolumeName} of cluster ${ClusterName}, and removed it from engine DB. |
4033 | GLUSTER_SERVER_REMOVED_FROM_CLI | Info | Detected server ${VdsName} removed from Cluster ${ClusterName}, and removed it from engine DB. |
4034 | GLUSTER_VOLUME_INFO_FAILED | Error | Failed to fetch gluster volume list from server ${VdsName}. |
4035 | GLUSTER_COMMAND_FAILED | Error | Gluster command [${Command}] failed on server ${Server}. |
4038 | GLUSTER_SERVER_REMOVE | Info | Host ${VdsName} removed from Cluster ${ClusterName}. |
4039 | GLUSTER_VOLUME_STARTED_FROM_CLI | Warning | Detected that Volume ${glusterVolumeName} of Cluster ${ClusterName} was started, and updated engine DB with it's new status. |
4040 | GLUSTER_VOLUME_STOPPED_FROM_CLI | Warning | Detected that Volume ${glusterVolumeName} of Cluster ${ClusterName} was stopped, and updated engine DB with it's new status. |
4041 | GLUSTER_VOLUME_OPTION_CHANGED_FROM_CLI | Info | Detected change in value of option ${key} from ${oldValue} to ${newValue} on volume ${glusterVolumeName} of cluster ${ClusterName}, and updated it to engine DB. |
4042 | GLUSTER_HOOK_ENABLE | Info | Gluster Hook ${GlusterHookName} enabled on cluster ${ClusterName}. |
4043 | GLUSTER_HOOK_ENABLE_FAILED | Error | Failed to enable Gluster Hook ${GlusterHookName} on cluster ${ClusterName}. ${FailureMessage} |
4044 | GLUSTER_HOOK_ENABLE_PARTIAL | Warning | Gluster Hook ${GlusterHookName} enabled on some of the servers on cluster ${ClusterName}. ${FailureMessage} |
4045 | GLUSTER_HOOK_DISABLE | Info | Gluster Hook ${GlusterHookName} disabled on cluster ${ClusterName}. |
4046 | GLUSTER_HOOK_DISABLE_FAILED | Error | Failed to disable Gluster Hook ${GlusterHookName} on cluster ${ClusterName}. ${FailureMessage} |
4047 | GLUSTER_HOOK_DISABLE_PARTIAL | Warning | Gluster Hook ${GlusterHookName} disabled on some of the servers on cluster ${ClusterName}. ${FailureMessage} |
4048 | GLUSTER_HOOK_LIST_FAILED | Error | Failed to retrieve hook list from ${VdsName} of Cluster ${ClusterName}. |
4049 | GLUSTER_HOOK_CONFLICT_DETECTED | Warning | Detected conflict in hook ${HookName} of Cluster ${ClusterName}. |
4050 | GLUSTER_HOOK_DETECTED_NEW | Info | Detected new hook ${HookName} in Cluster ${ClusterName}. |
4051 | GLUSTER_HOOK_DETECTED_DELETE | Info | Detected removal of hook ${HookName} in Cluster ${ClusterName}. |
4052 | GLUSTER_VOLUME_OPTION_MODIFIED | Info | Volume Option ${Key} changed to ${Value} from ${oldvalue} on ${glusterVolumeName} of cluster ${clusterName}. |
4053 | GLUSTER_HOOK_GETCONTENT_FAILED | Error | Failed to read content of hook ${HookName} in Cluster ${ClusterName}. |
4054 | GLUSTER_SERVICES_LIST_FAILED | Error | Could not fetch statuses of services from server ${VdsName}. Updating statuses of all services on this server to UNKNOWN. |
4055 | GLUSTER_SERVICE_TYPE_ADDED_TO_CLUSTER | Info | Service type ${ServiceType} was not mapped to cluster ${ClusterName}. Mapped it now. |
4056 | GLUSTER_CLUSTER_SERVICE_STATUS_CHANGED | Info | Status of service type ${ServiceType} changed from ${OldStatus} to ${NewStatus} on cluster ${ClusterName} |
4057 | GLUSTER_SERVICE_ADDED_TO_SERVER | Info | Service ${ServiceName} was not mapped to server ${VdsName}. Mapped it now. |
4058 | GLUSTER_SERVER_SERVICE_STATUS_CHANGED | Info | Status of service ${ServiceName} on server ${VdsName} changed from ${OldStatus} to ${NewStatus}. Updating in engine now. |
4059 | GLUSTER_HOOK_UPDATED | Info | Gluster Hook ${GlusterHookName} updated on conflicting servers. |
4060 | GLUSTER_HOOK_UPDATE_FAILED | Error | Failed to update Gluster Hook ${GlusterHookName} on conflicting servers. ${FailureMessage} |
4061 | GLUSTER_HOOK_ADDED | Info | Gluster Hook ${GlusterHookName} added on conflicting servers. |
4062 | GLUSTER_HOOK_ADD_FAILED | Error | Failed to add Gluster Hook ${GlusterHookName} on conflicting servers. ${FailureMessage} |
4063 | GLUSTER_HOOK_REMOVED | Info | Gluster Hook ${GlusterHookName} removed from all servers in cluster ${ClusterName}. |
4064 | GLUSTER_HOOK_REMOVE_FAILED | Error | Failed to remove Gluster Hook ${GlusterHookName} from cluster ${ClusterName}. ${FailureMessage} |
4065 | GLUSTER_HOOK_REFRESH | Info | Refreshed gluster hooks in Cluster ${ClusterName}. |
4066 | GLUSTER_HOOK_REFRESH_FAILED | Error | Failed to refresh gluster hooks in Cluster ${ClusterName}. |
4067 | GLUSTER_SERVICE_STARTED | Info | ${servicetype} service started on host ${VdsName} of cluster ${ClusterName}. |
4068 | GLUSTER_SERVICE_START_FAILED | Error | Could not start ${servicetype} service on host ${VdsName} of cluster ${ClusterName}. |
4069 | GLUSTER_SERVICE_STOPPED | Info | ${servicetype} services stopped on host ${VdsName} of cluster ${ClusterName}. |
4070 | GLUSTER_SERVICE_STOP_FAILED | Error | Could not stop ${servicetype} service on host ${VdsName} of cluster ${ClusterName}. |
4071 | GLUSTER_SERVICES_LIST_NOT_FETCHED | Info | Could not fetch list of services from ${ServiceGroupType} named ${ServiceGroupName}. |
4072 | GLUSTER_SERVICE_RESTARTED | Info | ${servicetype} service re-started on host ${VdsName} of cluster ${ClusterName}. |
4073 | GLUSTER_SERVICE_RESTART_FAILED | Error | Could not re-start ${servicetype} service on host ${VdsName} of cluster ${ClusterName}. |
4074 | GLUSTER_VOLUME_OPTIONS_RESET_ALL | Info | All Volume Options reset on ${glusterVolumeName} of cluster ${clusterName}. |
4075 | GLUSTER_HOST_UUID_NOT_FOUND | Error | Could not find gluster uuid of server ${VdsName} on Cluster ${ClusterName}. |
4076 | GLUSTER_VOLUME_BRICK_ADDED | Info | Brick [${brickpath}] on host [${servername}] added to volume [${glusterVolumeName}] of cluster ${clusterName} |
4077 | GLUSTER_CLUSTER_SERVICE_STATUS_ADDED | Info | Status of service type ${ServiceType} set to ${NewStatus} on cluster ${ClusterName} |
4078 | GLUSTER_VOLUME_REBALANCE_STOP | Info | Gluster Volume ${glusterVolumeName} rebalance stopped of cluster ${clusterName}. |
4079 | GLUSTER_VOLUME_REBALANCE_STOP_FAILED | Error | Could not stop rebalance of gluster volume ${glusterVolumeName} of cluster ${clusterName}. |
4080 | START_REMOVING_GLUSTER_VOLUME_BRICKS | Info | Started removing bricks from Volume ${glusterVolumeName} of cluster ${clusterName} |
4081 | START_REMOVING_GLUSTER_VOLUME_BRICKS_FAILED | Error | Could not start remove bricks from Volume ${glusterVolumeName} of cluster ${clusterName} |
4082 | GLUSTER_VOLUME_REMOVE_BRICKS_STOP | Info | Stopped removing bricks from Volume ${glusterVolumeName} of cluster ${clusterName} |
4083 | GLUSTER_VOLUME_REMOVE_BRICKS_STOP_FAILED | Error | Failed to stop remove bricks from Volume ${glusterVolumeName} of cluster ${clusterName} |
4084 | GLUSTER_VOLUME_REMOVE_BRICKS_COMMIT | Info | Gluster volume ${glusterVolumeName} remove bricks committed on cluster ${clusterName}. ${NoOfBricks} brick(s) removed from volume ${glusterVolumeName}. |
4085 | GLUSTER_VOLUME_REMOVE_BRICKS_COMMIT_FAILED | Error | Gluster volume ${glusterVolumeName} remove bricks could not be commited on cluster ${clusterName} |
4086 | GLUSTER_BRICK_STATUS_CHANGED | Warning | Detected change in status of brick ${brickpath} of volume ${glusterVolumeName} of cluster ${clusterName} from ${oldValue} to ${newValue} . |
4087 | GLUSTER_VOLUME_REBALANCE_FINISHED | Info | ${action} ${status} on volume ${glusterVolumeName} of cluster ${clusterName}. |
4088 | GLUSTER_VOLUME_MIGRATE_BRICK_DATA_FINISHED | Info | ${action} ${status} for brick(s) on volume ${glusterVolumeName} of cluster ${clusterName}. Please review to abort or commit. |
4089 | GLUSTER_VOLUME_REBALANCE_START_DETECTED_FROM_CLI | Info | Detected start of rebalance on volume ${glusterVolumeName} of Cluster ${ClusterName} from CLI. |
4090 | START_REMOVING_GLUSTER_VOLUME_BRICKS_DETECTED_FROM_CLI | Info | Detected start of brick removal for bricks ${brick} on volume ${glusterVolumeName} of Cluster ${ClusterName} from CLI. |
4091 | GLUSTER_VOLUME_REBALANCE_NOT_FOUND_FROM_CLI | Warning | Could not find information for rebalance on volume ${glusterVolumeName} of Cluster ${ClusterName} from CLI. Marking it as unknown. |
4092 | REMOVE_GLUSTER_VOLUME_BRICKS_NOT_FOUND_FROM_CLI | Warning | Could not find information for remove brick on volume ${glusterVolumeName} of Cluster ${ClusterName} from CLI. Marking it as unknown. |
4093 | GLUSTER_VOLUME_DETAILS_REFRESH | Info | Refreshed details of the volume ${glusterVolumeName} of cluster ${clusterName}. |
4094 | GLUSTER_VOLUME_DETAILS_REFRESH_FAILED | Error | Failed to refresh the details of volume ${glusterVolumeName} of cluster ${clusterName}. |
4095 | GLUSTER_HOST_UUID_ALREADY_EXISTS | Error | Gluster UUID of host ${VdsName} on Cluster ${ClusterName} already exists. |
4096 | USER_FORCE_SELECTED_SPM_STOP_FAILED | Error | Failed to force select ${VdsName} as the SPM due to a failure to stop the current SPM. |
4097 | GLUSTER_GEOREP_SESSION_DELETED_FROM_CLI | Warning | Detected deletion of geo-replication session ${geoRepSessionKey} from volume ${glusterVolumeName} of cluster ${clusterName} |
4098 | GLUSTER_GEOREP_SESSION_DETECTED_FROM_CLI | Warning | Detected new geo-replication session ${geoRepSessionKey} for volume ${glusterVolumeName} of cluster ${clusterName}. Adding it to engine. |
4099 | GLUSTER_GEOREP_SESSION_REFRESH | Info | Refreshed geo-replication sessions for volume ${glusterVolumeName} of cluster ${clusterName}. |
4100 | GLUSTER_GEOREP_SESSION_REFRESH_FAILED | Error | Failed to refresh geo-replication sessions for volume ${glusterVolumeName} of cluster ${clusterName}. |
4101 | GEOREP_SESSION_STOP | Info | Geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} has been stopped. |
4102 | GEOREP_SESSION_STOP_FAILED | Error | Failed to stop geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} |
4103 | GEOREP_SESSION_DELETED | Info | Geo-replication session deleted on volume ${glusterVolumeName} of cluster ${clusterName} |
4104 | GEOREP_SESSION_DELETE_FAILED | Error | Failed to delete geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} |
4105 | GLUSTER_GEOREP_CONFIG_SET | Info | Configuration ${key} has been set to ${value} on the geo-rep session ${geoRepSessionKey}. |
4106 | GLUSTER_GEOREP_CONFIG_SET_FAILED | Error | Failed to set the configuration ${key} to ${value} on geo-rep session ${geoRepSessionKey}. |
4107 | GLUSTER_GEOREP_CONFIG_LIST | Info | Refreshed configuration options for geo-replication session ${geoRepSessionKey} |
4108 | GLUSTER_GEOREP_CONFIG_LIST_FAILED | Error | Failed to refresh configuration options for geo-replication session ${geoRepSessionKey} |
4109 | GLUSTER_GEOREP_CONFIG_SET_DEFAULT | Info | Configuration of ${key} of session ${geoRepSessionKey} reset to its default value . |
4110 | GLUSTER_GEOREP_CONFIG_SET_DEFAULT_FAILED | Error | Failed to set ${key} of session ${geoRepSessionKey} to its default value. |
4111 | GLUSTER_VOLUME_SNAPSHOT_DELETED | Info | Gluster volume snapshot ${snapname} deleted. |
4112 | GLUSTER_VOLUME_SNAPSHOT_DELETE_FAILED | Error | Failed to delete gluster volume snapshot ${snapname}. |
4113 | GLUSTER_VOLUME_ALL_SNAPSHOTS_DELETED | Info | Deleted all the gluster volume snapshots for the volume ${glusterVolumeName} of cluster ${clusterName}. |
4114 | GLUSTER_VOLUME_ALL_SNAPSHOTS_DELETE_FAILED | Error | Failed to delete all the gluster volume snapshots for the volume ${glusterVolumeName} of cluster ${clusterName}. |
4115 | GLUSTER_VOLUME_SNAPSHOT_ACTIVATED | Info | Activated the gluster volume snapshot ${snapname} on volume ${glusterVolumeName} of cluster ${clusterName}. |
4116 | GLUSTER_VOLUME_SNAPSHOT_ACTIVATE_FAILED | Error | Failed to activate the gluster volume snapshot ${snapname} on volume ${glusterVolumeName} of cluster ${clusterName}. |
4117 | GLUSTER_VOLUME_SNAPSHOT_DEACTIVATED | Info | De-activated the gluster volume snapshot ${snapname} on volume ${glusterVolumeName} of cluster ${clusterName}. |
4118 | GLUSTER_VOLUME_SNAPSHOT_DEACTIVATE_FAILED | Error | Failed to de-activate gluster volume snapshot ${snapname} on volume ${glusterVolumeName} of cluster ${clusterName}. |
4119 | GLUSTER_VOLUME_SNAPSHOT_RESTORED | Info | Restored the volume ${glusterVolumeName} of cluster ${clusterName} to the state of gluster volume snapshot ${snapname}. |
4120 | GLUSTER_VOLUME_SNAPSHOT_RESTORE_FAILED | Error | Failed to restore the volume ${glusterVolumeName} of cluster ${clusterName} to the state of gluster volume snapshot ${snapname}. |
4121 | GLUSTER_VOLUME_SNAPSHOT_CONFIG_UPDATED | Info | Updated Gluster volume snapshot configuration(s). |
4122 | GLUSTER_VOLUME_SNAPSHOT_CONFIG_UPDATE_FAILED | Error | Failed to update gluster volume snapshot configuration(s). |
4123 | GLUSTER_VOLUME_SNAPSHOT_CONFIG_UPDATE_FAILED_PARTIALLY | Error | Failed to update gluster volume snapshot configuration(s) ${failedSnapshotConfigs}. |
4124 | NEW_STORAGE_DEVICE_DETECTED | Info | Found new storage device ${storageDevice} on host ${VdsName}, and added it to engine DB." |
4125 | STORAGE_DEVICE_REMOVED_FROM_THE_HOST | Info | Detected deletion of storage device ${storageDevice} on host ${VdsName}, and deleting it from engine DB." |
4126 | SYNC_STORAGE_DEVICES_IN_HOST | Info | Manually synced the storage devices from host ${VdsName} |
4127 | SYNC_STORAGE_DEVICES_IN_HOST_FAILED | Error | Failed to sync storage devices from host ${VdsName} |
4128 | GEOREP_OPTION_SET_FROM_CLI | Warning | Detected new option ${key} |
4129 | GEOREP_OPTION_CHANGED_FROM_CLI | Warning | Detected change in value of option ${key} from ${oldValue} to ${value} for geo-replication session on volume ${glusterVolumeName} of cluster ${ClusterName}, and updated it to engine. |
4130 | GLUSTER_MASTER_VOLUME_STOP_FAILED_DURING_SNAPSHOT_RESTORE | Error | Could not stop master volume ${glusterVolumeName} of cluster ${clusterName} during snapshot restore. |
4131 | GLUSTER_MASTER_VOLUME_SNAPSHOT_RESTORE_FAILED | Error | Could not restore master volume ${glusterVolumeName} of cluster ${clusterName}. |
4132 | GLUSTER_VOLUME_SNAPSHOT_CREATED | Info | Snapshot ${snapname} created for volume ${glusterVolumeName} of cluster ${clusterName}. |
4133 | GLUSTER_VOLUME_SNAPSHOT_CREATE_FAILED | Error | Could not create snapshot for volume ${glusterVolumeName} of cluster ${clusterName}. |
4134 | GLUSTER_VOLUME_SNAPSHOT_SCHEDULED | Info | Snapshots scheduled on volume ${glusterVolumeName} of cluster ${clusterName}. |
4135 | GLUSTER_VOLUME_SNAPSHOT_SCHEDULE_FAILED | Error | Failed to schedule snapshots on the volume ${glusterVolumeName} of cluster ${clusterName}. |
4136 | GLUSTER_VOLUME_SNAPSHOT_RESCHEDULED | Info | Rescheduled snapshots on volume ${glusterVolumeName} of cluster ${clusterName}. |
4137 | GLUSTER_VOLUME_SNAPSHOT_RESCHEDULE_FAILED | Error | Failed to reschedule snapshots on volume ${glusterVolumeName} of cluster ${clusterName}. |
4138 | CREATE_GLUSTER_BRICK | Info | Brick ${brickName} created successfully on host ${vdsName} of cluster ${clusterName}. |
4139 | CREATE_GLUSTER_BRICK_FAILED | Error | Failed to create brick ${brickName} on host ${vdsName} of cluster ${clusterName}. |
4140 | GLUSTER_GEO_REP_PUB_KEY_FETCH_FAILED | Error | Failed to fetch public keys. |
4141 | GLUSTER_GET_PUB_KEY | Info | Public key fetched. |
4142 | GLUSTER_GEOREP_PUBLIC_KEY_WRITE_FAILED | Error | Failed to write public keys to ${VdsName} |
4143 | GLUSTER_WRITE_PUB_KEYS | Info | Public keys written to ${VdsName} |
4144 | GLUSTER_GEOREP_SETUP_MOUNT_BROKER_FAILED | Error | Failed to setup geo-replication mount broker for user ${geoRepUserName} on the slave volume ${geoRepSlaveVolumeName}. |
4145 | GLUSTER_SETUP_GEOREP_MOUNT_BROKER | Info | Geo-replication mount broker has been setup for user ${geoRepUserName} on the slave volume ${geoRepSlaveVolumeName}. |
4146 | GLUSTER_GEOREP_SESSION_CREATE_FAILED | Error | Failed to create geo-replication session between master volume : ${glusterVolumeName} of cluster ${clusterName} and slave volume : ${geoRepSlaveVolumeName} for the user ${geoRepUserName}. |
4147 | CREATE_GLUSTER_VOLUME_GEOREP_SESSION | Info | Created geo-replication session between master volume : ${glusterVolumeName} of cluster ${clusterName} and slave volume : ${geoRepSlaveVolumeName} for the user ${geoRepUserName}. |
4148 | GLUSTER_VOLUME_SNAPSHOT_SOFT_LIMIT_REACHED | Info | Gluster Volume Snapshot soft limit reached for the volume ${glusterVolumeName} on cluster ${clusterName}. |
4149 | HOST_FEATURES_INCOMPATIBILE_WITH_CLUSTER | Error | Host ${VdsName} does not comply with the list of features supported by cluster ${ClusterName}. ${UnSupportedFeature} is not supported by the Host |
4150 | GLUSTER_VOLUME_SNAPSHOT_SCHEDULE_DELETED | Info | Snapshot schedule deleted for volume ${glusterVolumeName} of ${clusterName}. |
4151 | GLUSTER_BRICK_STATUS_DOWN | Info | Status of brick ${brickpath} of volume ${glusterVolumeName} on cluster ${ClusterName} is down. |
4152 | GLUSTER_VOLUME_SNAPSHOT_DETECTED_NEW | Info | Found new gluster volume snapshot ${snapname} for volume ${glusterVolumeName} on cluster ${ClusterName}, and added it to engine DB." |
4153 | GLUSTER_VOLUME_SNAPSHOT_DELETED_FROM_CLI | Info | Detected deletion of gluster volume snapshot ${snapname} for volume ${glusterVolumeName} on cluster ${ClusterName}, and deleting it from engine DB." |
4154 | GLUSTER_VOLUME_SNAPSHOT_CLUSTER_CONFIG_DETECTED_NEW | Info | Found new gluster volume snapshot configuration ${snapConfigName} with value ${snapConfigValue} on cluster ${ClusterName}, and added it to engine DB." |
4155 | GLUSTER_VOLUME_SNAPSHOT_VOLUME_CONFIG_DETECTED_NEW | Info | Found new gluster volume snapshot configuration ${snapConfigName} with value ${snapConfigValue} for volume ${glusterVolumeName} on cluster ${ClusterName}, and added it to engine DB." |
4156 | GLUSTER_VOLUME_SNAPSHOT_HARD_LIMIT_REACHED | Info | Gluster Volume Snapshot hard limit reached for the volume ${glusterVolumeName} on cluster ${clusterName}. |
4157 | GLUSTER_CLI_SNAPSHOT_SCHEDULE_DISABLE_FAILED | Error | Failed to disable gluster CLI based snapshot schedule on cluster ${clusterName}. |
4158 | GLUSTER_CLI_SNAPSHOT_SCHEDULE_DISABLED | Info | Disabled gluster CLI based scheduling successfully on cluster ${clusterName}. |
4159 | SET_UP_PASSWORDLESS_SSH | Info | Password-less SSH has been setup for user ${geoRepUserName} on the nodes of remote volume ${geoRepSlaveVolumeName} from the nodes of the volume ${glusterVolumeName}. |
4160 | SET_UP_PASSWORDLESS_SSH_FAILED | Error | Failed to setup Passwordless ssh for user ${geoRepUserName} on the nodes of remote volume ${geoRepSlaveVolumeName} from the nodes of the volume ${glusterVolumeName}. |
4161 | GLUSTER_VOLUME_TYPE_UNSUPPORTED | Warning | Detected a volume ${glusterVolumeName} with type ${glusterVolumeType} on cluster ${Cluster} and it is not fully supported by engine. |
4162 | GLUSTER_VOLUME_BRICK_REPLACED | Info | Replaced brick '${brick}' with new brick '${newBrick}' of Gluster Volume ${glusterVolumeName} on cluster ${clusterName} |
4163 | GLUSTER_SERVER_STATUS_DISCONNECTED | Info | Gluster server ${vdsName} set to DISCONNECTED on cluster ${clusterName}. |
4164 | GLUSTER_STORAGE_DOMAIN_SYNC_FAILED | Info | Failed to synchronize data from storage domain ${storageDomainName} to remote location. |
4165 | GLUSTER_STORAGE_DOMAIN_SYNCED | Info | Successfully synchronized data from storage domain ${storageDomainName} to remote location. |
4166 | GLUSTER_STORAGE_DOMAIN_SYNC_STARTED | Info | Successfully started data synchronization data from storage domain ${storageDomainName} to remote location. |
4167 | STORAGE_DOMAIN_DR_DELETED | Error | Deleted the data synchronization schedule for storage domain ${storageDomainName} as the underlying geo-replication session ${geoRepSessionKey} has been deleted. |
4436 | GLUSTER_SERVER_ADD_FAILED | Error | Failed to add host ${VdsName} into Cluster ${ClusterName}. ${ErrorMessage} |
4437 | GLUSTER_SERVERS_LIST_FAILED | Error | Failed to fetch gluster peer list from server ${VdsName} on Cluster ${ClusterName}. ${ErrorMessage} |
4595 | GLUSTER_VOLUME_GEO_REP_START_FAILED_EXCEPTION | Error | Failed to start geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} |
4596 | GLUSTER_VOLUME_GEO_REP_START | Info | Geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} has been started. |
4597 | GLUSTER_VOLUME_GEO_REP_PAUSE_FAILED | Error | Failed to pause geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} |
4598 | GLUSTER_VOLUME_GEO_REP_RESUME_FAILED | Error | Failed to resume geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} |
4599 | GLUSTER_VOLUME_GEO_REP_RESUME | Info | Geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} has been resumed. |
4600 | GLUSTER_VOLUME_GEO_REP_PAUSE | Info | Geo-replication session on volume ${glusterVolumeName} of cluster ${clusterName} has been paused. |
9000 | VDS_ALERT_FENCE_IS_NOT_CONFIGURED | Info | Failed to verify Power Management configuration for Host ${VdsName}. |
9001 | VDS_ALERT_FENCE_TEST_FAILED | Info | Power Management test failed for Host ${VdsName}.${Reason} |
9002 | VDS_ALERT_FENCE_OPERATION_FAILED | Info | Failed to power fence host ${VdsName}. Please check the host status and it's power management settings, and then manually reboot it and click "Confirm Host Has Been Rebooted" |
9003 | VDS_ALERT_FENCE_OPERATION_SKIPPED | Info | Host ${VdsName} became non responsive. It has no power management configured. Please check the host status, manually reboot it, and click "Confirm Host Has Been Rebooted" |
9004 | VDS_ALERT_FENCE_NO_PROXY_HOST | Info | There is no other host in the data center that can be used to test the power management settings. |
9005 | VDS_ALERT_FENCE_STATUS_VERIFICATION_FAILED | Info | Failed to verify Host ${Host} ${Status} status, Please ${Status} Host ${Host} manually. |
9006 | CANNOT_HIBERNATE_RUNNING_VMS_AFTER_CLUSTER_CPU_UPGRADE | Warning | Hibernation of VMs after CPU upgrade of Cluster ${Cluster} is not supported. Please stop and restart those VMs in case you wish to hibernate them |
9007 | VDS_ALERT_SECONDARY_AGENT_USED_FOR_FENCE_OPERATION | Info | Secondary fence agent was used to ${Operation} Host ${VdsName} |
9008 | VDS_HOST_NOT_RESPONDING_CONNECTING | Warning | Host ${VdsName} is not responding. It will stay in Connecting state for a grace period of ${Seconds} seconds and after that an attempt to fence the host will be issued. |
9009 | VDS_ALERT_PM_HEALTH_CHECK_FENCE_AGENT_NON_RESPONSIVE | Info | Health check on Host ${VdsName} indicates that Fence-Agent ${AgentId} is non-responsive. |
9010 | VDS_ALERT_PM_HEALTH_CHECK_START_MIGHT_FAIL | Info | Health check on Host ${VdsName} indicates that future attempts to Start this host using Power-Management are expected to fail. |
9011 | VDS_ALERT_PM_HEALTH_CHECK_STOP_MIGHT_FAIL | Info | Health check on Host ${VdsName} indicates that future attempts to Stop this host using Power-Management are expected to fail. |
9012 | VDS_ALERT_PM_HEALTH_CHECK_RESTART_MIGHT_FAIL | Info | Health check on Host ${VdsName} indicates that future attempts to Restart this host using Power-Management are expected to fail. |
9013 | VDS_ALERT_FENCE_OPERATION_SKIPPED_BROKEN_CONNECTIVITY | Info | Host ${VdsName} became non responsive and was not restarted due to Fencing Policy: ${Percents} percents of the Hosts in the Cluster have connectivity issues. |
9014 | VDS_ALERT_NOT_RESTARTED_DUE_TO_POLICY | Info | Host ${VdsName} became non responsive and was not restarted due to the Cluster Fencing Policy. |
9015 | VDS_ALERT_FENCE_DISABLED_BY_CLUSTER_POLICY | Info | Host ${VdsName} became Non Responsive and was not restarted due to disabled fencing in the Cluster Fencing Policy. |
9016 | FENCE_DISABLED_IN_CLUSTER_POLICY | Info | Fencing is disabled in Fencing Policy of the Cluster ${ClusterName}, so HA VMs running on a non-responsive host will not be restarted elsewhere. |
9017 | FENCE_OPERATION_STARTED | Info | Power management ${Action} of Host ${VdsName} initiated. |
9018 | FENCE_OPERATION_SUCCEEDED | Info | Power management ${Action} of Host ${VdsName} succeeded. |
9019 | FENCE_OPERATION_FAILED | Error | Power management ${Action} of Host ${VdsName} failed. |
9020 | FENCE_OPERATION_USING_AGENT_AND_PROXY_STARTED | Info | Executing power management ${Action} on Host ${Host} using Proxy Host ${ProxyHost} and Fence Agent ${AgentType}:${AgentIp}. |
9021 | FENCE_OPERATION_USING_AGENT_AND_PROXY_FAILED | Warning | Execution of power management ${Action} on Host ${Host} using Proxy Host ${ProxyHost} and Fence Agent ${AgentType}:${AgentIp} failed. |
9022 | ENGINE_NO_FULL_BACKUP | Info | There is no full backup available, please run engine-backup to prevent data loss in case of corruption. |
9023 | ENGINE_NO_WARM_BACKUP | Info | Full backup was created on ${Date} and it's too old. Please run engine-backup to prevent data loss in case of corruption. |
9024 | ENGINE_BACKUP_STARTED | Normal | Engine backup started. |
9025 | ENGINE_BACKUP_COMPLETED | Normal | Engine backup completed successfully. |
9026 | ENGINE_BACKUP_FAILED | Error | Engine backup failed. |
9500 | TASK_STOPPING_ASYNC_TASK | Info | Stopping async task ${CommandName} that started at ${Date} |
9501 | TASK_CLEARING_ASYNC_TASK | Info | Clearing asynchronous task ${CommandName} that started at ${Date} |
9506 | USER_ACTIVATE_STORAGE_DOMAIN_FAILED_ASYNC | Warning | Failed to autorecover Storage Domain ${StorageDomainName} (Data Center ${StoragePoolName}). |
9600 | IMPORTEXPORT_IMPORT_VM_INVALID_INTERFACES | Warning | While importing VM ${EntityName}, the Network/s ${Networks} were found to be Non-VM Networks or do not exist in Cluster or are missing a suitable VM network interface profile. Network Name was not set in the Interface/s ${Interfaces}. |
9601 | VDS_SET_NON_OPERATIONAL_VM_NETWORK_IS_BRIDGELESS | Warning | Host ${VdsName} does not comply with the cluster ${ClusterName} networks, the following VM networks are non-VM networks: '${Networks}' |
9602 | HA_VM_FAILED | Error | Highly Available VM ${VmName} failed. It will be restarted automatically. |
9603 | HA_VM_RESTART_FAILED | Error | Restart of the Highly Available VM ${VmName} failed. |
9604 | EMULATED_MACHINES_INCOMPATIBLE_WITH_CLUSTER | Warning | Host ${VdsName} does not comply with the cluster ${ClusterName} emulated machine. The cluster emulated machine is ${clusterEmulatedMachines} and the host emulated machines are ${hostSupportedEmulatedMachines}. |
9605 | EXCEEDED_MAXIMUM_NUM_OF_RESTART_HA_VM_ATTEMPTS | Error | Highly Available VM ${VmName} could not be restarted automatically, exceeded the maximum number of attempts. |
9606 | IMPORTEXPORT_SNAPSHOT_VM_INVALID_INTERFACES | Warning | While previewing a snapshot of VM ${EntityName}, the Network/s ${Networks} were found to be Non-VM Networks or do not exist in Cluster. Network Name was not set in the Interface/s ${Interfaces}. |
9607 | ADD_VM_FROM_SNAPSHOT_INVALID_INTERFACES | Warning | While adding vm ${EntityName} from snapshot, the Network/s ${Networks} were found to be Non-VM Networks or do not exist in Cluster. Network Name was not set in the Interface/s ${Interfaces}. |
9608 | RNG_SOURCES_INCOMPATIBLE_WITH_CLUSTER | Warning | Host ${VdsName} does not comply with the cluster ${ClusterName} Random Number Generator sources. The Hosts supported sources are: ${hostSupportedRngSources}; and the cluster requirements are: ${clusterRequiredRngSources}. |
9609 | EMULATED_MACHINES_INCOMPATIBLE_WITH_CLUSTER_LEVEL | Warning | Host ${VdsName} does not comply with the cluster ${ClusterName} emulated machines. The current cluster compatibility level supports ${clusterEmulatedMachines} and the host emulated machines are ${hostSupportedEmulatedMachines}. |
9610 | MIXING_RHEL_VERSIONS_IN_CLUSTER | Warning | Not possible to mix RHEL 6.x and 7.x hosts in one cluster. Tried adding ${addingRhel} host to a cluster with ${previousRhel} hosts. |
9611 | COLD_REBOOT_VM_DOWN | Info | VM ${VmName} is down as a part of cold reboot process |
9612 | COLD_REBOOT_FAILED | Error | Cold reboot of VM ${VmName} failed |
9613 | EXCEEDED_MAXIMUM_NUM_OF_COLD_REBOOT_VM_ATTEMPTS | Error | VM ${VmName} could not be rebooted, exceeded the maximum number of attempts. |
9700 | DWH_STARTED | Info | ETL Service started. |
9701 | DWH_STOPPED | Info | ETL Service stopped. |
9704 | DWH_ERROR | Error | Error in ETL Service. |
9801 | EXTERNAL_EVENT_NORMAL | Info | An external event with NORMAL severity has been added. |
9802 | EXTERNAL_EVENT_WARNING | Warning | An external event with WARNING severity has been added. |
9803 | EXTERNAL_EVENT_ERROR | Error | An external event with ERROR severity has been added. |
9804 | EXTERNAL_ALERT | Info | An external event with ALERT severity has been added. |
9901 | WATCHDOG_EVENT | Warning | Watchdog event (${wdaction}) triggered on ${VmName} at ${wdevent} (host time). |
9910 | USER_ADD_CLUSTER_POLICY | Info | Scheduling Policy ${ClusterPolicy} was added. (User: ${UserName}) |
9911 | USER_FAILED_TO_ADD_CLUSTER_POLICY | Error | Failed to add Scheduling Policy: ${ClusterPolicy}. (User: ${UserName}) |
9912 | USER_UPDATE_CLUSTER_POLICY | Info | Scheduling Policy ${ClusterPolicy} was updated. (User: ${UserName}) |
9913 | USER_FAILED_TO_UPDATE_CLUSTER_POLICY | Error | Failed to update Scheduling Policy: ${ClusterPolicy}. (User: ${UserName}) |
9914 | USER_REMOVE_CLUSTER_POLICY | Info | Scheduling Policy ${ClusterPolicy} was removed. (User: ${UserName}) |
9915 | USER_FAILED_TO_REMOVE_CLUSTER_POLICY | Error | Failed to remove Scheduling Policy: ${ClusterPolicy}. (User: ${UserName}) |
9920 | FAILED_TO_CONNECT_TO_SCHEDULER_PROXY | Error | Failed to connect to external scheduler proxy. External filters, scoring functions and load balancing will not be performed. |
10000 | VDS_UNTRUSTED | Error | Host ${VdsName} was set to non-operational. Host is not trusted by the attestation service. |
10001 | USER_UPDATE_VM_FROM_TRUSTED_TO_UNTRUSTED | Warning | The VM ${VmName} was updated from trusted cluster to non-trusted cluster. |
10002 | USER_UPDATE_VM_FROM_UNTRUSTED_TO_TRUSTED | Warning | The VM ${VmName} was updated from non-trusted cluster to trusted cluster. |
10003 | IMPORTEXPORT_IMPORT_VM_FROM_TRUSTED_TO_UNTRUSTED | Warning | The VM ${VmName} was created in trusted cluster and imported into a non-trusted cluster |
10004 | IMPORTEXPORT_IMPORT_VM_FROM_UNTRUSTED_TO_TRUSTED | Warning | The VM ${VmName} was created in non-trusted cluster and imported into a trusted cluster |
10005 | USER_ADD_VM_FROM_TRUSTED_TO_UNTRUSTED | Warning | The VM ${VmName} was created in an untrusted cluster. It was originated from the Template ${VmTemplateName} which was created in a trusted cluster. |
10006 | USER_ADD_VM_FROM_UNTRUSTED_TO_TRUSTED | Warning | The VM ${VmName} was created in a trusted cluster. It was originated from the Template ${VmTemplateName} which was created in an untrusted cluster. |
10007 | IMPORTEXPORT_IMPORT_TEMPLATE_FROM_TRUSTED_TO_UNTRUSTED | Warning | The Template ${VmTemplateName} was created in trusted cluster and imported into a non-trusted cluster |
10008 | IMPORTEXPORT_IMPORT_TEMPLATE_FROM_UNTRUSTED_TO_TRUSTED | Warning | The Template ${VmTemplateName} was created in non-trusted cluster and imported into a trusted cluster |
10009 | USER_ADD_VM_TEMPLATE_FROM_TRUSTED_TO_UNTRUSTED | Warning | The non-trusted Template ${VmTemplateName} was created from trusted Vm ${VmName}. |
10010 | USER_ADD_VM_TEMPLATE_FROM_UNTRUSTED_TO_TRUSTED | Warning | The trusted template ${VmTemplateName} was created from non-trusted Vm ${VmName}. |
10011 | USER_UPDATE_VM_TEMPLATE_FROM_TRUSTED_TO_UNTRUSTED | Warning | The Template ${VmTemplateName} was updated from trusted cluster to non-trusted cluster. |
10012 | USER_UPDATE_VM_TEMPLATE_FROM_UNTRUSTED_TO_TRUSTED | Warning | The Template ${VmTemplateName} was updated from non-trusted cluster to trusted cluster. |
10013 | IMPORTEXPORT_GET_EXTERNAL_VMS_NOT_IN_DOWN_STATUS | Warning | The following VMs retrieved from external server ${URL} are not in down status: ${Vms}. |
10100 | USER_ADDED_NETWORK_QOS | Info | Network QoS ${QosName} was added. (User: ${UserName}) |
10101 | USER_FAILED_TO_ADD_NETWORK_QOS | Error | Failed to add Network QoS ${QosName}. (User: ${UserName}) |
10102 | USER_REMOVED_NETWORK_QOS | Info | Network QoS ${QosName} was removed. (User: ${UserName}) |
10103 | USER_FAILED_TO_REMOVE_NETWORK_QOS | Error | Failed to remove Network QoS ${QosName}. (User: ${UserName}) |
10104 | USER_UPDATED_NETWORK_QOS | Info | Network QoS ${QosName} was updated. (User: ${UserName}) |
10105 | USER_FAILED_TO_UPDATE_NETWORK_QOS | Error | Failed to update Network QoS ${QosName}. (User: ${UserName}) |
10110 | USER_ADDED_QOS | Info | QoS ${QoSName} was added. (User: ${UserName}) |
10111 | USER_FAILED_TO_ADD_QOS | Error | Failed to add QoS ${QoSName}. (User: ${UserName}) |
10112 | USER_REMOVED_QOS | Info | QoS ${QoSName} was removed. (User: ${UserName}) |
10113 | USER_FAILED_TO_REMOVE_QOS | Error | Failed to remove QoS ${QoSName}. (User: ${UserName}) |
10114 | USER_UPDATED_QOS | Info | QoS ${QoSName} was updated. (User: ${UserName}) |
10115 | USER_FAILED_TO_UPDATE_QOS | Error | Failed to update QoS ${QoSName}. (User: ${UserName}) |
10120 | USER_ADDED_DISK_PROFILE | Info | Disk Profile ${ProfileName} was successfully added (User: ${UserName}). |
10121 | USER_FAILED_TO_ADD_DISK_PROFILE | Error | Failed to add Disk Profile (User: ${UserName}). |
10122 | USER_REMOVED_DISK_PROFILE | Info | Disk Profile ${ProfileName} was successfully removed (User: ${UserName}). |
10123 | USER_FAILED_TO_REMOVE_DISK_PROFILE | Error | Failed to remove Disk Profile ${ProfileName} (User: ${UserName}). |
10124 | USER_UPDATED_DISK_PROFILE | Info | Disk Profile ${ProfileName} was successfully updated (User: ${UserName}). |
10125 | USER_FAILED_TO_UPDATE_DISK_PROFILE | Error | Failed to update Disk Profile ${ProfileName} (User: ${UserName}). |
10130 | USER_ADDED_CPU_PROFILE | Info | CPU Profile ${ProfileName} was successfully added (User: ${UserName}). |
10131 | USER_FAILED_TO_ADD_CPU_PROFILE | Error | Failed to add CPU Profile (User: ${UserName}). |
10132 | USER_REMOVED_CPU_PROFILE | Info | CPU Profile ${ProfileName} was successfully removed (User: ${UserName}). |
10133 | USER_FAILED_TO_REMOVE_CPU_PROFILE | Error | Failed to remove CPU Profile ${ProfileName} (User: ${UserName}). |
10134 | USER_UPDATED_CPU_PROFILE | Info | CPU Profile ${ProfileName} was successfully updated (User: ${UserName}). |
10135 | USER_FAILED_TO_UPDATE_CPU_PROFILE | Error | Failed to update CPU Profile ${ProfileName} (User: ${UserName}). |
10200 | USER_UPDATED_MOM_POLICIES | Info | Mom policy was updated on host ${VdsName}. |
10201 | USER_FAILED_TO_UPDATE_MOM_POLICIES | Warning | Mom policy could not be updated on host ${VdsName}. |
10250 | PM_POLICY_UP_TO_MAINTENANCE | Info | Host ${Host} is not currently needed, activating maintenance mode in preparation for shutdown. |
10251 | PM_POLICY_MAINTENANCE_TO_DOWN | Info | Host ${Host} is not currently needed, shutting down. |
10252 | PM_POLICY_TO_UP | Info | Reactivating host ${Host} according to the current power management policy. |
10300 | CLUSTER_ALERT_HA_RESERVATION | Info | Cluster ${ClusterName} failed the HA Reservation check, HA VMs on host(s): ${Hosts} will fail to migrate in case of a failover, consider adding resources or shutting down unused VMs. |
10301 | CLUSTER_ALERT_HA_RESERVATION_DOWN | Info | Cluster ${ClusterName} passed the HA Reservation check. |
10350 | USER_ADDED_AFFINITY_GROUP | Info | Affinity Group ${affinityGroupName} was added. (User: ${UserName}) |
10351 | USER_FAILED_TO_ADD_AFFINITY_GROUP | Error | Failed to add Affinity Group ${affinityGroupName}. (User: ${UserName}) |
10352 | USER_UPDATED_AFFINITY_GROUP | Info | Affinity Group ${affinityGroupName} was updated. (User: ${UserName}) |
10353 | USER_FAILED_TO_UPDATE_AFFINITY_GROUP | Error | Failed to update Affinity Group ${affinityGroupName}. (User: ${UserName}) |
10354 | USER_REMOVED_AFFINITY_GROUP | Info | Affinity Group ${affinityGroupName} was removed. (User: ${UserName}) |
10355 | USER_FAILED_TO_REMOVE_AFFINITY_GROUP | Error | Failed to remove Affinity Group ${affinityGroupName}. (User: ${UserName}) |
10356 | VM_TO_HOST_CONFLICT_IN_ENFORCING_POSITIVE_AND_NEGATIVE_AFFINITY | Error | The affinity groups: ${AffinityGroups}, with hosts :${Hosts} and VMs : ${Vms}, have VM to host conflicts between positive and negative enforcing affinity groups. |
10357 | VM_TO_HOST_CONFLICT_IN_POSITIVE_AND_NEGATIVE_AFFINITY | Warning | The affinity groups: ${AffinityGroups}, with hosts: ${Hosts} and VMs: ${Vms}, have VM to host conflicts between positive and negative affinity groups. |
10358 | VM_TO_HOST_CONFLICTS_POSITIVE_VM_TO_VM_AFFINITY | Warning | The affinity groups: ${AffinityGroups}, with hosts : ${Hosts} and VMs: ${Vms}, have conflicts between VM to host affinity and VM to VM positive affinity. |
10359 | VM_TO_HOST_CONFLICTS_NEGATIVE_VM_TO_VM_AFFINITY | Warning | The affinity groups: ${AffinityGroups}, with hosts : ${Hosts} and VMs: ${Vms}, have conflicts between VM to host affinity and VM to VM negative affinity. |
10360 | NON_INTERSECTING_POSITIVE_HOSTS_AFFINITY_CONFLICTS | Warning | The affinity groups: ${AffinityGroups}, with hosts : ${Hosts} and VMs : ${Vms} , have non intersecting positive hosts conflicts. |
10361 | VM_TO_VM_AFFINITY_CONFLICTS | Error | |
10380 | USER_ADDED_AFFINITY_LABEL | Info | Affinity Label ${labelName} was added. (User: ${UserName}) |
10381 | USER_FAILED_TO_ADD_AFFINITY_LABEL | Error | Failed to add Affinity Label ${labelName}. (User: ${UserName}) |
10382 | USER_UPDATED_AFFINITY_LABEL | Info | Affinity Label ${labelName} was updated. (User: ${UserName}) |
10383 | USER_FAILED_TO_UPDATE_AFFINITY_LABEL | Error | Failed to update Affinity Label ${labelName}. (User: ${UserName}) |
10384 | USER_REMOVED_AFFINITY_LABEL | Info | Affinity Label ${labelName} was removed. (User: ${UserName}) |
10385 | USER_FAILED_TO_REMOVE_AFFINITY_LABEL | Error | Failed to remove Affinity Label ${labelName}. (User: ${UserName}) |
10400 | ISCSI_BOND_ADD_SUCCESS | Info | iSCSI bond '${IscsiBondName}' was successfully created in Data Center '${StoragePoolName}'. |
10401 | ISCSI_BOND_ADD_FAILED | Error | Failed to create iSCSI bond '${IscsiBondName}' in Data Center '${StoragePoolName}'. |
10402 | ISCSI_BOND_EDIT_SUCCESS | Info | iSCSI bond '${IscsiBondName}' was successfully updated. |
10403 | ISCSI_BOND_EDIT_FAILED | Error | Failed to update iSCSI bond '${IscsiBondName}'. |
10404 | ISCSI_BOND_REMOVE_SUCCESS | Info | iSCSI bond '${IscsiBondName}' was removed from Data Center '${StoragePoolName}' |
10405 | ISCSI_BOND_REMOVE_FAILED | Error | Failed to remove iSCSI bond '${IscsiBondName}' from Data Center '${StoragePoolName}' |
10406 | ISCSI_BOND_EDIT_SUCCESS_WITH_WARNING | Warning | iSCSI bond '${IscsiBondName}' was successfully updated but some of the hosts encountered connection issues. |
10407 | ISCSI_BOND_ADD_SUCCESS_WITH_WARNING | Warning | iSCSI bond '${IscsiBondName}' was successfully created in Data Center '${StoragePoolName}' but some of the hosts encountered connection issues. |
10450 | USER_SET_HOSTED_ENGINE_MAINTENANCE | Info | Hosted Engine HA maintenance mode was updated on host ${VdsName}. |
10451 | USER_FAILED_TO_SET_HOSTED_ENGINE_MAINTENANCE | Error | Hosted Engine HA maintenance mode could not be updated on host ${VdsName}. |
10452 | VDS_MAINTENANCE_MANUAL_HA | Warning | Host ${VdsName} was switched to Maintenance mode, but Hosted Engine HA maintenance could not be enabled. Please enable it manually. |
10453 | USER_VDS_MAINTENANCE_MANUAL_HA | Warning | Host ${VdsName} was switched to Maintenance mode by ${UserName}, but Hosted Engine HA maintenance could not be enabled. Please enable it manually. |
10454 | VDS_ACTIVATE_MANUAL_HA | Warning | Host ${VdsName} was activated by ${UserName}, but the Hosted Engine HA service may still be in maintenance mode. If necessary, please correct this manually. |
10455 | VDS_ACTIVATE_MANUAL_HA_ASYNC | Warning | Host ${VdsName} was autorecovered, but the Hosted Engine HA service may still be in maintenance mode. If necessary, please correct this manually. |
10456 | HOSTED_ENGINE_VM_IMPORT_SUCCEEDED | Normal | Hosted Engine VM was imported successfully |
10460 | HOSTED_ENGINE_DOMAIN_IMPORT_SUCCEEDED | Normal | Hosted Engine Storage Domain imported successfully |
10461 | HOSTED_ENGINE_DOMAIN_IMPORT_FAILED | Error | Failed to import the Hosted Engine Storage Domain |
10500 | EXTERNAL_SCHEDULER_PLUGIN_ERROR | Error | Running the external scheduler plugin '${PluginName}' failed: '${ErrorMessage}' |
10501 | EXTERNAL_SCHEDULER_ERROR | Error | Running the external scheduler failed: '${ErrorMessage}' |
10550 | VM_SLA_POLICY_CPU | Info | VM ${VmName} SLA Policy was set. CPU limit is set to ${cpuLimit} |
10551 | VM_SLA_POLICY_STORAGE | Info | VM ${VmName} SLA Policy was set. Storage policy changed for disks: [${diskList}] |
10552 | VM_SLA_POLICY_CPU_STORAGE | Info | VM ${VmName} SLA Policy was set. CPU limit is set to ${cpuLimit}. Storage policy changed for disks: [${diskList}] |
10553 | FAILED_VM_SLA_POLICY | Error | Failed to set SLA Policy to VM ${VmName}. Underlying error message: ${ErrorMessage} |
10600 | USER_REMOVE_AUDIT_LOG | Info | Event list message ${AuditLogId} was removed by User ${UserName}. |
10601 | USER_REMOVE_AUDIT_LOG_FAILED | Error | User ${UserName} failed to remove event list message ${AuditLogId}. |
10602 | USER_CLEAR_ALL_AUDIT_LOG | Info | |
10603 | USER_CLEAR_ALL_AUDIT_LOG_FAILED | Error | |
10604 | USER_DISPLAY_ALL_AUDIT_LOG | Info | |
10605 | USER_DISPLAY_ALL_AUDIT_LOG_FAILED | Error | |
10700 | MAC_POOL_ADD_SUCCESS | Info | MAC Pool '${MacPoolName}' (id |
10701 | MAC_POOL_ADD_FAILED | Error | Failed to create MAC Pool '${MacPoolName}'. (User: ${UserName}) |
10702 | MAC_POOL_EDIT_SUCCESS | Info | MAC Pool '${MacPoolName}' (id |
10703 | MAC_POOL_EDIT_FAILED | Error | Failed to update MAC Pool '${MacPoolName}' (id |
10704 | MAC_POOL_REMOVE_SUCCESS | Info | MAC Pool '${MacPoolName}' (id |
10705 | MAC_POOL_REMOVE_FAILED | Error | Failed to remove MAC Pool '${MacPoolName}' (id |
10750 | CINDER_PROVIDER_ERROR | Error | An error occurred on Cinder provider: '${CinderException}' |
10751 | CINDER_DISK_CONNECTION_FAILURE | Error | Failed to retrieve connection information for Cinder Disk '${DiskAlias}'. |
10752 | CINDER_DISK_CONNECTION_VOLUME_DRIVER_UNSUPPORTED | Error | Unsupported volume driver for Cinder Disk '${DiskAlias}'. |
10753 | USER_FINISHED_FAILED_REMOVE_CINDER_DISK | Error | Failed to remove disk ${DiskAlias} from storage domain ${StorageDomainName}. The following entity id could not be deleted from the Cinder provider '${imageId}'. (User: ${UserName}). |
10754 | USER_ADDED_LIBVIRT_SECRET | Info | Authentication Key ${LibvirtSecretUUID} was added. (User: ${UserName}). |
10755 | USER_FAILED_TO_ADD_LIBVIRT_SECRET | Error | Failed to add Authentication Key ${LibvirtSecretUUID}. (User: ${UserName}). |
10756 | USER_UPDATE_LIBVIRT_SECRET | Info | Authentication Key ${LibvirtSecretUUID} was updated. (User: ${UserName}). |
10757 | USER_FAILED_TO_UPDATE_LIBVIRT_SECRET | Error | Failed to update Authentication Key ${LibvirtSecretUUID}. (User: ${UserName}). |
10758 | USER_REMOVED_LIBVIRT_SECRET | Info | Authentication Key ${LibvirtSecretUUID} was removed. (User: ${UserName}). |
10759 | USER_FAILED_TO_REMOVE_LIBVIRT_SECRET | Error | Failed to remove Authentication Key ${LibvirtSecretUUID}. (User: ${UserName}). |
10760 | FAILED_TO_REGISTER_LIBVIRT_SECRET | Error | Failed to register Authentication Keys for storage domain ${StorageDomainName} on host ${VdsName}. |
10761 | FAILED_TO_UNREGISTER_LIBVIRT_SECRET | Error | Failed to unregister Authentication Keys for storage domain ${StorageDomainName} on host ${VdsName}. |
10762 | FAILED_TO_REGISTER_LIBVIRT_SECRET_ON_VDS | Error | Failed to register Authentication Keys on host ${VdsName}. |
10763 | NO_LIBRBD_PACKAGE_AVAILABLE_ON_VDS | Error | Librbd1 package is not available on host ${VdsName}, which is mandatory for using Cinder storage domains. |
10764 | FAILED_TO_FREEZE_VM | Warning | Failed to freeze guest filesystems on VM ${VmName}. Note that using the created snapshot might cause data inconsistency. |
10765 | FAILED_TO_THAW_VM | Warning | Failed to thaw guest filesystems on VM ${VmName}. The filesystems might be unresponsive until the VM is restarted. |
10766 | FREEZE_VM_INITIATED | Normal | Freeze of guest filesystems on VM ${VmName} was initiated. |
10767 | FREEZE_VM_SUCCESS | Normal | Guest filesystems on VM ${VmName} have been frozen successfully. |
10768 | THAW_VM_SUCCESS | Normal | Guest filesystems on VM ${VmName} have been thawed successfully. |
10769 | USER_FAILED_TO_FREEZE_VM | Warning | Failed to freeze guest filesystems on ${VmName} (Host: ${VdsName}, User: ${UserName}). |
10770 | USER_FAILED_TO_THAW_VM | Warning | Failed to thaw guest filesystems on ${VmName} (Host: ${VdsName}, User: ${UserName}). |
10771 | VDS_CANNOT_CONNECT_TO_GLUSTERFS | Error | Host ${VdsName} cannot connect to Glusterfs. Verify that glusterfs-cli package is installed on the host. |
10780 | AFFINITY_RULES_ENFORCEMENT_MANAGER_START | Normal | Affinity Rules Enforcement Manager started. |
10781 | AFFINITY_RULES_ENFORCEMENT_MANAGER_INTERVAL_REACHED | Normal | |
10800 | VM_ADD_HOST_DEVICES | Info | Host devices ${NamesAdded} were attached to Vm ${VmName} by User ${UserName}. |
10801 | VM_REMOVE_HOST_DEVICES | Info | Host devices ${NamesRemoved} were detached from Vm ${VmName} by User ${UserName}. |
10802 | VDS_BROKER_COMMAND_FAILURE | Error | VDSM ${VdsName} command ${CommandName} failed: ${message} |
10803 | IRS_BROKER_COMMAND_FAILURE | Error | VDSM command ${CommandName} failed: ${message} |
10804 | VDS_UNKNOWN_HOST | Error | The address of host ${VdsName} could not be determined |
10810 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_UP_REPORTING_HOSTS | Normal | Data Center ${StoragePoolName} status was changed to UP as some of its hosts are in status UP. |
10811 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_NON_RESPONSIVE_NO_REPORTING_HOSTS | Info | Data Center ${StoragePoolName} status was changed to Non Responsive as none of its hosts are in status UP. |
10812 | STORAGE_POOL_LOWER_THAN_ENGINE_HIGHEST_CLUSTER_LEVEL | Info | Data Center ${StoragePoolName} compatibility version is ${dcVersion}, which is lower than latest engine version ${engineVersion}. Please upgrade your Data Center to latest version to successfully finish upgrade of your setup. |
10900 | HOST_SYNC_ALL_NETWORKS_FAILED | Error | Failed to sync all host ${VdsName} networks |
10901 | HOST_SYNC_ALL_NETWORKS_FINISHED | Info | Managed to sync all host ${VdsName} networks. |
10902 | PERSIST_HOST_SETUP_NETWORK_ON_HOST | Info | (${Sequence}/${Total}): Applying network's changes on host ${VdsName}. (User: ${UserName}) |
10903 | PERSIST_SETUP_NETWORK_ON_HOST_FINISHED | Info | (${Sequence}/${Total}): Successfully applied changes on host ${VdsName}. (User: ${UserName}) |
10904 | PERSIST_SETUP_NETWORK_ON_HOST_FAILED | Error | (${Sequence}/${Total}): Failed to apply changes on host ${VdsName}. (User: ${UserName}) |
11000 | USER_ADD_EXTERNAL_JOB | Info | New external Job ${description} was added by user ${UserName} |
11001 | USER_ADD_EXTERNAL_JOB_FAILED | Error | Failed to add new external Job ${description} |
12000 | MIGRATION_REASON_AFFINITY_ENFORCEMENT | Info | Affinity rules enforcement |
12001 | MIGRATION_REASON_LOAD_BALANCING | Info | Load balancing |
12002 | MIGRATION_REASON_HOST_IN_MAINTENANCE | Info | Host preparing for maintenance |
12003 | VM_MIGRATION_NOT_ALL_VM_NICS_WERE_PLUGGED_BACK | Error | After migration of ${VmName}, following vm nics failed to be plugged back: ${NamesOfNotRepluggedNics}. |
12004 | VM_MIGRATION_PLUGGING_VM_NICS_FAILED | Error | After migration of ${VmName} vm nics failed to be plugged back. |
12005 | CLUSTER_CANNOT_UPDATE_VM_COMPATIBILITY_VERSION | Error | Cannot update compatibility version of Vm/Template: [${VmName}], Message: ${Message} |
Appendix D. Timezones
Copy linkLink copied to clipboard!
D.1. Timezones
Copy linkLink copied to clipboard!
The API maps Windows Standard Format timezone names to tz database format when specifying a timezone for a virtual machine or VM template. This means the API only accepts certain tz database codes, which the following table lists:
| tz database Format | Windows Standard Format |
|---|---|
Africa/Cairo | Egypt Standard Time |
Africa/Casablanca | Morocco Standard Time |
Africa/Johannesburg | South Africa Standard Time |
Africa/Lagos | W. Central Africa Standard Time |
Africa/Nairobi | E. Africa Standard Time |
Africa/Reykjavik | Greenwich Standard Time |
Africa/Windhoek | Namibia Standard Time |
America/Anchorage | Alaskan Standard Time |
America/Bogota | SA Pacific Standard Time |
America/Buenos_Aires | Argentina Standard Time |
America/Caracas | Venezuela Standard Time |
America/Chicago | Central Standard Time |
America/Chihuahua | Mexico Standard Time |
America/Chihuahua | Mountain Standard Time |
America/Denver | Mountain Standard Time |
America/Godthab | Greenland Standard Time |
America/Guatemala | Central America Standard Time |
America/Halifax | Atlantic Standard Time |
America/La_Paz | SA Western Standard Time |
America/Los_Angeles | Pacific Standard Time |
America/Manaus | Central Brazilian Standard Time |
America/Mexico_City | Central Standard Time |
America/Mexico_City | Mexico Standard Time |
America/Montevideo | Montevideo Standard Time |
America/New_York | Eastern Standard Time |
America/Phoenix | US Mountain Standard Time |
America/Regina | Canada Central Standard Time |
America/Santiago | Pacific SA Standard Time |
America/Sao_Paulo | E. South America Standard Time |
America/St_Johns | Newfoundland Standard Time |
America/Tijuana | Pacific Standard Time |
Asia/Amman | Jordan Standard Time |
Asia/Baghdad | Arabic Standard Time |
Asia/Baku | Azerbaijan Standard Time |
Asia/Bangkok | SE Asia Standard Time |
Asia/Beirut | Middle East Standard Time |
Asia/Calcutta | India Standard Time |
Asia/Colombo | Sri Lanka Standard Time |
Asia/Dhaka | Central Asia Standard Time |
Asia/Dubai | Arabian Standard Time |
Asia/Irkutsk | North Asia East Standard Time |
Asia/Jerusalem | Israel Standard Time |
Asia/Kabul | Afghanistan Standard Time |
Asia/Karachi | Pakistan Standard Time |
Asia/Katmandu | Nepal Standard Time |
Asia/Krasnoyarsk | North Asia Standard Time |
Asia/Novosibirsk | N. Central Asia Standard Time |
Asia/Rangoon | Myanmar Standard Time |
Asia/Riyadh | Arab Standard Time |
Asia/Seoul | Korea Standard Time |
Asia/Shanghai | China Standard Time |
Asia/Singapore | Singapore Standard Time |
Asia/Taipei | Taipei Standard Time |
Asia/Tashkent | West Asia Standard Time |
Asia/Tehran | Iran Standard Time |
Asia/Tokyo | Tokyo Standard Time |
Asia/Vladivostok | Vladivostok Standard Time |
Asia/Yakutsk | Yakutsk Standard Time |
Asia/Yekaterinburg | Ekaterinburg Standard Time |
Asia/Yerevan | Armenian Standard Time |
Asia/Yerevan | Caucasus Standard Time |
Atlantic/Azores | Azores Standard Time |
Atlantic/Cape_Verde | Cape Verde Standard Time |
Atlantic/South_Georgia | Mid-Atlantic Standard Time |
Australia/Adelaide | Cen. Australia Standard Time |
Australia/Brisbane | E. Australia Standard Time |
Australia/Darwin | AUS Central Standard Time |
Australia/Hobart | Tasmania Standard Time |
Australia/Perth | W. Australia Standard Time |
Australia/Sydney | AUS Eastern Standard Time |
Etc/GMT-3 | Georgian Standard Time |
Etc/GMT+12 | Dateline Standard Time |
Etc/GMT+3 | SA Eastern Standard Time |
Etc/GMT+5 | US Eastern Standard Time |
Europe/Berlin | W. Europe Standard Time |
Europe/Budapest | Central Europe Standard Time |
Europe/Istanbul | GTB Standard Time |
Europe/Kiev | FLE Standard Time |
Europe/London | GMT Standard Time |
Europe/Minsk | E. Europe Standard Time |
Europe/Moscow | Russian Standard Time |
Europe/Paris | Romance Standard Time |
Europe/Warsaw | Central European Standard Time |
Indian/Mauritius | Mauritius Standard Time |
Pacific/Apia | Samoa Standard Time |
Pacific/Auckland | New Zealand Standard Time |
Pacific/Fiji | Fiji Standard Time |
Pacific/Guadalcanal | Central Pacific Standard Time |
Pacific/Honolulu | Hawaiian Standard Time |
Pacific/Port_Moresby | West Pacific Standard Time |
Pacific/Tongatapu | Tonga Standard Time |
Legal Notice
Copy linkLink copied to clipboard!
Copyright © 2018 Red Hat.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}