Resources > Runs (Start a Test Run)

Start a Test Run

Description

Runs a test.

URL

/LoadTest/rest/domains/{domainName}/projects/{projectName}/Runs

Remarks

The ID of the test to run is in the request data. See below.

HTTP Method

POST: Creates the Run resource. Creating the resource runs the test.

Request

Headers:

One of:

None

Cookies:

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

Request Body:

An XML describing the requested run or the equivalent in JSON formant. The fields in the response are:

Element Description
Run The top-level element.
PostRunAction

One of:

  • Do Not Collate
  • Collate Results 
  • Collate And Analyze

TestID The test ID from Application Lifecycle Management (ALM)
TestInstanceID The test instance ID from MyPc in the Test Lab perspective.

TimeslotDuration
     /Hours
     / Minutes

The time to allot for the test.

The minimal time that can be entered when creating a new timeslot is 30 minutes. You can set the time duration in 15 minute increments. For example, 30 minutes, 45 minutes, 1 hr, 1hr 15 minutes.

VudsMode If true, the test consumes Virtual User Day (VUD) licenses.

Response

Headers:

Content-Type: application/xml or Content-Type: application/json

Location: { the link to the new Run entity}. This link is used in all subsequent references to the run. See below in the "See Also" section.

Cookies:

None

HTML Return Code:

One of the HTTP Return Codes

HTML Body:

The data on the new entity. See Run Status XML.

See Also

These resources consume the link returned in the Location header:
Get Run Status
Results
Results/{ID}
stop
stopNow
abort