Load Testing API, REST: Test.list
Retrieves the list of test in the specified folder.
HTTP request
GET https://loadtesting.api.cloud.yandex.net/loadtesting/api/v1/tests
Query parameters
Parameter | Description |
---|---|
folderId | ID of the folder to list tests in. |
pageSize | The maximum number of results per page to return. If the number of available results is larger than |
pageToken | Page token. To get the next page of results, set |
filter | A filter expression that filters tests listed in the response. The filter expression may contain multiple field expressions joined by
Currently supported fields:
Examples:
|
Response
HTTP Code: 200 - OK
{
"tests": [
{
"id": "string",
"configurations": [
{
"configId": "string",
"agentSelector": {
// `tests[].configurations[].agentSelector` includes only one of the fields `agentId`, `matchByFilter`, `anonymousAgent`
"agentId": "string",
"matchByFilter": "string",
"anonymousAgent": true,
// end of the list of possible fields`tests[].configurations[].agentSelector`
},
"files": "object"
}
],
"details": {
"name": "string",
"description": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"loggingLogGroupId": "string",
"artifactSettings": {
"isArchive": true,
"filterInclude": [
"string"
],
"filterExclude": [
"string"
],
"objectStorageBucket": "string"
}
},
"summary": {
"status": "string",
"createdAt": "string",
"createdBy": "string",
"startedAt": "string",
"finishedAt": "string",
"isFinished": true,
"error": "string",
"imbalancePoint": {
"at": "string",
"rps": "string",
"comment": "string"
},
"assignedAgentId": "string",
"artifacts": {
"objectStorage": {
"bucket": "string",
"name": "string"
}
}
},
"folderId": "string"
}
],
"nextPageToken": "string"
}
Field | Description |
---|---|
tests[] | object List of tests in the specified folder. |
tests[]. id |
string ID of the test. Generated at creation time. |
tests[]. configurations[] |
object Configuration of the test. A test can have multiple configurations if it can be executed on multiple agents simultaneously. For more information, see Load testing using multiple agents. |
tests[]. configurations[]. configId |
string ID of the config. |
tests[]. configurations[]. agentSelector |
object Agent selection criterion. Agent selection criterion. The structure is used by service to determine on which agents a specific test should be executed. |
tests[]. configurations[]. agentSelector. agentId |
string tests[].configurations[].agentSelector includes only one of the fields agentId , matchByFilter , anonymousAgent Selection by agent ID. |
tests[]. configurations[]. agentSelector. matchByFilter |
string tests[].configurations[].agentSelector includes only one of the fields agentId , matchByFilter , anonymousAgent Selection by filter string. |
tests[]. configurations[]. agentSelector. anonymousAgent |
boolean (boolean) tests[].configurations[].agentSelector includes only one of the fields agentId , matchByFilter , anonymousAgent Select anonymoud (i.e. not registered) agents. |
tests[]. configurations[]. files |
object Additional files to be used during test execution, represented as
Use cases include:
|
tests[]. details |
object Test meta information. Name, description, etc. Test meta information. |
tests[]. details. name |
string Name of the test. Value must match the regular expression |
tests[]. details. description |
string Description of the test. The maximum string length in characters is 256. |
tests[]. details. tags[] |
object Tags assigned to the test. |
tests[]. details. tags[]. key |
string Key of the tag. |
tests[]. details. tags[]. value |
string Value of the tag. |
tests[]. details. loggingLogGroupId |
string ID of the logging group to which test artifacts are uploaded. |
tests[]. details. artifactSettings |
object Settings which define where to upload test artifacts and which files should be included. Artifact upload settings. Defines where to upload test artifacts and which files should be included. |
tests[]. details. artifactSettings. isArchive |
boolean (boolean) Setting which defines whether artifact files should be archived prior to uploading. |
tests[]. details. artifactSettings. filterInclude[] |
string Filter strings defining which files should be included to artifacts. GLOB format. Example:
|
tests[]. details. artifactSettings. filterExclude[] |
string Filter strings defining which files should be excluded from artifacts. GLOB format. Example:
|
tests[]. details. artifactSettings. objectStorageBucket |
string Name of output object storage bucket in test's folder. |
tests[]. summary |
object Test execution information. Process of test and some results |
tests[]. summary. status |
string Status of the test.
|
tests[]. summary. createdAt |
string (date-time) Creation timestamp. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |
tests[]. summary. createdBy |
string UA or SA that created the test. |
tests[]. summary. startedAt |
string (date-time) Test start timestamp. Empty if the test has not been started yet. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |
tests[]. summary. finishedAt |
string (date-time) Test finish timestamp. Empty if the test has not been finished yet. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |
tests[]. summary. isFinished |
boolean (boolean) Indicates whether the test is finished. |
tests[]. summary. error |
string Error message. |
tests[]. summary. imbalancePoint |
object Detected imbalance point. Contains information about a state at the moment it has been auto-stopped. Empty if no auto-stop occured. Test imbalance point. |
tests[]. summary. imbalancePoint. at |
string (date-time) Imbalance moment timestamp. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |
tests[]. summary. imbalancePoint. rps |
string (int64) Imbalance moment RPS. |
tests[]. summary. imbalancePoint. comment |
string Imbalance reason comment. |
tests[]. summary. assignedAgentId |
string ID of the agent that executed the test. |
tests[]. summary. artifacts |
object Test output artifacts. Link to the artifacts output target containing Variant-like structure for referencing files in different sources. |
tests[]. summary. artifacts. objectStorage |
object Reference to a file in Object Storage. |
tests[]. summary. artifacts. objectStorage. bucket |
string Bucket name. |
tests[]. summary. artifacts. objectStorage. name |
string File name. |
tests[]. folderId |
string ID of the folder that the test belongs to. |
nextPageToken | string Token for getting the next page of the list. If the number of results is greater than the specified pageSize, use Each subsequent page will have its own |