Return, delete, or update a test by test ID

Description

Returns, deletes, or updates a test design by the specified test ID.

URL

Copy code
/LoadTest/rest/domains/{domainName}/projects/{projectName}/tests/{ID}

Remarks

When updating the test data, the request body contains only the data to be changed. The request body is a subset of Test entity XML.

The test data can be passed as XML containing the equivalent data.

HTTP Method

GET: Returns the design test.

PUT: Updates the design test.

DELETE: Deletes the test.

Request

Headers:

Content-Type: application/xml

Cookies:

Version 2020 (or later)

LWSSO_COOKIE_KEY={LwssoCookie};

Versions earlier than 2020

LWSSO_COOKIE_KEY={LwssoCookie};QCSession={QCSessionCookie};

Request Body:

GET, DELETE: No request body.

PUT: An XML describing the data to be updated in the test. In addition to the updated element, the following elements must always appear: <WorkloadType>, <LGDistribution>, <Groups> and <Scheduler>. See Test entity XML.

Note: Runtime settings data provided in the request overrides the data in the system. For group RTS, only a few values (Pacing, Log, and ThinkTime) are displayed via the REST request. All remaining runtime settings are reset to the script's default settings. For details, see Runtime Settings.

Response

Headers:

One of:

  • Accept: application/xml

  • Accept: application/json

Cookies:

None

HTML Return Code:

One of the HTTP Return Codes

HTML Body:

DELETE and PUT: No body returned.

GET: Returns the data on the entity in the test entity XML or equivalent JSON string. See Test creation XML.

See Also

Create a test
Test entity XML
Test creation XML