Open topic with navigation

# 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

host pools/{poolID}
Get Host Pool List by Query