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)	ADM_LWSSO={AdmLwssoCookie};
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

Copy code

POST http://<LRE_Server>/Admin/rest/v1/pools
Content-Type: application/xml
Accept: application/xml
Cookie: ADM_LWSSO={AdmLwssoCookie};

<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.