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
