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	ステージの参照。

ReferenceLinks

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 文字未満の英数字