次の方法で共有

Runs - Query

  • リファレンス
サービス:
Test
API バージョン:
7.1

フィルターに基づくクエリ テストの実行。 必須フィールドは、minLastUpdatedDate と maxLastUpdatedDate です。

GET https://dev.azure.com/{organization}/{project}/_apis/test/runs?minLastUpdatedDate={minLastUpdatedDate}&maxLastUpdatedDate={maxLastUpdatedDate}&api-version=7.1
省略可能なパラメーターを含む: 
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

URI パラメーター

名前 / 必須 型 説明
organization
 path True

string

Azure DevOps 組織の名前。
project
 path True

string

プロジェクト ID またはプロジェクト名
api-version
 query True

string

使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。
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 のコンマ区切りの一覧 (id の制限番号 10)。
buildIds
 query

string (array (int32))

クエリを実行する実行のビルド ID、有効な ID のコンマ区切りの一覧 (id の制限番号 10)。
continuationToken
 query

string

continuationToken は前のバッチから受信しました。最初のバッチの場合は null です。 ユーザーが作成 (または最後のバッチから受信した場合は変更) しないでください。
isAutomated
 query

boolean

クエリを実行する実行のオートメーションの種類。
planIds
 query

string (array (int32))

クエリを実行する実行のプラン ID、有効な ID のコンマ区切りの一覧 (id の制限番号 10)。
publishContext
 query

TestRunPublishContext

クエリを実行する実行の PublishContext。
releaseDefIds
 query

string (array (int32))

クエリを実行する実行のリリース定義 ID、有効な ID のコンマ区切りの一覧 (id の制限番号 10)。
releaseEnvDefIds
 query

string (array (int32))

クエリを実行する実行のリリース環境定義 ID、有効な ID のコンマ区切りの一覧 (id の制限番号 10)。
releaseEnvIds
 query

string (array (int32))

クエリを実行する実行のリリース環境 ID、有効な ID のコンマ区切りの一覧 (ID 10 の制限番号)。
releaseIds
 query

string (array (int32))

クエリを実行する実行のリリース ID、有効な ID のコンマ区切りの一覧 (id の制限番号 10)。
runTitle
 query

string

クエリを実行する実行のタイトル。
state
 query

TestRunState

クエリを実行する実行の現在の状態。

応答

名前 型 説明
200 OK

TestRun[]

成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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

スコープ

名前 説明
vso.test テスト計画、ケース、結果、その他のテスト管理関連の成果物を読み取る機能を付与します。

定義

名前 説明
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

Object

BuildConfiguration の詳細。

名前 型 説明
branchName

string

ビルドが生成されるブランチ名。
buildDefinitionId

integer (int32)

ビルド用の BuildDefinitionId。
buildSystem

string

ビルド システム。
creationDate

string (date-time)

ビルドの作成日。
flavor

string

ビルド フレーバー (ビルド/リリースなど)。
id

integer (int32)

BuildConfiguration ID。
number

string

ビルド番号。
platform

string

BuildConfiguration Platform。
project

ShallowReference

この BuildConfiguration に関連付けられているプロジェクト。
repositoryGuid

string

ビルドのリポジトリ GUID。
repositoryType

string

リポジトリの種類 (例:TFSGit)。
sourceVersion

string

ビルドのソース バージョン (/最初のコミット) がトリガーされました。
targetBranchName

string

Target BranchName。
uri

string

ビルド URI。

CustomTestField

Object

ユーザー設定フィールド情報。 許可されるキー: 値のペア - ( AttemptId: int value, IsTestResultFlaky: bool)

名前 型 説明
fieldName

string

フィールド名。
value

object

フィールド値。

DtlEnvironmentDetails

Object

これは、テスト実行環境の詳細を提供する一時的なクラスです。

名前 型 説明
csmContent

string

csmParameters

string

subscriptionName

string

IdentityRef

Object
名前 型 説明
_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

Object

パイプライン内のジョブ。 これは、YAML でのマトリックス化に関連しています。

名前 型 説明
attempt

integer (int32)

ジョブの試行回数
jobName

string

YAML で行列を作成すると、マトリックス内の入力が異なるジョブのコピーが生成されます。 JobName は、これらの入力の名前です。 名前でサポートされる最大長は 256 文字です。

PhaseReference

Object

パイプラインのフェーズ

名前 型 説明
attempt

integer (int32)

フェーズの試行回数
phaseName

string

フェーズの名前。 名前でサポートされる最大長は 256 文字です。

PipelineReference

Object

パイプライン リファレンス

名前 型 説明
jobReference

JobReference

ジョブの参照
phaseReference

PhaseReference

フェーズの参照。
pipelineId

integer (int32)

このパイプライン インスタンスが関連付けられているパイプラインの参照。
stageReference

StageReference

ステージの参照。
Object

REST 参照リンクのコレクションを表すクラス。

名前 型 説明
links

object

リンクの読み取りビュー。 参照リンクは読み取り専用であるため、読み取り専用として公開する必要があります。

ReleaseReference

Object

リリースへの参照。

名前 型 説明
attempt

integer (int32)

リリース試行回数。
creationDate

string (date-time)

リリースの作成日 (UTC)。
definitionId

integer (int32)

リリース定義 ID。
environmentCreationDate

string (date-time)

環境の作成日 (UTC)。
environmentDefinitionId

integer (int32)

リリース環境定義 ID。
environmentDefinitionName

string

リリース環境定義名。
environmentId

integer (int32)

リリース環境 ID。
environmentName

string

リリース環境名。
id

integer (int32)

リリース ID。
name

string

リリース名。

ResultMetadata

列挙

指定された結果/カウントの ResultMetadata。

値 説明
flaky

不安定なメタデータ
rerun

メタデータの再実行

RunFilter

Object

このクラスは、検出に使用されるフィルターを提供するために使用されます

名前 型 説明
sourceFilter

string

テスト ケース ソースのフィルター (テスト コンテナー)
testCaseFilter

string

テスト ケースのフィルター

RunStatistic

Object

結果ごとのテスト実行統計。

名前 型 説明
count

integer (int32)

指定された結果の結果カウントをテストします。
outcome

string

結果のテスト結果
resolutionState

TestResolutionState

テスト実行の解決状態。
resultMetadata

ResultMetadata

指定された結果/カウントの ResultMetadata。
state

string

テスト実行の状態

ShallowReference

Object

他のリソースへの抽象化された参照。 このクラスは、リンクを介して簡単にトラバーサルを提供する方法で他のリソースを参照する統一された方法でビルド データ コントラクトを提供するために使用されます。

名前 型 説明
id

string

リソースの ID
name

string

リンクされたリソースの名前 (定義名、コントローラー名など)
url

string

リソースへの完全な http リンク

StageReference

Object

パイプラインのステージ

名前 型 説明
attempt

integer (int32)

ステージの試行回数
stageName

string

ステージの名前。 名前でサポートされる最大長は 256 文字です。

TestEnvironment

Object

テスト環境の詳細。

名前 型 説明
environmentId

string (uuid)

テスト環境 ID。
environmentName

string

テスト環境名。

TestResolutionState

Object

解決状態の詳細をテストします。

名前 型 説明
id

integer (int32)

テスト解決状態 ID。
name

string

テスト解決状態名。
project

ShallowReference

他のリソースへの抽象化された参照。 このクラスは、リンクを介して簡単にトラバーサルを提供する方法で他のリソースを参照する統一された方法でビルド データ コントラクトを提供するために使用されます。

TestRun

Object

テスト実行の詳細。

名前 型 説明
build

ShallowReference

このテスト実行に関連付けられているビルド。
buildConfiguration

BuildConfiguration

このテスト実行に関連付けられているビルド構成の詳細。
comment

string

実行を分析するユーザーによって入力されたコメント。
completedDate

string (date-time)

実行の完了日時。
controller

string

テスト実行コントローラー。
createdDate

string (date-time)

テスト実行 CreatedDate。
customFields

CustomTestField[]

TestRun のユーザー設定フィールドの一覧。
dropLocation

string

テスト実行のドロップ場所。
dtlAutEnvironment

ShallowReference

他のリソースへの抽象化された参照。 このクラスは、リンクを介して簡単にトラバーサルを提供する方法で他のリソースを参照する統一された方法でビルド データ コントラクトを提供するために使用されます。
dtlEnvironment

ShallowReference

他のリソースへの抽象化された参照。 このクラスは、リンクを介して簡単にトラバーサルを提供する方法で他のリソースを参照する統一された方法でビルド データ コントラクトを提供するために使用されます。
dtlEnvironmentCreationDetails

DtlEnvironmentDetails

これは、テスト実行環境の詳細を提供する一時的なクラスです。
dueDate

string (date-time)

テストの実行期限の日付と時刻。
errorMessage

string

実行に関連付けられているエラー メッセージ。
filter

RunFilter

このクラスは、検出に使用されるフィルターを提供するために使用されます
id

integer (int32)

テスト実行の ID。
incompleteTests

integer (int32)

不完全なテストの数。
isAutomated

boolean

テストの実行が自動化されている場合は true、それ以外の場合は false。
iteration

string

実行が属するイテレーション。
lastUpdatedBy

IdentityRef

最後に更新されたテスト実行のチーム基盤 ID。
lastUpdatedDate

string (date-time)

最終更新日時
name

string

テスト実行の名前。
notApplicableTests

integer (int32)

該当しないテストの数。
owner

IdentityRef

実行の所有者の Team Foundation ID。
passedTests

integer (int32)

実行で成功したテストの数
phase

string

testRun のフェーズ/状態。
pipelineReference

PipelineReference

このテスト実行が属するパイプラインの参照。
plan

ShallowReference

このテスト実行に関連付けられているテスト 計画。
postProcessState

string

プロセス後の状態。
project

ShallowReference

この実行に関連付けられているプロジェクト。
release

ReleaseReference

テスト実行のリリース リファレンス。
releaseEnvironmentUri

string

TestRun のリリース環境 URI。
releaseUri

string

TestRun のリリース URI。
revision

integer (int32)

runStatistics

RunStatistic[]

結果による RunSummary。
startedDate

string (date-time)

実行の開始日時。
state

string

実行の状態。 Type TestRunState Valid states - Unspecified ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate

TestRunSubstate

TestRun サブステート。
tags

TestTag[]

このテスト実行に添付されたタグ。
testEnvironment

TestEnvironment

実行に関連付けられているテスト環境。
testMessageLogId

integer (int32)

testSettings

ShallowReference

他のリソースへの抽象化された参照。 このクラスは、リンクを介して簡単にトラバーサルを提供する方法で他のリソースを参照する統一された方法でビルド データ コントラクトを提供するために使用されます。
totalTests

integer (int32)

実行中のテストの合計数
unanalyzedTests

integer (int32)

実行中に失敗したテストの数。
url

string

テスト実行の URL
webAccessUrl

string

TestRun の Web アクセス URL。

TestRunPublishContext

列挙

クエリを実行する実行の PublishContext。

値 説明
all

任意のコンテキストに対して実行が発行されます。
build

実行はビルド コンテキストに対して発行されます。
release

実行はリリース コンテキストに対して発行されます。

TestRunState

列挙
値 説明
aborted

実行が停止され、残りのテストが中止されました
completed

すべてのテストが完了したか、スキップされました。
inProgress

テストが実行されています。
needsInvestigation

テスト ポイントのエラーが原因で実行には調査が必要です。これは従来の状態であり、これ以上使用しないでください
notStarted

実行はまだ作成中です。 テストはまだ開始されていません。
unspecified

既存の値を保持するために更新中にのみ使用されます。
waiting

実行は現在初期化中です。これは従来の状態であり、これ以上使用しないでください

TestRunSubstate

列挙

テスト実行のサブ状態の種類。

値 説明
abortedBySystem

システムによって中止された場合の実行状態。
analyzed

解析後の実行状態。
canceledByUser

環境の作成中に状態を実行します。
cancellationInProgress

取り消しが進行中の場合の実行状態。
creatingEnvironment

環境の作成中に状態を実行します。
none

noState を使用して実行します。
pendingAnalysis

保留中の分析中に状態を実行します。
runningTests

テストの実行中に状態を実行します。
timedOut

実行に timedOut がある場合の実行状態。

TestTag

Object

実行または結果にアタッチされたタグ。

名前 型 説明
name

string

タグの名前、30 文字未満の英数字