次の方法で共有


Runs - Get Test Run By Id

その ID でテストの実行を取得します。

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

URI パラメーター

名前 / 必須 説明
organization
path True

string

Azure DevOps 組織の名前。

project
path True

string

プロジェクト ID またはプロジェクト名

runId
path True

integer (int32)

取得する実行の ID。

api-version
query True

string

使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。

includeDetails
query

boolean

既定値は true です。 実行統計、リリース、ビルド、テスト環境、プロセス後の状態などの詳細が含まれます。

応答

名前 説明
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 テスト計画、ケース、結果、その他のテスト管理関連の成果物を読み取る機能を付与します。

要求のサンプル

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

応答のサンプル

{
  "id": 1,
  "name": "sprint1 (Manual)",
  "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",
  "totalTests": 1,
  "passedTests": 1,
  "createdDate": "2014-05-04T12:50:31.38Z",
  "lastUpdatedDate": "2014-05-04T12:50:31.953Z",
  "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": 3
}

定義

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

テスト実行の詳細。

TestRunSubstate

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

TestTag

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

BuildConfiguration

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

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

名前 説明
fieldName

string

フィールド名。

value

object

フィールド値。

DtlEnvironmentDetails

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

名前 説明
csmContent

string

csmParameters

string

subscriptionName

string

IdentityRef

名前 説明
_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 でのマトリックス化に関連しています。

名前 説明
attempt

integer (int32)

ジョブの試行回数

jobName

string

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

PhaseReference

パイプラインのフェーズ

名前 説明
attempt

integer (int32)

フェーズの試行回数

phaseName

string

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

PipelineReference

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

名前 説明
jobReference

JobReference

ジョブの参照

phaseReference

PhaseReference

フェーズの参照。

pipelineId

integer (int32)

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

stageReference

StageReference

ステージの参照。

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

名前 説明
links

object

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

ReleaseReference

リリースへの参照。

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

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

名前 説明
sourceFilter

string

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

testCaseFilter

string

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

RunStatistic

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

名前 説明
count

integer (int32)

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

outcome

string

結果のテスト結果

resolutionState

TestResolutionState

テスト実行の解決状態。

resultMetadata

ResultMetadata

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

state

string

テスト実行の状態

ShallowReference

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

名前 説明
id

string

リソースの ID

name

string

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

url

string

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

StageReference

パイプラインのステージ

名前 説明
attempt

integer (int32)

ステージの試行回数

stageName

string

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

TestEnvironment

テスト環境の詳細。

名前 説明
environmentId

string (uuid)

テスト環境 ID。

environmentName

string

テスト環境名。

TestResolutionState

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

名前 説明
id

integer (int32)

テスト解決状態 ID。

name

string

テスト解決状態名。

project

ShallowReference

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

TestRun

テスト実行の詳細。

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

TestRunSubstate

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

説明
abortedBySystem

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

analyzed

解析後の実行状態。

canceledByUser

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

cancellationInProgress

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

creatingEnvironment

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

none

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

pendingAnalysis

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

runningTests

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

timedOut

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

TestTag

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

名前 説明
name

string

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