Get host location

Available in versions: 26.1 and later

Description

Returns a list of host locations with name and ID.

URL

Copy code
/LoadTest/rest/domains/{domainName}/projects/{projectName}/locations

HTTP method

GET: Returns a list of host locations with name and ID.

Request

Headers:

One of the following:

  • Content-Type: application/xml

  • Content-Type: application/json

Cookies:

Version Cookie
2020 or later

LWSSO_COOKIE_KEY={LwssoCookie};

Request body:

No request body.

Response

Headers:

One of:

  • Accept: application/xml

  • Accept: application/json

Cookies:

None

HTML return code:

One of the HTTP return codes

Upon success, it returns HTTP status 200 (OK).

HTML body:

A list of the available host locations with name and ID. If there are no host locations, an empty list will be returned. If the user is not authenticated, an error is returned.

Response examples:

Copy code
XML example:
<Locations>
    <Location>
        <ID>1000</ID>
        <Name>Default</Name>           
    <Location>
     <Location>
        <ID>1100</ID>
        <Name>other</Name>           
    <Location>
     <Location>
        <ID>1101</ID>
        <Name>Location3</Name>           
    <Location>
</Locations>
Copy code
JSON example:
{
  "Locations": [
    {
      "ID": 1000,
      "Name": "Default"
    },
    {
      "ID": 1100,
      "Name": "other"
    },
    {
      "ID": 1101,
      "Name": "Location3"
    }
  ]
}

See also: