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
