Menu Close

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 /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>
New host creation applies only to the addition of Red Hat Enterprise Linux hosts. Red Hat Enterprise Virtualization Manager detects hypervisor hosts automatically and requires approval for their use.
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

POST /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 /api/hosts/00000000-0000-0000-0000-000000000000 HTTP/1.1

HTTP/1.1 204 No Content