Runs - Query

Layanan:

Test

Versi API:

7.1

Uji Kueri Berjalan berdasarkan filter. Bidang wajib adalah minLastUpdatedDate dan maxLastUpdatedDate.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
project	path	True	string	ID proyek atau nama proyek
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1' untuk menggunakan versi api ini.
maxLastUpdatedDate	query	True	string (date-time)	Tanggal Modifikasi Terakhir Maksimum eksekusi yang akan dikueri (Wajib, perbedaan antara tanggal min dan maks bisa paling lama 7 hari).
minLastUpdatedDate	query	True	string (date-time)	Tanggal Modifikasi Terakhir Minimum eksekusi yang akan dikueri (Wajib).
$top	query		integer (int32)	Jumlah eksekusi yang akan dikueri. Batasnya adalah 100
branchName	query		string	Nama Cabang Sumber dari Eksekusi yang akan dikueri.
buildDefIds	query		string (array (int32))	Bangun Id Definisi dari Eksekusi yang akan dikueri, daftar id yang dipisahkan koma yang valid (batas no. id 10).
buildIds	query		string (array (int32))	Id Build dari Eksekusi yang akan dikueri, daftar id yang dipisahkan koma yang valid (batas no. id 10).
continuationToken	query		string	continuationToken diterima dari batch sebelumnya atau null untuk batch pertama. Seharusnya tidak dibuat (atau diubah, jika diterima dari batch terakhir) oleh pengguna.
isAutomated	query		boolean	Jenis automasi Eksekusi yang akan dikueri.
planIds	query		string (array (int32))	Id paket Eksekusi yang akan dikueri, daftar id yang dipisahkan koma yang valid (batas no. id 10).
publishContext	query		TestRunPublishContext	PublishContext dari Eksekusi yang akan dikueri.
releaseDefIds	query		string (array (int32))	Id Definisi Rilis dari Eksekusi yang akan dikueri, daftar id yang dipisahkan koma yang valid (batas no. id 10).
releaseEnvDefIds	query		string (array (int32))	Id Definisi Lingkungan Rilis dari Eksekusi yang akan dikueri, daftar id yang dipisahkan koma yang valid (batas no. id 10).
releaseEnvIds	query		string (array (int32))	Id Lingkungan Rilis dari Eksekusi yang akan dikueri, daftar id yang dipisahkan koma yang valid (batas no. id 10).
releaseIds	query		string (array (int32))	Id Rilis Eksekusi yang akan dikueri, daftar id yang dipisahkan koma yang valid (batas no. id 10).
runTitle	query		string	Jalankan Judul Eksekusi yang akan dikueri.
state	query		TestRunState	Status Eksekusi saat ini yang akan dikueri.

Respons

Nama	Jenis	Deskripsi
200 OK	TestRun[]	operasi berhasil

Keamanan

oauth2

Jenis: oauth2
Alur: accessCode
URL Otorisasi: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Cakupan

Nama	Deskripsi
vso.test	Memberikan kemampuan untuk membaca rencana pengujian, kasus, hasil, dan artefak terkait manajemen pengujian lainnya.

Definisi

Nama	Deskripsi
BuildConfiguration	Detail BuildConfiguration.
CustomTestField	Informasi bidang kustom. Kunci yang Diizinkan : Pasangan nilai - ( AttemptId: nilai int, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Ini adalah kelas sementara untuk memberikan detail untuk lingkungan uji coba.
IdentityRef
JobReference	Pekerjaan dalam alur. Ini terkait dengan matriks dalam YAML.
PhaseReference	Fase dalam alur
PipelineReference	Referensi alur
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.
ReleaseReference	Referensi ke rilis.
ResultMetadata	ResultMetadata untuk hasil/hitungan yang diberikan.
RunFilter	Kelas ini digunakan untuk menyediakan filter yang digunakan untuk penemuan
RunStatistic	Menguji statistik eksekusi per hasil.
ShallowReference	Referensi abstrak ke beberapa sumber daya lain. Kelas ini digunakan untuk menyediakan kontrak data build dengan cara yang seragam untuk mereferensikan sumber daya lain dengan cara yang menyediakan traversal yang mudah melalui tautan.
StageReference	Tahapan dalam alur
TestEnvironment	Detail lingkungan pengujian.
TestResolutionState	Detail Status Resolusi Pengujian.
TestRun	Detail uji coba.
TestRunPublishContext	PublishContext dari Eksekusi yang akan dikueri.
TestRunState
TestRunSubstate	Jenis sub-status untuk uji coba.
TestTag	Tag yang dilampirkan ke eksekusi atau hasil.

BuildConfiguration

Objek

Detail BuildConfiguration.

Nama	Jenis	Deskripsi
branchName	string	Nama cabang yang buildnya dihasilkan.
buildDefinitionId	integer (int32)	BuildDefinitionId untuk build.
buildSystem	string	Bangun sistem.
creationDate	string (date-time)	Tanggal Pembuatan Build.
flavor	string	Ragam build (misalnya Build/Release).
id	integer (int32)	Id BuildConfiguration.
number	string	Nomor Build.
platform	string	Platform BuildConfiguration.
project	ShallowReference	Proyek yang terkait dengan BuildConfiguration ini.
repositoryGuid	string	Panduan Repositori untuk Build.
repositoryType	string	Jenis Repositori (misalnya. TFSGit).
sourceVersion	string	Versi Sumber(/penerapan pertama) untuk build dipicu.
targetBranchName	string	Target BranchName.
uri	string	Bangun Uri.

CustomTestField

Objek

Informasi bidang kustom. Kunci yang Diizinkan : Pasangan nilai - ( AttemptId: nilai int, IsTestResultFlaky: bool)

Nama	Jenis	Deskripsi
fieldName	string	Nama Bidang.
value	object	Nilai bidang.

DtlEnvironmentDetails

Objek

Ini adalah kelas sementara untuk memberikan detail untuk lingkungan uji coba.

Nama	Jenis	Deskripsi
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Objek

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Bidang ini berisi nol atau lebih tautan menarik tentang subjek grafik. Tautan ini dapat dipanggil untuk mendapatkan hubungan tambahan atau informasi yang lebih rinci tentang subjek grafik ini.
descriptor	string	Deskriptor adalah cara utama untuk mereferensikan subjek grafik saat sistem sedang berjalan. Bidang ini akan mengidentifikasi subjek grafik yang sama secara unik di seluruh Akun dan Organisasi.
directoryAlias	string	Tidak digunakan lagi - Dapat diambil dengan mengkueri pengguna Graph yang direferensikan dalam entri "diri" kamus IdentityRef "_links"
displayName	string	Ini adalah nama tampilan subjek grafik yang tidak unik. Untuk mengubah bidang ini, Anda harus mengubah nilainya di penyedia sumber.
id	string
imageUrl	string	Tidak digunakan lagi - Tersedia dalam entri "avatar" kamus IdentityRef "_links"
inactive	boolean	Tidak digunakan lagi - Dapat diambil dengan mengkueri status keanggotaan Graph yang direferensikan dalam entri "membershipState" kamus "_links" GraphUser
isAadIdentity	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Tidak digunakan lagi - tidak digunakan dalam sebagian besar implementasi ToIdentityRef yang sudah ada sebelumnya
uniqueName	string	Tidak digunakan lagi - gunakan Domain+PrincipalName sebagai gantinya
url	string	Url ini adalah rute lengkap ke sumber daya sumber subjek grafik ini.

JobReference

Objek

Pekerjaan dalam alur. Ini terkait dengan matriks dalam YAML.

Nama	Jenis	Deskripsi
attempt	integer (int32)	Nomor percobaan pekerjaan
jobName	string	Matriks dalam YAML menghasilkan salinan pekerjaan dengan input yang berbeda dalam matriks. JobName adalah nama input tersebut. Panjang maksimum yang didukung untuk nama adalah 256 karakter.

PhaseReference

Objek

Fase dalam alur

Nama	Jenis	Deskripsi
attempt	integer (int32)	Nomor percobaan fase
phaseName	string	Nama fase. Panjang maksimum yang didukung untuk nama adalah 256 karakter.

PipelineReference

Objek

Referensi alur

Nama	Jenis	Deskripsi
jobReference	JobReference	Referensi pekerjaan
phaseReference	PhaseReference	Referensi fase.
pipelineId	integer (int32)	Referensi alur yang terkait dengan instans alur ini.
stageReference	StageReference	Referensi tahap.

ReferenceLinks

Objek

Kelas untuk mewakili kumpulan tautan referensi REST.

Nama	Jenis	Deskripsi
links	object	Tampilan tautan secara baca-saja. Karena tautan Referensi dibaca saja, kami hanya ingin mengeksposnya sebagai baca-saja.

ReleaseReference

Objek

Referensi ke rilis.

Nama	Jenis	Deskripsi
attempt	integer (int32)	Jumlah Upaya Rilis.
creationDate	string (date-time)	Tanggal Pembuatan Rilis (UTC).
definitionId	integer (int32)	ID definisi rilis.
environmentCreationDate	string (date-time)	Tanggal pembuatan lingkungan (UTC).
environmentDefinitionId	integer (int32)	ID definisi lingkungan rilis.
environmentDefinitionName	string	Rilis nama definisi lingkungan.
environmentId	integer (int32)	ID lingkungan rilis.
environmentName	string	Nama lingkungan rilis.
id	integer (int32)	ID Rilis.
name	string	Nama rilis.

ResultMetadata

Enumeration

ResultMetadata untuk hasil/hitungan yang diberikan.

Nilai	Deskripsi
flaky	Metadata flaky
rerun	Jalankan ulang metadata

RunFilter

Objek

Kelas ini digunakan untuk menyediakan filter yang digunakan untuk penemuan

Nama	Jenis	Deskripsi
sourceFilter	string	filter untuk sumber kasus pengujian (kontainer pengujian)
testCaseFilter	string	filter untuk kasus pengujian

RunStatistic

Objek

Menguji statistik eksekusi per hasil.

Nama	Jenis	Deskripsi
count	integer (int32)	Jumlah hasil pengujian untuk hasil yang diberikan.
outcome	string	Hasil hasil pengujian
resolutionState	TestResolutionState	Uji Status Resolusi eksekusi.
resultMetadata	ResultMetadata	ResultMetadata untuk hasil/hitungan yang diberikan.
state	string	Status uji coba

ShallowReference

Objek

Referensi abstrak ke beberapa sumber daya lain. Kelas ini digunakan untuk menyediakan kontrak data build dengan cara yang seragam untuk mereferensikan sumber daya lain dengan cara yang menyediakan traversal yang mudah melalui tautan.

Nama	Jenis	Deskripsi
id	string	ID sumber daya
name	string	Nama sumber daya tertaut (nama definisi, nama pengontrol, dll.)
url	string	Tautan http lengkap ke sumber daya

StageReference

Objek

Tahapan dalam alur

Nama	Jenis	Deskripsi
attempt	integer (int32)	Nomor percobaan tahap
stageName	string	Nama panggung. Panjang maksimum yang didukung untuk nama adalah 256 karakter.

TestEnvironment

Objek

Detail lingkungan pengujian.

Nama	Jenis	Deskripsi
environmentId	string (uuid)	Uji Id Lingkungan.
environmentName	string	Menguji Nama Lingkungan.

TestResolutionState

Objek

Detail Status Resolusi Pengujian.

Nama	Jenis	Deskripsi
id	integer (int32)	Id status Resolusi Pengujian.
name	string	Nama Status Resolusi Pengujian.
project	ShallowReference	Referensi abstrak ke beberapa sumber daya lain. Kelas ini digunakan untuk menyediakan kontrak data build dengan cara yang seragam untuk mereferensikan sumber daya lain dengan cara yang menyediakan traversal yang mudah melalui tautan.

TestRun

Objek

Detail uji coba.

Nama	Jenis	Deskripsi
build	ShallowReference	Bangun yang terkait dengan eksekusi pengujian ini.
buildConfiguration	BuildConfiguration	Buat detail konfigurasi yang terkait dengan eksekusi pengujian ini.
comment	string	Komentar yang dimasukkan oleh mereka yang menganalisis eksekusi.
completedDate	string (date-time)	Waktu tanggal selesai eksekusi.
controller	string	Uji Pengontrol Eksekusi.
createdDate	string (date-time)	Uji Jalankan CreateDate.
customFields	CustomTestField[]	Daftar Bidang Kustom untuk TestRun.
dropLocation	string	Letakkan Lokasi untuk uji Coba.
dtlAutEnvironment	ShallowReference	Referensi abstrak ke beberapa sumber daya lain. Kelas ini digunakan untuk menyediakan kontrak data build dengan cara yang seragam untuk mereferensikan sumber daya lain dengan cara yang menyediakan traversal yang mudah melalui tautan.
dtlEnvironment	ShallowReference	Referensi abstrak ke beberapa sumber daya lain. Kelas ini digunakan untuk menyediakan kontrak data build dengan cara yang seragam untuk mereferensikan sumber daya lain dengan cara yang menyediakan traversal yang mudah melalui tautan.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Ini adalah kelas sementara untuk memberikan detail untuk lingkungan uji coba.
dueDate	string (date-time)	Tanggal jatuh tempo dan waktu untuk uji coba.
errorMessage	string	Pesan kesalahan yang terkait dengan eksekusi.
filter	RunFilter	Kelas ini digunakan untuk menyediakan filter yang digunakan untuk penemuan
id	integer (int32)	ID uji coba.
incompleteTests	integer (int32)	Jumlah Pengujian yang Tidak Lengkap.
isAutomated	boolean	true jika uji coba diotomatisasi, jika tidak salah.
iteration	string	Iterasi tempat eksekusi berada.
lastUpdatedBy	IdentityRef	ID fondasi tim dari eksekusi pengujian terakhir yang diperbarui.
lastUpdatedDate	string (date-time)	Tanggal dan waktu terakhir diperbarui
name	string	Nama eksekusi pengujian.
notApplicableTests	integer (int32)	Jumlah Tes yang Tidak Berlaku.
owner	IdentityRef	ID Yayasan Tim pemilik eksekusi.
passedTests	integer (int32)	Jumlah pengujian yang lulus dalam eksekusi
phase	string	Fase/Status untuk testRun.
pipelineReference	PipelineReference	Referensi alur tempat uji coba ini berada.
plan	ShallowReference	Rencana pengujian yang terkait dengan eksekusi pengujian ini.
postProcessState	string	Status Pasca Proses.
project	ShallowReference	Proyek yang terkait dengan eksekusi ini.
release	ReleaseReference	Referensi Rilis untuk Uji Coba.
releaseEnvironmentUri	string	Rilis Uri Lingkungan untuk TestRun.
releaseUri	string	Rilis Uri untuk TestRun.
revision	integer (int32)
runStatistics	RunStatistic[]	RunSummary dengan hasil.
startedDate	string (date-time)	Waktu tanggal mulai eksekusi.
state	string	Status eksekusi. Status Valid Type TestRunState - Unspecified ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	TestRun Substate.
tags	TestTag[]	Tag yang dilampirkan dengan uji coba ini.
testEnvironment	TestEnvironment	Lingkungan pengujian yang terkait dengan eksekusi.
testMessageLogId	integer (int32)
testSettings	ShallowReference	Referensi abstrak ke beberapa sumber daya lain. Kelas ini digunakan untuk menyediakan kontrak data build dengan cara yang seragam untuk mereferensikan sumber daya lain dengan cara yang menyediakan traversal yang mudah melalui tautan.
totalTests	integer (int32)	Total pengujian dalam eksekusi
unanalyzedTests	integer (int32)	Jumlah pengujian yang gagal dalam eksekusi.
url	string	Url eksekusi pengujian
webAccessUrl	string	Url Akses Web untuk TestRun.

TestRunPublishContext

Enumeration

PublishContext dari Eksekusi yang akan dikueri.

Nilai	Deskripsi
all	Eksekusi diterbitkan untuk Konteks apa pun.
build	Eksekusi diterbitkan untuk Konteks Build.
release	Eksekusi diterbitkan untuk Konteks Rilis.

TestRunState

Enumeration

Nilai	Deskripsi
aborted	Eksekusi dihentikan dan pengujian yang tersisa telah dibatalkan
completed	Semua pengujian telah selesai atau telah dilewati.
inProgress	Pengujian sedang berjalan.
needsInvestigation	Jalankan memerlukan penyelidikan karena kegagalan titik pengujian Ini adalah status warisan dan tidak boleh digunakan lagi
notStarted	Eksekusi masih dibuat. Belum ada tes yang dimulai.
unspecified	Hanya digunakan selama pembaruan untuk mempertahankan nilai yang ada.
waiting	Eksekusi saat ini menginisialisasi Ini adalah status warisan dan tidak boleh digunakan lagi

TestRunSubstate

Enumeration

Jenis sub-status untuk uji coba.

Nilai	Deskripsi
abortedBySystem	Jalankan status ketika Dibatalkan Oleh Sistem.
analyzed	Jalankan status setelah dianaalisa.
canceledByUser	Jalankan status saat Membuat Lingkungan.
cancellationInProgress	Jalankan status saat pembatalan sedang Berlangsung.
creatingEnvironment	Jalankan status saat Membuat Lingkungan.
none	Jalankan dengan noState.
pendingAnalysis	Jalankan status saat Analisis Tertunda.
runningTests	Jalankan status saat Menjalankan Pengujian.
timedOut	Status eksekusi saat eksekusi memiliki timedOut.

TestTag

Objek

Tag yang dilampirkan ke eksekusi atau hasil.

Nama	Jenis	Deskripsi
name	string	Nama tag, nilai alfanumerik kurang dari 30 karakter