Share this page
host pools
Description
Create a host pool or returns a list of host pools.
URL
/Admin/rest/v1/pools
Remarks
The host pools data can be passed as XML containing the equivalent data.
To add a host pool to LAB_PROJECT, you need to send an HTTP request to create a Host Pool resource.
HTTP Method
POST: Creates the host pool.
GET: Returns a list of host pools.
Request
Headers:
Content-Type: application/xml
Accept: application/xml
Cookies:
| Version 2020 (or later) | LWSSO_COOKIE_KEY={LwssoCookie}; |
| Versions earlier than 2020 | LWSSO_COOKIE_KEY={LwssoCookie};QCSession={QCSessionCookie}; |
Request Body:
GET: No request body.
POST: An XML describing the host.
The fields in the response are:
| Element | Description |
|---|---|
| ID | The host pool ID. |
| Name | The name of the host pool. |
| Description | Description of the host pool (optional). |
| Hosts | Contains Host sub elements which list the host ID assigned to the pool. |
Request Example
POST http://<LRE_Server>/Admin/rest/v1/pools
Content-Type: application/xml
Accept: application/xml
Cookie: LWSSO_COOKIE_KEY={LwssoCookie};
<HostPool>
<Name>Testing_Pool</Name>
<Description>System created testing</Description>
</HostPool>Response
Headers:
Content-Type: application/xml
Cookies:
None
HTML Return Code:
One of the HTTP Return Codes
Upon successful deletion, returns HTTP status 201 (Created).
HTML Body:
GET: Returns the data on the entity in the response. See host pool response.
POST: Returns XML of the pool.
See Also
