Share via

Runs - Update

Service:
Test
API Version:
7.1

Update test run by its ID.

PATCH https://dev.azure.com/{organization}/{project}/_apis/test/runs/{runId}?api-version=7.1

URI Parameters

Name In Required Type Description
organization
 path True

string

The name of the Azure DevOps organization.
project
 path True

string

Project ID or project name
runId
 path True

integer (int32)

ID of the run to update.
api-version
 query True

string

Version of the API to use. This should be set to '7.1' to use this version of the api.

Request Body

Name Type Description
build

ShallowReference

An abstracted reference to the build that it belongs.
buildDropLocation

string

Drop location of the build used for test run.
buildFlavor

string

Flavor of the build used for test run. (E.g: Release, Debug)
buildPlatform

string

Platform of the build used for test run. (E.g.: x86, amd64)
comment

string

Comments entered by those analyzing the run.
completedDate

string

Completed date time of the run.
controller

string

Name of the test controller used for automated run.
deleteInProgressResults

boolean

true to delete inProgess Results , false otherwise.
dtlAutEnvironment

ShallowReference

An abstracted reference to DtlAutEnvironment.
dtlEnvironment

ShallowReference

An abstracted reference to DtlEnvironment.
dtlEnvironmentDetails

DtlEnvironmentDetails

This is a temporary class to provide the details for the test run environment.
dueDate

string

Due date and time for test run.
errorMessage

string

Error message associated with the run.
iteration

string

The iteration in which to create the run.
logEntries

TestMessageLogDetails[]

Log entries associated with the run. Use a comma-separated list of multiple log entry objects. { logEntry }, { logEntry }, ...
name

string

Name of the test run.
releaseEnvironmentUri

string

URI of release environment associated with the run.
releaseUri

string

URI of release associated with the run.
runSummary

RunSummaryModel[]

Run summary for run Type = NoConfigRun.
sourceWorkflow

string

SourceWorkFlow(CI/CD) of the test run.
startedDate

string

Start date time of the run.
state

string

The state of the test run Below are the valid values - NotStarted, InProgress, Completed, Aborted, Waiting
substate

TestRunSubstate

The types of sub states for test run.
tags

TestTag[]

Tags to attach with the test run.
testEnvironmentId

string

ID of the test environment associated with the run.
testSettings

ShallowReference

An abstracted reference to test setting resource.

Responses

Name Type Description
200 OK

TestRun

successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name Description
vso.test_write Grants the ability to read, create, and update test plans, cases, results and other test management related artifacts.

Examples

General example
Updating due date
Updating run comment
Updating started date

General example

Sample request

PATCH https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs/1?api-version=7.1

{
  "name": "NewTestRun2",
  "comment": "This test run is doomed"
}

Sample response

Status code:
200 
{
  "id": 1,
  "name": "NewTestRun2",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/1",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "startedDate": "2014-05-05T00:00:00Z",
  "completedDate": "2014-05-10T00:00:00Z",
  "state": "Completed",
  "plan": {
    "id": "60",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/60"
  },
  "postProcessState": "Complete",
  "dueDate": "2014-05-07T00:00:00Z",
  "totalTests": 1,
  "passedTests": 1,
  "createdDate": "2014-05-04T12:50:31.38Z",
  "lastUpdatedDate": "2014-10-07T22:19:01.557Z",
  "lastUpdatedBy": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "revision": 24,
  "comment": "This test run is doomed"
}

Updating due date

Sample request

PATCH https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs/1?api-version=7.1

{
  "dueDate": "2014-05-07"
}

Sample response

Status code:
200 
{
  "id": 1,
  "name": "NewTestRun2",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/1",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "startedDate": "2014-05-04T12:50:33.17Z",
  "completedDate": "2014-05-04T12:50:31.953Z",
  "state": "Completed",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "dueDate": "2014-05-07T00:00:00Z",
  "totalTests": 1,
  "passedTests": 1,
  "createdDate": "2014-05-04T12:50:31.38Z",
  "lastUpdatedDate": "2014-05-06T15:54:46.697Z",
  "lastUpdatedBy": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "revision": 6,
  "comment": "This test run is doomed"
}

Updating run comment

Sample request

PATCH https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs/1?api-version=7.1

{
  "comment": "This test run is doomed"
}

Sample response

Status code:
200 
{
  "id": 1,
  "name": "NewTestRun2",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/1",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "startedDate": "2014-05-05T00:00:00Z",
  "completedDate": "2014-05-10T00:00:00Z",
  "state": "Completed",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "dueDate": "2014-05-07T00:00:00Z",
  "totalTests": 1,
  "passedTests": 1,
  "createdDate": "2014-05-04T12:50:31.38Z",
  "lastUpdatedDate": "2014-05-06T15:54:56.327Z",
  "lastUpdatedBy": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "revision": 9,
  "comment": "This test run is doomed"
}

Updating started date

Sample request

PATCH https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs/{runId}?api-version=7.1

{
  "startedDate": "2014-05-05"
}

Sample response

Status code:
200 
{
  "id": 1,
  "name": "NewTestRun2",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/1",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "startedDate": "2014-05-05T00:00:00Z",
  "completedDate": "2014-05-04T12:50:31.953Z",
  "state": "Completed",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "dueDate": "2014-05-07T00:00:00Z",
  "totalTests": 1,
  "passedTests": 1,
  "createdDate": "2014-05-04T12:50:31.38Z",
  "lastUpdatedDate": "2014-05-06T15:54:50.353Z",
  "lastUpdatedBy": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "revision": 7,
  "comment": "This test run is doomed"
}

Definitions

Name Description
BuildConfiguration

BuildConfiguration Details.
CustomTestField

A custom field information. Allowed Key : Value pairs - ( AttemptId: int value, IsTestResultFlaky: bool)
DtlEnvironmentDetails

This is a temporary class to provide the details for the test run environment.
IdentityRef
JobReference

Job in pipeline. This is related to matrixing in YAML.
PhaseReference

Phase in pipeline
PipelineReference

Pipeline reference
ReferenceLinks

The class to represent a collection of REST reference links.
ReleaseReference

Reference to a release.
ResultMetadata

ResultMetadata for the given outcome/count.
RunFilter

This class is used to provide the filters used for discovery
RunStatistic

Test run statistics per outcome.
RunSummaryModel

Run summary for each output type of test.
RunUpdateModel
ShallowReference

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.
StageReference

Stage in pipeline
TestEnvironment

Test environment Detail.
TestMessageLogDetails

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.
TestOutcome
TestResolutionState

Test Resolution State Details.
TestRun

Test run details.
TestRunSubstate

The types of sub states for test run.
TestTag

Tag attached to a run or result.

BuildConfiguration

Object

BuildConfiguration Details.

Name Type Description
branchName

string

Branch name for which build is generated.
buildDefinitionId

integer (int32)

BuildDefinitionId for build.
buildSystem

string

Build system.
creationDate

string (date-time)

Build Creation Date.
flavor

string

Build flavor (eg Build/Release).
id

integer (int32)

BuildConfiguration Id.
number

string

Build Number.
platform

string

BuildConfiguration Platform.
project

ShallowReference

Project associated with this BuildConfiguration.
repositoryGuid

string

Repository Guid for the Build.
repositoryType

string

Repository Type (eg. TFSGit).
sourceVersion

string

Source Version(/first commit) for the build was triggered.
targetBranchName

string

Target BranchName.
uri

string

Build Uri.

CustomTestField

Object

A custom field information. Allowed Key : Value pairs - ( AttemptId: int value, IsTestResultFlaky: bool)

Name Type Description
fieldName

string

Field Name.
value

object

Field value.

DtlEnvironmentDetails

Object

This is a temporary class to provide the details for the test run environment.

Name Type Description
csmContent

string

csmParameters

string

subscriptionName

string

IdentityRef

Object
Name Type Description
_links

ReferenceLinks

This field contains zero or more interesting links about the graph subject. These links may be invoked to obtain additional relationships or more detailed information about this graph subject.
descriptor

string

The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
directoryAlias

string

Deprecated - Can be retrieved by querying the Graph user referenced in the "self" entry of the IdentityRef "_links" dictionary
displayName

string

This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
id

string

imageUrl

string

Deprecated - Available in the "avatar" entry of the IdentityRef "_links" dictionary
inactive

boolean

Deprecated - Can be retrieved by querying the Graph membership state referenced in the "membershipState" entry of the GraphUser "_links" dictionary
isAadIdentity

boolean

Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer

boolean

Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsGroupType)
isDeletedInOrigin

boolean

profileUrl

string

Deprecated - not in use in most preexisting implementations of ToIdentityRef
uniqueName

string

Deprecated - use Domain+PrincipalName instead
url

string

This url is the full route to the source resource of this graph subject.

JobReference

Object

Job in pipeline. This is related to matrixing in YAML.

Name Type Description
attempt

integer (int32)

Attempt number of the job
jobName

string

Matrixing in YAML generates copies of a job with different inputs in matrix. JobName is the name of those input. Maximum supported length for name is 256 character.

PhaseReference

Object

Phase in pipeline

Name Type Description
attempt

integer (int32)

Attempt number of the phase
phaseName

string

Name of the phase. Maximum supported length for name is 256 character.

PipelineReference

Object

Pipeline reference

Name Type Description
jobReference

JobReference

Reference of the job
phaseReference

PhaseReference

Reference of the phase.
pipelineId

integer (int32)

Reference of the pipeline with which this pipeline instance is related.
stageReference

StageReference

Reference of the stage.
Object

The class to represent a collection of REST reference links.

Name Type Description
links

object

The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

ReleaseReference

Object

Reference to a release.

Name Type Description
attempt

integer (int32)

Number of Release Attempt.
creationDate

string (date-time)

Release Creation Date(UTC).
definitionId

integer (int32)

Release definition ID.
environmentCreationDate

string (date-time)

Environment creation Date(UTC).
environmentDefinitionId

integer (int32)

Release environment definition ID.
environmentDefinitionName

string

Release environment definition name.
environmentId

integer (int32)

Release environment ID.
environmentName

string

Release environment name.
id

integer (int32)

Release ID.
name

string

Release name.

ResultMetadata

Enumeration

ResultMetadata for the given outcome/count.

Value Description
rerun

Rerun metadata
flaky

Flaky metadata

RunFilter

Object

This class is used to provide the filters used for discovery

Name Type Description
sourceFilter

string

filter for the test case sources (test containers)
testCaseFilter

string

filter for the test cases

RunStatistic

Object

Test run statistics per outcome.

Name Type Description
count

integer (int32)

Test result count fo the given outcome.
outcome

string

Test result outcome
resolutionState

TestResolutionState

Test run Resolution State.
resultMetadata

ResultMetadata

ResultMetadata for the given outcome/count.
state

string

State of the test run

RunSummaryModel

Object

Run summary for each output type of test.

Name Type Description
duration

integer (int64)

Total time taken in milliseconds.
resultCount

integer (int32)

Number of results for Outcome TestOutcome
testOutcome

TestOutcome

Summary is based on outcome

RunUpdateModel

Object
Name Type Description
build

ShallowReference

An abstracted reference to the build that it belongs.
buildDropLocation

string

Drop location of the build used for test run.
buildFlavor

string

Flavor of the build used for test run. (E.g: Release, Debug)
buildPlatform

string

Platform of the build used for test run. (E.g.: x86, amd64)
comment

string

Comments entered by those analyzing the run.
completedDate

string

Completed date time of the run.
controller

string

Name of the test controller used for automated run.
deleteInProgressResults

boolean

true to delete inProgess Results , false otherwise.
dtlAutEnvironment

ShallowReference

An abstracted reference to DtlAutEnvironment.
dtlEnvironment

ShallowReference

An abstracted reference to DtlEnvironment.
dtlEnvironmentDetails

DtlEnvironmentDetails

This is a temporary class to provide the details for the test run environment.
dueDate

string

Due date and time for test run.
errorMessage

string

Error message associated with the run.
iteration

string

The iteration in which to create the run.
logEntries

TestMessageLogDetails[]

Log entries associated with the run. Use a comma-separated list of multiple log entry objects. { logEntry }, { logEntry }, ...
name

string

Name of the test run.
releaseEnvironmentUri

string

URI of release environment associated with the run.
releaseUri

string

URI of release associated with the run.
runSummary

RunSummaryModel[]

Run summary for run Type = NoConfigRun.
sourceWorkflow

string

SourceWorkFlow(CI/CD) of the test run.
startedDate

string

Start date time of the run.
state

string

The state of the test run Below are the valid values - NotStarted, InProgress, Completed, Aborted, Waiting
substate

TestRunSubstate

The types of sub states for test run.
tags

TestTag[]

Tags to attach with the test run.
testEnvironmentId

string

ID of the test environment associated with the run.
testSettings

ShallowReference

An abstracted reference to test setting resource.

ShallowReference

Object

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.

Name Type Description
id

string

ID of the resource
name

string

Name of the linked resource (definition name, controller name, etc.)
url

string

Full http link to the resource

StageReference

Object

Stage in pipeline

Name Type Description
attempt

integer (int32)

Attempt number of stage
stageName

string

Name of the stage. Maximum supported length for name is 256 character.

TestEnvironment

Object

Test environment Detail.

Name Type Description
environmentId

string (uuid)

Test Environment Id.
environmentName

string

Test Environment Name.

TestMessageLogDetails

Object

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.

Name Type Description
dateCreated

string (date-time)

Date when the resource is created
entryId

integer (int32)

Id of the resource
message

string

Message of the resource

TestOutcome

Enumeration
Value Description
unspecified

Only used during an update to preserve the existing value.
none

Test has not been completed, or the test type does not report pass/failure.
passed

Test was executed w/o any issues.
failed

Test was executed, but there were issues. Issues may involve exceptions or failed assertions.
inconclusive

Test has completed, but we can't say if it passed or failed. May be used for aborted tests...
timeout

The test timed out
aborted

Test was aborted. This was not caused by a user gesture, but rather by a framework decision.
blocked

Test had it chance for been executed but was not, as ITestElement.IsRunnable == false.
notExecuted

Test was not executed. This was caused by a user gesture - e.g. user hit stop button.
warning

To be used by Run level results. This is not a failure.
error

There was a system error while we were trying to execute a test.
notApplicable

Test is Not Applicable for execution.
paused

Test is paused.
inProgress

Test is currently executing. Added this for TCM charts
notImpacted

Test is not impacted. Added fot TIA.

TestResolutionState

Object

Test Resolution State Details.

Name Type Description
id

integer (int32)

Test Resolution state Id.
name

string

Test Resolution State Name.
project

ShallowReference

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.

TestRun

Object

Test run details.

Name Type Description
build

ShallowReference

Build associated with this test run.
buildConfiguration

BuildConfiguration

Build configuration details associated with this test run.
comment

string

Comments entered by those analyzing the run.
completedDate

string (date-time)

Completed date time of the run.
controller

string

Test Run Controller.
createdDate

string (date-time)

Test Run CreatedDate.
customFields

CustomTestField[]

List of Custom Fields for TestRun.
dropLocation

string

Drop Location for the test Run.
dtlAutEnvironment

ShallowReference

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.
dtlEnvironment

ShallowReference

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.
dtlEnvironmentCreationDetails

DtlEnvironmentDetails

This is a temporary class to provide the details for the test run environment.
dueDate

string (date-time)

Due date and time for test run.
errorMessage

string

Error message associated with the run.
filter

RunFilter

This class is used to provide the filters used for discovery
id

integer (int32)

ID of the test run.
incompleteTests

integer (int32)

Number of Incomplete Tests.
isAutomated

boolean

true if test run is automated, false otherwise.
iteration

string

The iteration to which the run belongs.
lastUpdatedBy

IdentityRef

Team foundation ID of the last updated the test run.
lastUpdatedDate

string (date-time)

Last updated date and time
name

string

Name of the test run.
notApplicableTests

integer (int32)

Number of Not Applicable Tests.
owner

IdentityRef

Team Foundation ID of the owner of the runs.
passedTests

integer (int32)

Number of passed tests in the run
phase

string

Phase/State for the testRun.
pipelineReference

PipelineReference

Reference of the pipeline to which this test run belongs.
plan

ShallowReference

Test plan associated with this test run.
postProcessState

string

Post Process State.
project

ShallowReference

Project associated with this run.
release

ReleaseReference

Release Reference for the Test Run.
releaseEnvironmentUri

string

Release Environment Uri for TestRun.
releaseUri

string

Release Uri for TestRun.
revision

integer (int32)

runStatistics

RunStatistic[]

RunSummary by outcome.
startedDate

string (date-time)

Start date time of the run.
state

string

The state of the run. Type TestRunState Valid states - Unspecified ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate

TestRunSubstate

TestRun Substate.
tags

TestTag[]

Tags attached with this test run.
testEnvironment

TestEnvironment

Test environment associated with the run.
testMessageLogId

integer (int32)

testSettings

ShallowReference

An abstracted reference to some other resource. This class is used to provide the build data contracts with a uniform way to reference other resources in a way that provides easy traversal through links.
totalTests

integer (int32)

Total tests in the run
unanalyzedTests

integer (int32)

Number of failed tests in the run.
url

string

Url of the test run
webAccessUrl

string

Web Access Url for TestRun.

TestRunSubstate

Enumeration

The types of sub states for test run.

Value Description
none

Run with noState.
creatingEnvironment

Run state while Creating Environment.
runningTests

Run state while Running Tests.
canceledByUser

Run state while Creating Environment.
abortedBySystem

Run state when it is Aborted By the System.
timedOut

Run state when run has timedOut.
pendingAnalysis

Run state while Pending Analysis.
analyzed

Run state after being Analysed.
cancellationInProgress

Run state when cancellation is in Progress.

TestTag

Object

Tag attached to a run or result.

Name Type Description
name

string

Name of the tag, alphanumeric value less than 30 chars