다음을 통해 공유


Runs - Query

필터를 기반으로 하는 쿼리 테스트 실행 필수 필드는 minLastUpdatedDate 및 maxLastUpdatedDate입니다.

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&api-version=7.1-preview.3
GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&state={state}&planIds={planIds}&isAutomated={isAutomated}&publishContext={publishContext}&buildIds={buildIds}&buildDefIds={buildDefIds}&branchName={branchName}&releaseIds={releaseIds}&releaseDefIds={releaseDefIds}&releaseEnvIds={releaseEnvIds}&releaseEnvDefIds={releaseEnvDefIds}&runTitle={runTitle}&$top={$top}&continuationToken={continuationToken}&api-version=7.1-preview.3

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
organization
path True

string

Azure DevOps 조직의 이름입니다.

project
path True

string

프로젝트 ID 또는 프로젝트 이름

api-version
query True

string

사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.3'으로 설정해야 합니다.

maxLastUpdatedDate
query True

string

date-time

쿼리할 최대 마지막으로 수정된 실행 날짜(필수, 최소 날짜와 최대 날짜 간의 차이는 최대 7일일 수 있음).

minLastUpdatedDate
query True

string

date-time

쿼리할 최소 마지막으로 수정한 실행 날짜(필수)입니다.

$top
query

integer

int32

쿼리할 실행 수입니다. 제한은 100입니다.

branchName
query

string

쿼리할 실행의 원본 분기 이름입니다.

buildDefIds
query

string

array (int32)

쿼리할 실행의 빌드 정의 ID, 유효한 ID의 쉼표로 구분된 목록(ids 10 제한 없음).

buildIds
query

string

array (int32)

쿼리할 실행의 빌드 ID, 유효한 ID의 쉼표로 구분된 목록(ids 10 제한 없음).

continuationToken
query

string

continuationToken이 이전 일괄 처리에서 수신되었거나 첫 번째 일괄 처리에 대해 null입니다. 사용자가 생성(또는 마지막 일괄 처리에서 받은 경우 변경)하지 않아야 합니다.

isAutomated
query

boolean

쿼리할 실행의 자동화 유형입니다.

planIds
query

string

array (int32)

쿼리할 실행의 계획 ID, 유효한 ID의 쉼표로 구분된 목록(ids 10 제한 없음).

publishContext
query

TestRunPublishContext

쿼리할 실행의 PublishContext입니다.

releaseDefIds
query

string

array (int32)

쿼리할 실행의 정의 ID를 해제하고, 유효한 ID의 쉼표로 구분된 목록(ids 10 제한 없음)을 해제합니다.

releaseEnvDefIds
query

string

array (int32)

쿼리할 실행의 릴리스 환경 정의 ID, 유효한 ID의 쉼표로 구분된 목록(ids 10 제한 없음).

releaseEnvIds
query

string

array (int32)

쿼리할 실행의 환경 ID를 해제하고, 유효한 ID의 쉼표로 구분된 목록(ids 10 제한 없음)을 해제합니다.

releaseIds
query

string

array (int32)

쿼리할 실행의 ID를 해제하고, 유효한 ID의 쉼표로 구분된 목록(ids 10 제한 없음)을 해제합니다.

runTitle
query

string

쿼리할 실행 제목을 실행합니다.

state
query

TestRunState

쿼리할 실행의 현재 상태입니다.

응답

Name 형식 Description
200 OK

TestRun[]

성공한 작업

보안

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 테스트 계획, 사례, 결과 및 기타 테스트 관리 관련 아티팩트 읽기 기능을 부여합니다.

정의

Name Description
BuildConfiguration

BuildConfiguration 세부 정보입니다.

CustomTestField

사용자 지정 필드 정보입니다. 허용되는 키: 값 쌍 - ( AttemptId: int value, IsTestResultFlaky: bool)

DtlEnvironmentDetails

테스트 실행 환경에 대한 세부 정보를 제공하는 임시 클래스입니다.

IdentityRef
JobReference

파이프라인의 작업입니다. 이는 YAML의 행렬과 관련이 있습니다.

PhaseReference

파이프라인의 단계

PipelineReference

파이프라인 참조

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

ReleaseReference

릴리스에 대한 참조입니다.

ResultMetadata

지정된 결과/수에 대한 ResultMetadata입니다.

RunFilter

이 클래스는 검색에 사용되는 필터를 제공하는 데 사용됩니다.

RunStatistic

결과당 실행 통계를 테스트합니다.

ShallowReference

다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.

StageReference

파이프라인의 단계

TestEnvironment

테스트 환경 세부 정보.

TestResolutionState

테스트 확인 상태 세부 정보입니다.

TestRun

테스트 실행 세부 정보입니다.

TestRunPublishContext

쿼리할 실행의 PublishContext입니다.

TestRunState
TestRunSubstate

테스트 실행에 대한 하위 상태의 형식입니다.

TestTag

실행 또는 결과에 연결된 태그입니다.

BuildConfiguration

BuildConfiguration 세부 정보입니다.

Name 형식 Description
branchName

string

빌드가 생성되는 분기 이름입니다.

buildDefinitionId

integer

빌드용 BuildDefinitionId입니다.

buildSystem

string

빌드 시스템.

creationDate

string

빌드 만들기 날짜입니다.

flavor

string

빌드 버전(예: 빌드/릴리스).

id

integer

BuildConfiguration ID입니다.

number

string

빌드 번호입니다.

platform

string

BuildConfiguration Platform.

project

ShallowReference

이 BuildConfiguration과 연결된 프로젝트입니다.

repositoryGuid

string

빌드에 대한 리포지토리 Guid입니다.

repositoryType

string

리포지토리 유형(예: TFSGit).

sourceVersion

string

빌드에 대한 원본 버전(/첫 번째 커밋)이 트리거되었습니다.

targetBranchName

string

대상 BranchName.

uri

string

빌드 Uri.

CustomTestField

사용자 지정 필드 정보입니다. 허용되는 키: 값 쌍 - ( AttemptId: int value, IsTestResultFlaky: bool)

Name 형식 Description
fieldName

string

필드 이름입니다.

value

object

필드 값입니다.

DtlEnvironmentDetails

테스트 실행 환경에 대한 세부 정보를 제공하는 임시 클래스입니다.

Name 형식 Description
csmContent

string

csmParameters

string

subscriptionName

string

IdentityRef

Name 형식 Description
_links

ReferenceLinks

이 필드에는 그래프 제목에 대한 0개 이상의 흥미로운 링크가 포함되어 있습니다. 이러한 링크를 호출하여 이 그래프 제목에 대한 추가 관계 또는 자세한 정보를 얻을 수 있습니다.

descriptor

string

설명자는 시스템이 실행되는 동안 그래프 제목을 참조하는 기본 방법입니다. 이 필드는 계정과 조직 모두에서 동일한 그래프 제목을 고유하게 식별합니다.

directoryAlias

string

사용되지 않음 - IdentityRef "_links" 사전의 "자체" 항목에서 참조된 Graph 사용자를 쿼리하여 검색할 수 있습니다.

displayName

string

그래프 주체의 고유하지 않은 표시 이름입니다. 이 필드를 변경하려면 원본 공급자에서 해당 값을 변경해야 합니다.

id

string

imageUrl

string

사용되지 않음 - IdentityRef "_links" 사전의 "아바타" 항목에서 사용할 수 있습니다.

inactive

boolean

사용되지 않음 - GraphUser "_links" 사전의 "membershipState" 항목에서 참조되는 Graph 멤버 자격 상태를 쿼리하여 검색할 수 있습니다.

isAadIdentity

boolean

사용되지 않음 - 설명자의 주체 형식(Descriptor.IsAadUserType/Descriptor.IsAadGroupType)에서 유추할 수 있습니다.

isContainer

boolean

사용되지 않음 - 설명자의 주체 형식에서 유추할 수 있음(Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

사용되지 않음 - ToIdentityRef의 대부분의 기존 구현에서 사용되지 않음

uniqueName

string

사용되지 않음 - 대신 Domain+PrincipalName 사용

url

string

이 URL은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다.

JobReference

파이프라인의 작업입니다. 이는 YAML의 행렬과 관련이 있습니다.

Name 형식 Description
attempt

integer

작업 시도 횟수

jobName

string

YAML의 행렬화는 행렬에서 다른 입력을 사용하여 작업의 복사본을 생성합니다. JobName은 해당 입력의 이름입니다. 이름에 지원되는 최대 길이는 256자입니다.

PhaseReference

파이프라인의 단계

Name 형식 Description
attempt

integer

단계의 시도 횟수

phaseName

string

단계의 이름입니다. 이름에 지원되는 최대 길이는 256자입니다.

PipelineReference

파이프라인 참조

Name 형식 Description
jobReference

JobReference

작업의 참조

phaseReference

PhaseReference

단계의 참조입니다.

pipelineId

integer

이 파이프라인 instance 관련된 파이프라인의 참조입니다.

stageReference

StageReference

스테이지의 참조입니다.

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name 형식 Description
links

object

링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

ReleaseReference

릴리스에 대한 참조입니다.

Name 형식 Description
attempt

integer

릴리스 시도 횟수입니다.

creationDate

string

릴리스 생성 날짜(UTC).

definitionId

integer

릴리스 정의 ID입니다.

environmentCreationDate

string

환경 만들기 날짜(UTC).

environmentDefinitionId

integer

릴리스 환경 정의 ID입니다.

environmentDefinitionName

string

릴리스 환경 정의 이름입니다.

environmentId

integer

릴리스 환경 ID입니다.

environmentName

string

릴리스 환경 이름입니다.

id

integer

릴리스 ID입니다.

name

string

릴리스 이름입니다.

ResultMetadata

지정된 결과/수에 대한 ResultMetadata입니다.

Name 형식 Description
flaky

string

벗겨진 메타데이터

rerun

string

메타데이터 다시 실행

RunFilter

이 클래스는 검색에 사용되는 필터를 제공하는 데 사용됩니다.

Name 형식 Description
sourceFilter

string

테스트 사례 원본에 대한 필터(테스트 컨테이너)

testCaseFilter

string

테스트 사례에 대한 필터

RunStatistic

결과당 실행 통계를 테스트합니다.

Name 형식 Description
count

integer

지정된 결과에 대한 테스트 결과 수입니다.

outcome

string

테스트 결과 결과

resolutionState

TestResolutionState

실행 확인 상태를 테스트합니다.

resultMetadata

ResultMetadata

지정된 결과/수에 대한 ResultMetadata입니다.

state

string

테스트 실행 상태

ShallowReference

다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.

Name 형식 Description
id

string

리소스의 ID

name

string

연결된 리소스의 이름(정의 이름, 컨트롤러 이름 등)

url

string

리소스에 대한 전체 http 링크

StageReference

파이프라인의 단계

Name 형식 Description
attempt

integer

스테이지 시도 횟수

stageName

string

스테이지의 이름입니다. 이름에 지원되는 최대 길이는 256자입니다.

TestEnvironment

테스트 환경 세부 정보.

Name 형식 Description
environmentId

string

테스트 환경 ID입니다.

environmentName

string

테스트 환경 이름입니다.

TestResolutionState

테스트 확인 상태 세부 정보입니다.

Name 형식 Description
id

integer

테스트 확인 상태 ID입니다.

name

string

테스트 확인 상태 이름입니다.

project

ShallowReference

다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.

TestRun

테스트 실행 세부 정보입니다.

Name 형식 Description
build

ShallowReference

이 테스트 실행과 연결된 빌드입니다.

buildConfiguration

BuildConfiguration

이 테스트 실행과 연결된 빌드 구성 세부 정보입니다.

comment

string

실행을 분석하는 사람들이 입력한 주석입니다.

completedDate

string

실행의 완료 날짜 시간입니다.

controller

string

테스트 실행 컨트롤러.

createdDate

string

CreatedDate를 테스트 실행합니다.

customFields

CustomTestField[]

TestRun에 대한 사용자 지정 필드 목록입니다.

dropLocation

string

테스트 실행에 대한 위치를 삭제합니다.

dtlAutEnvironment

ShallowReference

다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.

dtlEnvironment

ShallowReference

다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.

dtlEnvironmentCreationDetails

DtlEnvironmentDetails

테스트 실행 환경에 대한 세부 정보를 제공하는 임시 클래스입니다.

dueDate

string

테스트 실행 기한 및 시간입니다.

errorMessage

string

실행과 관련된 오류 메시지입니다.

filter

RunFilter

이 클래스는 검색에 사용되는 필터를 제공하는 데 사용됩니다.

id

integer

테스트 실행의 ID입니다.

incompleteTests

integer

불완전한 테스트 수입니다.

isAutomated

boolean

테스트 실행이 자동화되면 true이고, 그렇지 않으면 false입니다.

iteration

string

실행이 속한 반복입니다.

lastUpdatedBy

IdentityRef

마지막으로 업데이트된 테스트 실행의 팀 기초 ID입니다.

lastUpdatedDate

string

마지막 업데이트 날짜 및 시간

name

string

테스트 실행의 이름입니다.

notApplicableTests

integer

적용할 수 없는 테스트 수입니다.

owner

IdentityRef

실행 소유자의 Team Foundation ID입니다.

passedTests

integer

실행에서 통과된 테스트 수

phase

string

testRun에 대한 단계/상태입니다.

pipelineReference

PipelineReference

이 테스트 실행이 속한 파이프라인의 참조입니다.

plan

ShallowReference

이 테스트 실행과 관련된 테스트 계획입니다.

postProcessState

string

사후 프로세스 상태입니다.

project

ShallowReference

이 실행과 연결된 프로젝트입니다.

release

ReleaseReference

테스트 실행에 대한 릴리스 참조입니다.

releaseEnvironmentUri

string

TestRun에 대한 릴리스 환경 Uri입니다.

releaseUri

string

TestRun에 대한 릴리스 Uri입니다.

revision

integer

runStatistics

RunStatistic[]

결과별 RunSummary입니다.

startedDate

string

실행의 시작 날짜 시간입니다.

state

string

실행의 상태입니다. TestRunState 유효한 상태 유형 - 지정되지 않은 ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation

substate

TestRunSubstate

TestRun 하위 상태.

tags

TestTag[]

이 테스트 실행과 함께 연결된 태그입니다.

testEnvironment

TestEnvironment

실행과 연결된 테스트 환경입니다.

testMessageLogId

integer

testSettings

ShallowReference

다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.

totalTests

integer

실행의 총 테스트

unanalyzedTests

integer

실행에서 실패한 테스트의 수입니다.

url

string

테스트 실행의 URL

webAccessUrl

string

TestRun에 대한 웹 액세스 URL입니다.

TestRunPublishContext

쿼리할 실행의 PublishContext입니다.

Name 형식 Description
all

string

실행은 모든 컨텍스트에 대해 게시됩니다.

build

string

빌드 컨텍스트에 대해 실행이 게시됩니다.

release

string

실행은 릴리스 컨텍스트에 대해 게시됩니다.

TestRunState

Name 형식 Description
aborted

string

실행이 중지되고 나머지 테스트가 중단되었습니다.

completed

string

모든 테스트가 완료되었거나 건너뜁니다.

inProgress

string

테스트가 실행 중입니다.

needsInvestigation

string

테스트 지점 오류로 인해 조사가 필요 실행이 필요 이 상태는 레거시 상태이며 더 이상 사용하지 않아야 합니다.

notStarted

string

실행이 아직 만들어지고 있습니다. 아직 테스트가 시작되지 않았습니다.

unspecified

string

기존 값을 유지하기 위해 업데이트하는 동안에만 사용됩니다.

waiting

string

실행은 현재 초기화 중이며 레거시 상태이므로 더 이상 사용하지 않아야 합니다.

TestRunSubstate

테스트 실행에 대한 하위 상태의 형식입니다.

Name 형식 Description
abortedBySystem

string

시스템에서 중단된 경우 상태를 실행합니다.

analyzed

string

분석된 후 상태를 실행합니다.

canceledByUser

string

환경을 만드는 동안 상태를 실행합니다.

cancellationInProgress

string

취소가 진행 중일 때 실행 상태입니다.

creatingEnvironment

string

환경을 만드는 동안 상태를 실행합니다.

none

string

noState로 실행합니다.

pendingAnalysis

string

보류 중인 분석 중 상태를 실행합니다.

runningTests

string

테스트를 실행하는 동안 상태를 실행합니다.

timedOut

string

run에 timedOut이 있는 경우 실행 상태입니다.

TestTag

실행 또는 결과에 연결된 태그입니다.

Name 형식 Description
name

string

태그의 이름, 30자 미만의 영숫자 값