Timeslots (Create, Get all timeslots)

Available in versions: 12.56 and later

Description

Adds a timeslot or retrieves a list of existing timeslots.

URL

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

Remarks

Body of the request should contain a resource folder description in xml format.

HTTP Method

POST: Creates a timeslot.

GET: Returns the timeslots in the body of the response.

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:

POST: An XML containing the timeslot reservation.

GET: No request body.

Fields that can be used in the request body during timeslot creation:

ElementDescription
StartTimeThe UTC date and time (in hours and minutes) that the timeslot starts.
DurationInMinutesThe duration of the timeslot (in minutes).
DescriptionA description of the timeslot.
NameName of the timeslot.
Demands

The type of demands for timeslot creation. Can include:

  • ControllerDemandManual. Fields include: HostID (mandatory), IsLoadGenerator (optional)

  • ControllerDemandAutomatic. Contains no fields; any host can be allocated as a Controller.

  • LoadGeneratorDemandManual. Fields: HostID (mandatory)

  • LoadGeneratorDemandAutomatic. Fields: HostsToReserve (mandatory), LocationID (optional)

VusersNumberThe number of Vusers requested for the timeslot.
VudsNumberThe number of VUDs that are defined in the linked test.
PostRunActionThe action to be taken when the test run is complete. The post-run action can be: DoNothing, CollateOnly, or CollateAnalyze.
LoadTestInstanceID Enables you to link a performance test instance to the timeslot.
IsTestAutostart The linked tests or test sets automatically start running at the start of the timeslot, without any manual intervention (true/false).

Response

Headers:

One of:

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

Cookies:

None

HTML Return Code:

One of the HTTP Return Codes

HTML Body:

GET: Returns the data on the entity in the response. See Timeslot XML.

See Also

Timeslots (Delete a timeslot)
Timeslots (Check availability)
Timeslot XML