Microsoft.LoadTestService (preview:2023-04-01)

2025/02/21 • 1 updated methods

LoadTestRun_CreateOrUpdateTestRun (updated)
Description :  Create and start a new test run with the given test run Id.
Reference :  Link ¶

⚶ Changes

{
  "#id": "LoadTestRun_CreateOrUpdateTestRun",
  "$parameters": {
    "body": {
      "$properties": {
        "@removed_81ce186ecae14eaab7d73effd3464312": {
          "#name": "loadTestConfiguration",
          "Description": "The load test configuration.",
          "Required": false,
          "Type": "object",
          "$properties": [
            {
              "#name": "engineInstances",
              "Description": "The number of engine instances to execute load test. Supported values are in range of 1-400. Required for creating a new test.",
              "Format": "int32",
              "Required": false,
              "Type": "integer"
            },
            {
              "#name": "splitAllCSVs",
              "Description": "If false, Azure Load Testing copies and processes your input files unmodified\nacross all test engine instances. If true, Azure Load Testing splits the CSV\ninput data evenly across all engine instances. If you provide multiple CSV\nfiles, each file will be split evenly.",
              "Required": false,
              "Type": "boolean"
            },
            {
              "#name": "quickStartTest",
              "Description": "If true, optionalLoadTestConfig is required and JMX script for the load test is\nnot required to upload.",
              "Required": false,
              "Type": "boolean"
            },
            {
              "#name": "optionalLoadTestConfig",
              "Description": "Configuration for quick load test",
              "Required": false,
              "Type": "object",
              "$properties": [
                {
                  "#name": "endpointUrl",
                  "Description": "Test URL. Provide the complete HTTP URL. For example, https://contoso-app.azurewebsites.net/login",
                  "Required": false,
                  "Type": "string"
                },
                {
                  "#name": "requestsPerSecond",
                  "Description": "Target throughput (requests per second). This may not be necessarily achieved. The actual throughput will be lower if the application is not capable of handling it.",
                  "Format": "int32",
                  "Required": false,
                  "Type": "integer"
                },
                {
                  "#name": "maxResponseTimeInMs",
                  "Description": "Maximum response time in milliseconds of the API/endpoint.",
                  "Format": "int32",
                  "Required": false,
                  "Type": "integer"
                },
                {
                  "#name": "virtualUsers",
                  "Description": "No of concurrent virtual users.",
                  "Format": "int32",
                  "Required": false,
                  "Type": "integer"
                },
                {
                  "#name": "rampUpTime",
                  "Description": "Ramp up time in seconds.",
                  "Format": "int32",
                  "Required": false,
                  "Type": "integer"
                },
                {
                  "#name": "duration",
                  "Description": "Test run duration in seconds.",
                  "Format": "int32",
                  "Required": false,
                  "Type": "integer"
                }
              ]
            }
          ]
        }
      }
    }
  }
}

⚼ Request

PATCH:  /test-runs/{testRunId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
testRunId:
{
Description: Unique test run identifier for the load test run, must contain only lower-case alphabetic, numeric, underscore or hyphen characters. ,
Required: True ,
}
string ,
oldTestRunId:
{
Description: Existing test run identifier that should be rerun, if this is provided, the test will run with the JMX file, configuration and app components from the existing test run. You can override the configuration values for new test run in the request body. ,
Required: False ,
}
string ,
body:
{
Description: The resource instance. ,
Required: True ,
}
{
passFailCriteria:
{
Description: Pass fail criteria for a test. ,
Required: False ,
}
{
passFailMetrics:
{
Description: Map of id and pass fail metrics { id : pass fail metrics }. ,
Required: False ,
}
object ,
}
,
autoStopCriteria:
{
Description: Auto stop criteria for a test. This will automatically stop a load test if the error percentage is high for a certain time window. ,
Required: False ,
}
{
autoStopDisabled:
{
Description: Whether auto-stop should be disabled. The default value is false. ,
Required: False ,
}
boolean ,
errorRate:
{
Description: Threshold percentage of errors on which test run should be automatically stopped. Allowed values are in range of 0.0-100.0 ,
Format: float ,
Required: False ,
}
number ,
errorRateTimeWindowInSeconds:
{
Description: Time window during which the error percentage should be evaluated in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
secrets:
{
Description: Secrets can be stored in an Azure Key Vault or any other secret store. If the secret is stored in an Azure Key Vault, the value should be the secret identifier and the type should be AKV_SECRET_URI. If the secret is stored elsewhere, the secret value should be provided directly and the type should be SECRET_VALUE. ,
Required: False ,
}
object ,
certificate:
{
Description: Certificates metadata ,
Required: False ,
}
{
value:
{
Description: The value of the certificate for respective type ,
Required: False ,
}
string ,
type:
{
Description: Type of certificate ,
Enum:
{
AKV_CERT_URI: If the certificate is stored in an Azure Key Vault. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the certificate. ,
Required: False ,
}
string ,
}
,
environmentVariables:
{
Description: Environment variables which are defined as a set of pairs. ,
Required: False ,
}
object ,
displayName:
{
Description: Display name of a testRun. ,
Required: False ,
}
string ,
testId:
{
Description: Associated test Id. ,
Required: False ,
}
string ,
description:
{
Description: The test run description. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
testRunId:
{
Description: Unique test run identifier for the load test run, must contain only lower-case alphabetic, numeric, underscore or hyphen characters. ,
Required: True ,
}
string ,
passFailCriteria:
{
Description: Pass fail criteria for a test. ,
Required: False ,
}
{
passFailMetrics:
{
Description: Map of id and pass fail metrics { id : pass fail metrics }. ,
Required: False ,
}
object ,
}
,
autoStopCriteria:
{
Description: Auto stop criteria for a test. This will automatically stop a load test if the error percentage is high for a certain time window. ,
Required: False ,
}
{
autoStopDisabled:
{
Description: Whether auto-stop should be disabled. The default value is false. ,
Required: False ,
}
boolean ,
errorRate:
{
Description: Threshold percentage of errors on which test run should be automatically stopped. Allowed values are in range of 0.0-100.0 ,
Format: float ,
Required: False ,
}
number ,
errorRateTimeWindowInSeconds:
{
Description: Time window during which the error percentage should be evaluated in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
secrets:
{
Description: Secrets can be stored in an Azure Key Vault or any other secret store. If the secret is stored in an Azure Key Vault, the value should be the secret identifier and the type should be AKV_SECRET_URI. If the secret is stored elsewhere, the secret value should be provided directly and the type should be SECRET_VALUE. ,
Required: False ,
}
object ,
certificate:
{
Description: Certificates metadata ,
Required: False ,
}
{
value:
{
Description: The value of the certificate for respective type ,
Required: False ,
}
string ,
type:
{
Description: Type of certificate ,
Enum:
{
AKV_CERT_URI: If the certificate is stored in an Azure Key Vault. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the certificate. ,
Required: False ,
}
string ,
}
,
environmentVariables:
{
Description: Environment variables which are defined as a set of pairs. ,
Required: False ,
}
object ,
errorDetails:
{
Description: Error details if there is any failure in load test run ,
Required: False ,
}
[
{
message:
{
Description: Error details in case test run was not successfully run. ,
Required: False ,
}
string ,
}
,
]
,
testRunStatistics:
{
Description: Test run statistics. Key is the sampler name and value is the set of statistics for performance metrics like response time, throughput, etc. from the load test run. The sampler name is the same as the name mentioned in the test script. Sampler name "Total" represents the aggregated statistics of all the samplers. ,
Required: False ,
}
object ,
loadTestConfiguration:
{
Description: The load test configuration. ,
Required: False ,
}
{
engineInstances:
{
Description: The number of engine instances to execute load test. Supported values are in range of 1-400. Required for creating a new test. ,
Format: int32 ,
Required: False ,
}
integer ,
splitAllCSVs:
{
Description: If false, Azure Load Testing copies and processes your input files unmodified across all test engine instances. If true, Azure Load Testing splits the CSV input data evenly across all engine instances. If you provide multiple CSV files, each file will be split evenly. ,
Required: False ,
}
boolean ,
quickStartTest:
{
Description: If true, optionalLoadTestConfig is required and JMX script for the load test is not required to upload. ,
Required: False ,
}
boolean ,
optionalLoadTestConfig:
{
Description: Configuration for quick load test ,
Required: False ,
}
{
endpointUrl:
{
Description: Test URL. Provide the complete HTTP URL. For example, https://contoso-app.azurewebsites.net/login ,
Required: False ,
}
string ,
requestsPerSecond:
{
Description: Target throughput (requests per second). This may not be necessarily achieved. The actual throughput will be lower if the application is not capable of handling it. ,
Format: int32 ,
Required: False ,
}
integer ,
maxResponseTimeInMs:
{
Description: Maximum response time in milliseconds of the API/endpoint. ,
Format: int32 ,
Required: False ,
}
integer ,
virtualUsers:
{
Description: No of concurrent virtual users. ,
Format: int32 ,
Required: False ,
}
integer ,
rampUpTime:
{
Description: Ramp up time in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
duration:
{
Description: Test run duration in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
testArtifacts:
{
Description: Collection of test run artifacts ,
Required: False ,
}
{
inputArtifacts:
{
Description: The input artifacts for the test run. ,
Required: False ,
}
{
configFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
testScriptFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
userPropFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
inputArtifactsZipFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
urlTestConfigFileInfo:
{
Description: The config json file for url based test ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
additionalFileInfo:
{
Description: Additional supported files for the test run ,
Required: False ,
}
[
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
]
,
}
,
outputArtifacts:
{
Description: The output artifacts for the test run. ,
Required: False ,
}
{
resultFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
logsFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
artifactsContainerInfo:
{
Description: The container for test run artifacts. ,
Required: False ,
}
{
url:
{
Description: This is a SAS URI to an Azure Storage Container that contains the test run artifacts. ,
Format: uri ,
Required: False ,
}
string ,
expireDateTime:
{
Description: Expiry time of the container (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}
,
testResult:
{
Description: Test result for pass/Fail criteria used during the test run. ,
Enum:
{
PASSED: Pass/fail criteria has passed. ,
NOT_APPLICABLE: Pass/fail criteria is not applicable. ,
FAILED: Pass/fail criteria has failed. ,
}
,
Required: False ,
}
enum ,
virtualUsers:
{
Description: Number of virtual users, for which test has been run. ,
Format: int32 ,
Required: False ,
}
integer ,
displayName:
{
Description: Display name of a testRun. ,
Required: False ,
}
string ,
testId:
{
Description: Associated test Id. ,
Required: False ,
}
string ,
description:
{
Description: The test run description. ,
Required: False ,
}
string ,
status:
{
Description: The test run status. ,
Enum:
{
ACCEPTED: Test run request is accepted. ,
NOTSTARTED: Test run is not yet started. ,
PROVISIONING: Test run is provisioning. ,
PROVISIONED: Test run is provisioned. ,
CONFIGURING: Test run is getting configured. ,
CONFIGURED: Test run configuration is done. ,
EXECUTING: Test run has started executing. ,
EXECUTED: Test run execution is completed. ,
DEPROVISIONING: Test run is getting deprovisioned. ,
DEPROVISIONED: Test run is deprovisioned. ,
DONE: Test run is completed. ,
CANCELLING: Test run is being cancelled. ,
CANCELLED: Test run request is cancelled. ,
FAILED: Test run request is failed. ,
VALIDATION_SUCCESS: Test run JMX file is validated. ,
VALIDATION_FAILURE: Test run JMX file validation is failed. ,
}
,
Required: False ,
}
enum ,
startDateTime:
{
Description: The test run start DateTime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: The test run end DateTime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
executedDateTime:
{
Description: Test run initiated time. ,
Format: date-time ,
Required: False ,
}
string ,
portalUrl:
{
Description: Portal url. ,
Required: False ,
}
string ,
duration:
{
Description: Test run duration in milliseconds. ,
Format: int64 ,
Required: False ,
}
integer ,
subnetId:
{
Description: Subnet ID on which the load test instances should run. ,
Required: False ,
}
string ,
kind:
{
Description: Type of test. ,
Enum:
{
URL: URL Test ,
JMX: JMX Test ,
}
,
Required: False ,
}
enum ,
publicIPDisabled:
{
Description: Inject load test engines without deploying public IP for outbound access ,
Required: False ,
}
boolean ,
createdDateTime:
{
Description: The creation datetime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
createdBy:
{
Description: The user that created. ,
Required: False ,
}
string ,
lastModifiedDateTime:
{
Description: The last Modified datetime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The user that last modified. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
testRunId:
{
Description: Unique test run identifier for the load test run, must contain only lower-case alphabetic, numeric, underscore or hyphen characters. ,
Required: True ,
}
string ,
passFailCriteria:
{
Description: Pass fail criteria for a test. ,
Required: False ,
}
{
passFailMetrics:
{
Description: Map of id and pass fail metrics { id : pass fail metrics }. ,
Required: False ,
}
object ,
}
,
autoStopCriteria:
{
Description: Auto stop criteria for a test. This will automatically stop a load test if the error percentage is high for a certain time window. ,
Required: False ,
}
{
autoStopDisabled:
{
Description: Whether auto-stop should be disabled. The default value is false. ,
Required: False ,
}
boolean ,
errorRate:
{
Description: Threshold percentage of errors on which test run should be automatically stopped. Allowed values are in range of 0.0-100.0 ,
Format: float ,
Required: False ,
}
number ,
errorRateTimeWindowInSeconds:
{
Description: Time window during which the error percentage should be evaluated in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
secrets:
{
Description: Secrets can be stored in an Azure Key Vault or any other secret store. If the secret is stored in an Azure Key Vault, the value should be the secret identifier and the type should be AKV_SECRET_URI. If the secret is stored elsewhere, the secret value should be provided directly and the type should be SECRET_VALUE. ,
Required: False ,
}
object ,
certificate:
{
Description: Certificates metadata ,
Required: False ,
}
{
value:
{
Description: The value of the certificate for respective type ,
Required: False ,
}
string ,
type:
{
Description: Type of certificate ,
Enum:
{
AKV_CERT_URI: If the certificate is stored in an Azure Key Vault. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the certificate. ,
Required: False ,
}
string ,
}
,
environmentVariables:
{
Description: Environment variables which are defined as a set of pairs. ,
Required: False ,
}
object ,
errorDetails:
{
Description: Error details if there is any failure in load test run ,
Required: False ,
}
[
{
message:
{
Description: Error details in case test run was not successfully run. ,
Required: False ,
}
string ,
}
,
]
,
testRunStatistics:
{
Description: Test run statistics. Key is the sampler name and value is the set of statistics for performance metrics like response time, throughput, etc. from the load test run. The sampler name is the same as the name mentioned in the test script. Sampler name "Total" represents the aggregated statistics of all the samplers. ,
Required: False ,
}
object ,
loadTestConfiguration:
{
Description: The load test configuration. ,
Required: False ,
}
{
engineInstances:
{
Description: The number of engine instances to execute load test. Supported values are in range of 1-400. Required for creating a new test. ,
Format: int32 ,
Required: False ,
}
integer ,
splitAllCSVs:
{
Description: If false, Azure Load Testing copies and processes your input files unmodified across all test engine instances. If true, Azure Load Testing splits the CSV input data evenly across all engine instances. If you provide multiple CSV files, each file will be split evenly. ,
Required: False ,
}
boolean ,
quickStartTest:
{
Description: If true, optionalLoadTestConfig is required and JMX script for the load test is not required to upload. ,
Required: False ,
}
boolean ,
optionalLoadTestConfig:
{
Description: Configuration for quick load test ,
Required: False ,
}
{
endpointUrl:
{
Description: Test URL. Provide the complete HTTP URL. For example, https://contoso-app.azurewebsites.net/login ,
Required: False ,
}
string ,
requestsPerSecond:
{
Description: Target throughput (requests per second). This may not be necessarily achieved. The actual throughput will be lower if the application is not capable of handling it. ,
Format: int32 ,
Required: False ,
}
integer ,
maxResponseTimeInMs:
{
Description: Maximum response time in milliseconds of the API/endpoint. ,
Format: int32 ,
Required: False ,
}
integer ,
virtualUsers:
{
Description: No of concurrent virtual users. ,
Format: int32 ,
Required: False ,
}
integer ,
rampUpTime:
{
Description: Ramp up time in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
duration:
{
Description: Test run duration in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
testArtifacts:
{
Description: Collection of test run artifacts ,
Required: False ,
}
{
inputArtifacts:
{
Description: The input artifacts for the test run. ,
Required: False ,
}
{
configFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
testScriptFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
userPropFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
inputArtifactsZipFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
urlTestConfigFileInfo:
{
Description: The config json file for url based test ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
additionalFileInfo:
{
Description: Additional supported files for the test run ,
Required: False ,
}
[
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
]
,
}
,
outputArtifacts:
{
Description: The output artifacts for the test run. ,
Required: False ,
}
{
resultFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
logsFileInfo:
{
Description: File info ,
Required: False ,
}
{
fileName:
{
Description: Name of the file. ,
Required: True ,
}
string ,
url:
{
Description: File URL. ,
Format: uri ,
Required: False ,
}
string ,
fileType:
{
Description: File type ,
Enum:
{
JMX_FILE: If the file is a JMX script. ,
USER_PROPERTIES: If the file is a user properties file. ,
ADDITIONAL_ARTIFACTS: If the file is not among any of the other supported file types. ,
ZIPPED_ARTIFACTS: If the file is a compressed archive containing a collection of various artifacts or resources. ,
URL_TEST_CONFIG: If the file is a JSON config file to define the requests for a URL test. ,
}
,
Required: False ,
}
enum ,
expireDateTime:
{
Description: Expiry time of the file (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status of the file ,
Enum:
{
NOT_VALIDATED: File is not validated. ,
VALIDATION_SUCCESS: File is validated. ,
VALIDATION_FAILURE: File validation is failed. ,
VALIDATION_INITIATED: File validation is in progress. ,
VALIDATION_NOT_REQUIRED: Validation is not required. ,
}
,
Required: False ,
}
enum ,
validationFailureDetails:
{
Description: Validation failure error details ,
Required: False ,
}
string ,
}
,
artifactsContainerInfo:
{
Description: The container for test run artifacts. ,
Required: False ,
}
{
url:
{
Description: This is a SAS URI to an Azure Storage Container that contains the test run artifacts. ,
Format: uri ,
Required: False ,
}
string ,
expireDateTime:
{
Description: Expiry time of the container (RFC 3339 literal format) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}
,
testResult:
{
Description: Test result for pass/Fail criteria used during the test run. ,
Enum:
{
PASSED: Pass/fail criteria has passed. ,
NOT_APPLICABLE: Pass/fail criteria is not applicable. ,
FAILED: Pass/fail criteria has failed. ,
}
,
Required: False ,
}
enum ,
virtualUsers:
{
Description: Number of virtual users, for which test has been run. ,
Format: int32 ,
Required: False ,
}
integer ,
displayName:
{
Description: Display name of a testRun. ,
Required: False ,
}
string ,
testId:
{
Description: Associated test Id. ,
Required: False ,
}
string ,
description:
{
Description: The test run description. ,
Required: False ,
}
string ,
status:
{
Description: The test run status. ,
Enum:
{
ACCEPTED: Test run request is accepted. ,
NOTSTARTED: Test run is not yet started. ,
PROVISIONING: Test run is provisioning. ,
PROVISIONED: Test run is provisioned. ,
CONFIGURING: Test run is getting configured. ,
CONFIGURED: Test run configuration is done. ,
EXECUTING: Test run has started executing. ,
EXECUTED: Test run execution is completed. ,
DEPROVISIONING: Test run is getting deprovisioned. ,
DEPROVISIONED: Test run is deprovisioned. ,
DONE: Test run is completed. ,
CANCELLING: Test run is being cancelled. ,
CANCELLED: Test run request is cancelled. ,
FAILED: Test run request is failed. ,
VALIDATION_SUCCESS: Test run JMX file is validated. ,
VALIDATION_FAILURE: Test run JMX file validation is failed. ,
}
,
Required: False ,
}
enum ,
startDateTime:
{
Description: The test run start DateTime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: The test run end DateTime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
executedDateTime:
{
Description: Test run initiated time. ,
Format: date-time ,
Required: False ,
}
string ,
portalUrl:
{
Description: Portal url. ,
Required: False ,
}
string ,
duration:
{
Description: Test run duration in milliseconds. ,
Format: int64 ,
Required: False ,
}
integer ,
subnetId:
{
Description: Subnet ID on which the load test instances should run. ,
Required: False ,
}
string ,
kind:
{
Description: Type of test. ,
Enum:
{
URL: URL Test ,
JMX: JMX Test ,
}
,
Required: False ,
}
enum ,
publicIPDisabled:
{
Description: Inject load test engines without deploying public IP for outbound access ,
Required: False ,
}
boolean ,
createdDateTime:
{
Description: The creation datetime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
createdBy:
{
Description: The user that created. ,
Required: False ,
}
string ,
lastModifiedDateTime:
{
Description: The last Modified datetime(RFC 3339 literal format). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The user that last modified. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: A response containing error details. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}