Start a Multi-Test
API Explorer: /multi-tests/{collectionId}/start
To start a preconfigured load test, you need to know the collectionId
of a created and configured test. The sample code executes a test with a collectionId
of 12345678
. Use the collectionId
of the actual test to start in place of the 12345678
.
You can create and configure the test through the UI or through the API.
The first
The first
id
returned in the response is a masterId
. You can use this ID as a reference to this instance of a test launch. For example, send it using the Stop a Test Run
API to stop this running instance.If you do not know the ID of the test to start, use List Multi-Tests to return a list of your created tests.
You can also get the
scenarioId
and location id
from this response, which can be used to narrow down your results by the scenario or location. This is covered, in detail, in the the Test Results Advanced Settings section.Start a Multi-Test
curl 'https://a.blazemeter.com/api/v4/multi-tests/12345678/start?delayedStart=true' \
-X POST \
-H 'Content-Type: application/json' \
--user 'api_key_id:api_key_secret'
Start a Multi-Test Parameters
Parameters
-
delayedStart
booleanDenotes if the test run will wait to start for a set amount of time after all engines are ready
Start a Multi-Test Response Attributes
For the full details of all the attributes for the test run response, you can visit The Master Object.
Response202 Accepted
{
"api_version": 4,
"error": null,
"result": {
"id": 12345678,
"name": "March_08_9:49 AM - Multi-Test",
"userId": 123456,
"publicToken": null,
"ended": null,
"lastUpdate": null,
"delayedStartReady": false,
"runnerUserId": 123456,
"charges": [],
"usage": null,
"maxUsers": null,
"type": null,
"passed": null,
"canControlRampup": null,
"targetThreads": null,
"parallelTestsInWorkspace": 1,
"parallelTestsInAccount": 1,
"isSandbox": null,
"isPrivateData": false,
"executionMode": null,
"creatorClientId": "gui",
"executorClientId": "gui",
"importedAt": null,
"secondsPerLabelDoc": 60,
"taurusRemoteControlProperties": null,
"labelsCollectionSuffix": "_17_12",
"locations": [
"us-east-1"
],
"scenariosMapping": [
{
"id": "f7cebdaa474a27fc93dcff0fd3d97bd116c1f867a6f17639f0fc197eec1f4e5a",
"name": "default-scenario-1234567",
"test": "New Dummy Test V4 2",
"isEndUserExperience": false
},
{
"id": "420248ab89308dba84fc4c15c70f537cdfc938ff4dbe1dd83a7bfe2be32d2a1a",
"name": "default-scenario-2345678",
"test": "Parallel Controller Script V4",
"isEndUserExperience": false
}
],
"isDebugRun": false,
"executions": [
{
"concurrency": 20,
"holdFor": "19m",
"rampUp": "1m",
"steps": 0,
"locations": {
"us-east-1": 20
},
"locationsPercents": {
"us-east-1": 100
},
"executor": "jmeter",
"testId": 1234567,
"scenario": "default-scenario-1234567"
},
{
"concurrency": 20,
"holdFor": "19m",
"rampUp": "1m",
"steps": 0,
"locations": {
"us-east-1": 20
},
"locationsPercents": {
"us-east-1": 100
},
"executor": "jmeter",
"testId": 2345678,
"scenario": "default-scenario-2345678"
}
],
"concurrency": 40,
"useV4Pipeline": true,
"terminatedAt": null,
"shutdownAt": null,
"jupyterToken": null,
"jupyterHeartbeat": null,
"jupyterHost": null,
"jupyterPort": null,
"jupyterNotebook": null,
"v4IndexerCollection": "{\"execution\":[1],\"execution:1\":[\"r-v4-5c828f01e093c\",\"r-v4-5c828f01e6d6d\"],\"session:1\":[\"r-v4-5c828f01e093c\",\"r-v4-5c828f01e6d6d\"],\"location:1\":[\"us-east-1\"]}",
"buildId": null,
"isSelenium": false,
"isExternal": null,
"rpsCompatible": false,
"remoteControlCompatible": false,
"hasMonitoringData": null,
"shouldSendReportEmail": true,
"hasDaggerData": false,
"kinesisStream": "prod-grn_v4pipeline_input",
"properties": null,
"created": 1552060161,
"updated": 1552060161,
"note": null,
"testCollectionId": 12345678,
"testId": null,
"projectId": 123456,
"scheduleHistoryRecordId": null,
"jupyterShipId": null,
"sessionsId": [
"r-v4-5c828f01e093c",
"r-v4-5c828f01e6d6d"
],
"functionalSummary": null,
"thresholds": [
{
"thresholds": [],
"ignoreRampup": false,
"ignoreRampupTime": null,
"slidingWindow": false,
"testId": 1234567
},
{
"thresholds": [],
"ignoreRampup": false,
"ignoreRampupTime": null,
"slidingWindow": false,
"testId": 2345678
}
]
}
}