14.6. Methods

14.6.1. Creating a Host

Creation of a new host requires the name, address and root_password elements.

Example 14.6. Creating a host

POST /ovirt-engine/api/hosts HTTP/1.1
Accept: application/xml
Content-type: application/xml

<host>
    <name>host2</name>
    <address>host2.example.com</address>
    <root_password>p@55w0Rd!</root_password>
</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

The name, description, cluster, power_management, transparent_hugepages and ksm elements are updatable post-creation.

Example 14.7. Updating a host

PUT /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<host>
    <name>host3</name>
</host>

14.6.3. Removing a Host

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