Runs - Query

Hizmet:

Test

API Sürümü:

7.1

Filtreleri temel alan Sorgu Testi Çalıştırmaları. Zorunlu alanlar minLastUpdatedDate ve maxLastUpdatedDate alanlarıdır.

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

İsteğe bağlı parametrelerle:

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje kimliği veya proje adı
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, API'nin bu sürümünü kullanmak için '7.1' olarak ayarlanmalıdır.
maxLastUpdatedDate	query	True	string (date-time)	Sorgulanacak En Fazla Son Değiştirme Tarihi (Zorunlu, en düşük ve en fazla tarih arasındaki fark en fazla 7 gün olabilir).
minLastUpdatedDate	query	True	string (date-time)	Sorgulanacak En Düşük Son Değiştirme Tarihi (Zorunlu).
$top	query		integer (int32)	Sorgulanacak çalıştırma sayısı. Sınır 100'dür
branchName	query		string	Sorgulanacak Çalıştırmaların Kaynak Dal adı.
buildDefIds	query		string (array (int32))	Sorgulanacak Çalıştırmaların Derleme Tanım Kimlikleri, geçerli kimliklerin virgülle ayrılmış listesi (sınır no. kimlik 10).
buildIds	query		string (array (int32))	Sorgulanacak Çalıştırmaların derleme kimlikleri, geçerli kimliklerin virgülle ayrılmış listesi (sınır no. kimlik 10).
continuationToken	query		string	continuationToken önceki toplu işlemden alındı veya ilk toplu iş için null. Kullanıcı tarafından oluşturulması (veya son toplu işlemden alınırsa değiştirilmesi) gerekmez.
isAutomated	query		boolean	Sorgulanacak Çalıştırmaların otomasyon türü.
planIds	query		string (array (int32))	Sorgulanacak Çalıştırmaların plan kimlikleri, geçerli kimliklerin virgülle ayrılmış listesi (sınır no. kimlik 10).
publishContext	query		TestRunPublishContext	Sorgulanacak Çalıştırmaların PublishContext'i.
releaseDefIds	query		string (array (int32))	Sorgulanacak Çalıştırmaların Yayın Tanımı Kimlikleri, geçerli kimliklerin virgülle ayrılmış listesi (sınır no. kimlik 10).
releaseEnvDefIds	query		string (array (int32))	Sorgulanacak Çalıştırmaların Yayın Ortamı Tanım Kimlikleri, geçerli kimliklerin virgülle ayrılmış listesi (sınır no. kimlik 10).
releaseEnvIds	query		string (array (int32))	Sorgulanacak Çalıştırmaların Yayın Ortamı Kimlikleri, geçerli kimliklerin virgülle ayrılmış listesi (sınır no. kimlik 10).
releaseIds	query		string (array (int32))	Sorgulanacak Çalıştırmaların sürüm kimlikleri, geçerli kimliklerin virgülle ayrılmış listesi (sınır no. kimlik 10).
runTitle	query		string	Sorgulanacak Çalıştırmaların Başlığını Çalıştırın.
state	query		TestRunState	Sorgulanacak Çalıştırmaların geçerli durumu.

Yanıtlar

Name	Tür	Description
200 OK	TestRun[]	başarılı işlem

Güvenlik

oauth2

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

Name	Description
vso.test	Test planlarını, çalışmaları, sonuçları ve test yönetimiyle ilgili diğer yapıtları okuma olanağı sağlar.

Tanımlar

Name	Description
BuildConfiguration	BuildConfiguration Ayrıntıları.
CustomTestField	Özel alan bilgileri. İzin Verilen Anahtar : Değer çiftleri - ( AttemptId: int değeri, IsTestResultFlaky: bool)
DtlEnvironmentDetails	Bu, test çalıştırması ortamının ayrıntılarını sağlayan geçici bir sınıftır.
IdentityRef
JobReference	İşlem hattındaki iş. Bu, YAML'deki matrislemeyle ilgilidir.
PhaseReference	İşlem hattında aşama
PipelineReference	İşlem hattı başvurusu
ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
ReleaseReference	Bir sürüme başvuru.
ResultMetadata	Verilen sonuç/sayı için ResultMetadata.
RunFilter	Bu sınıf bulma için kullanılan filtreleri sağlamak için kullanılır
RunStatistic	Sonuç başına test çalıştırması istatistikleri.
ShallowReference	Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.
StageReference	İşlem hattında aşama oluşturma
TestEnvironment	Test ortamı Ayrıntısı.
TestResolutionState	Test Çözümleme Durumu Ayrıntıları.
TestRun	Test çalıştırması ayrıntıları.
TestRunPublishContext	Sorgulanacak Çalıştırmaların PublishContext'i.
TestRunState
TestRunSubstate	Test çalıştırması için alt durum türleri.
TestTag	Bir çalıştırmaya veya sonuda eklenmiş etiket.

BuildConfiguration

Object

BuildConfiguration Ayrıntıları.

Name	Tür	Description
branchName	string	Derlemenin oluşturulduğu dal adı.
buildDefinitionId	integer (int32)	Derleme için BuildDefinitionId.
buildSystem	string	Derleme sistemi.
creationDate	string (date-time)	Derleme Oluşturma Tarihi.
flavor	string	Derleme aroması (derleme/yayın gibi).
id	integer (int32)	BuildConfiguration Kimliği.
number	string	Derleme Numarası.
platform	string	BuildConfiguration Platformu.
project	ShallowReference	Bu BuildConfiguration ile ilişkili proje.
repositoryGuid	string	Derleme için Depo Guid'i.
repositoryType	string	Depo Türü (örn. TFSGit).
sourceVersion	string	Derleme için Kaynak Sürüm (/ilk işleme) tetiklendi.
targetBranchName	string	Hedef BranchName.
uri	string	Derleme Uri'si.

CustomTestField

Object

Özel alan bilgileri. İzin Verilen Anahtar : Değer çiftleri - ( AttemptId: int değeri, IsTestResultFlaky: bool)

Name	Tür	Description
fieldName	string	Alan Adı.
value	object	Alan değeri.

DtlEnvironmentDetails

Object

Bu, test çalıştırması ortamının ayrıntılarını sağlayan geçici bir sınıftır.

Name	Tür	Description
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Object

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusu hakkında sıfır veya daha fazla ilginç bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında daha fazla ilişki veya daha ayrıntılı bilgi edinmek için çağrılabilir.
descriptor	string	Tanımlayıcı, sistem çalışırken graf konusuna başvurmanın birincil yoludur. Bu alan, hem Hesaplar hem de Kuruluşlar genelinde aynı graf konusunu benzersiz olarak tanımlar.
directoryAlias	string	Kullanım dışı - IdentityRef "_links" sözlüğündeki "self" girişinde başvuruda bulunılan Graph kullanıcısı sorgulanarak alınabilir
displayName	string	Bu, grafik konusunun benzersiz olmayan görünen adıdır. Bu alanı değiştirmek için kaynak sağlayıcıdaki değerini değiştirmeniz gerekir.
id	string
imageUrl	string	Kullanım dışı - IdentityRef "_links" sözlüğün "avatar" girişinde kullanılabilir
inactive	boolean	Kullanım dışı - GraphUser "_links" sözlüğündeki "membershipState" girdisinde başvurulan Graph üyelik durumu sorgulanarak alınabilir
isAadIdentity	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Tanımlayıcı.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Kullanım dışı - ToIdentityRef'in önceden var olan uygulamalarının çoğunda kullanımda değil
uniqueName	string	Kullanım dışı - bunun yerine Domain+PrincipalName kullanın
url	string	Bu url, bu grafik konusunun kaynak kaynağına giden tam yoldur.

JobReference

Object

İşlem hattındaki iş. Bu, YAML'deki matrislemeyle ilgilidir.

Name	Tür	Description
attempt	integer (int32)	İşin deneme numarası
jobName	string	YAML'de matris oluşturma, matriste farklı girişlere sahip bir işin kopyalarını oluşturur. JobName, bu girişlerin adıdır. Ad için desteklenen uzunluk üst sınırı 256 karakterdir.

PhaseReference

Object

İşlem hattında aşama

Name	Tür	Description
attempt	integer (int32)	Aşamanın deneme numarası
phaseName	string	Aşamanın adı. Ad için desteklenen uzunluk üst sınırı 256 karakterdir.

PipelineReference

Object

İşlem hattı başvurusu

Name	Tür	Description
jobReference	JobReference	İşin başvurusu
phaseReference	PhaseReference	Aşama başvurusu.
pipelineId	integer (int32)	Bu işlem hattı örneğinin ilişkili olduğu işlem hattının başvurusu.
stageReference	StageReference	Aşama başvurusu.

ReferenceLinks

Object

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

ReleaseReference

Object

Bir sürüme başvuru.

Name	Tür	Description
attempt	integer (int32)	Yayın Denemesi Sayısı.
creationDate	string (date-time)	Sürüm Oluşturma Tarihi(UTC).
definitionId	integer (int32)	Yayın tanımı kimliği.
environmentCreationDate	string (date-time)	Ortam oluşturma Tarihi(UTC).
environmentDefinitionId	integer (int32)	Yayın ortamı tanımı kimliği.
environmentDefinitionName	string	Yayın ortamı tanımı adı.
environmentId	integer (int32)	Yayın ortamı kimliği.
environmentName	string	Yayın ortamı adı.
id	integer (int32)	Sürüm Kimliği.
name	string	Sürüm adı.

ResultMetadata

Listeleme

Verilen sonuç/sayı için ResultMetadata.

Değer	Description
flaky	Flaky meta verileri
rerun	Meta verileri yeniden çalıştırma

RunFilter

Object

Bu sınıf bulma için kullanılan filtreleri sağlamak için kullanılır

Name	Tür	Description
sourceFilter	string	test çalışması kaynakları için filtre (test kapsayıcıları)
testCaseFilter	string	test çalışmaları için filtre uygulama

RunStatistic

Object

Sonuç başına test çalıştırması istatistikleri.

Name	Tür	Description
count	integer (int32)	Verilen sonucun test sonucu sayısı.
outcome	string	Test sonucu sonucu
resolutionState	TestResolutionState	Test çalıştırması Çözümleme Durumu.
resultMetadata	ResultMetadata	Verilen sonuç/sayı için ResultMetadata.
state	string	Test çalıştırmasının durumu

ShallowReference

Object

Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.

Name	Tür	Description
id	string	Kaynağın kimliği
name	string	Bağlı kaynağın adı (tanım adı, denetleyici adı vb.)
url	string	Kaynağa tam http bağlantısı

StageReference

Object

İşlem hattında aşama oluşturma

Name	Tür	Description
attempt	integer (int32)	Aşama sayısı denemesi
stageName	string	Aşamanın adı. Ad için desteklenen uzunluk üst sınırı 256 karakterdir.

TestEnvironment

Object

Test ortamı Ayrıntısı.

Name	Tür	Description
environmentId	string (uuid)	Test Ortamı Kimliği.
environmentName	string	Test Ortamı Adı.

TestResolutionState

Object

Test Çözümleme Durumu Ayrıntıları.

Name	Tür	Description
id	integer (int32)	Test Çözümlemesi durum kimliği.
name	string	Test Çözümlemesi Durum Adı.
project	ShallowReference	Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.

TestRun

Object

Test çalıştırması ayrıntıları.

Name	Tür	Description
build	ShallowReference	Bu test çalıştırmasıyla ilişkili derleme.
buildConfiguration	BuildConfiguration	Bu test çalıştırmasıyla ilişkili yapılandırma ayrıntılarını derleyin.
comment	string	Çalıştırmayı analiz edenler tarafından girilen açıklamalar.
completedDate	string (date-time)	Çalıştırmanın tamamlanma tarihi.
controller	string	Test Çalıştırma Denetleyicisi.
createdDate	string (date-time)	Test Çalıştırması CreatedDate.
customFields	CustomTestField[]	TestRun için Özel Alanlar Listesi.
dropLocation	string	Test Çalıştırması için Bırakma Konumu.
dtlAutEnvironment	ShallowReference	Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.
dtlEnvironment	ShallowReference	Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.
dtlEnvironmentCreationDetails	DtlEnvironmentDetails	Bu, test çalıştırması ortamının ayrıntılarını sağlayan geçici bir sınıftır.
dueDate	string (date-time)	Test çalıştırması için son tarih ve saat.
errorMessage	string	Çalıştırmayla ilişkili hata iletisi.
filter	RunFilter	Bu sınıf bulma için kullanılan filtreleri sağlamak için kullanılır
id	integer (int32)	Test çalıştırmasının kimliği.
incompleteTests	integer (int32)	Tamamlanmamış Test Sayısı.
isAutomated	boolean	test çalıştırması otomatikse true, aksi takdirde false.
iteration	string	Çalıştırmanın ait olduğu yineleme.
lastUpdatedBy	IdentityRef	Test çalıştırmasının son güncelleştirilen team foundation kimliği.
lastUpdatedDate	string (date-time)	Son güncelleştirme tarihi ve saati
name	string	Test çalıştırmasının adı.
notApplicableTests	integer (int32)	Uygulanamaz Test Sayısı.
owner	IdentityRef	Çalıştırmaların sahibinin Team Foundation Kimliği.
passedTests	integer (int32)	Çalıştırmadaki geçirilen testlerin sayısı
phase	string	testRun için Aşama/Durum.
pipelineReference	PipelineReference	Bu test çalıştırmasının ait olduğu işlem hattının başvurusu.
plan	ShallowReference	Bu test çalıştırmasıyla ilişkili test planı.
postProcessState	string	İşlem Sonrası Durumu.
project	ShallowReference	Bu çalıştırmayla ilişkili proje.
release	ReleaseReference	Test Çalıştırması için Sürüm Başvurusu.
releaseEnvironmentUri	string	TestRun için Yayın Ortamı Uri'si.
releaseUri	string	TestRun için Sürüm Uri'sini kullanın.
revision	integer (int32)
runStatistics	RunStatistic[]	Sonuca göre RunSummary.
startedDate	string (date-time)	Çalıştırmanın başlangıç tarihi saati.
state	string	Çalıştırmanın durumu. Tür TestRunState Geçerli durumlar - Belirtilmemiş ,NotStarted, InProgress, Completed, Waiting, Aborted, NeedsInvestigation
substate	TestRunSubstate	TestRun Alt Durumu.
tags	TestTag[]	Bu test çalıştırmasıyla eklenen etiketler.
testEnvironment	TestEnvironment	Çalıştırmayla ilişkili test ortamı.
testMessageLogId	integer (int32)
testSettings	ShallowReference	Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.
totalTests	integer (int32)	Çalıştırmadaki toplam test sayısı
unanalyzedTests	integer (int32)	Çalıştırmadaki başarısız testlerin sayısı.
url	string	Test çalıştırmasının url'si
webAccessUrl	string	TestRun için Web Erişimi Url'si.

TestRunPublishContext

Listeleme

Sorgulanacak Çalıştırmaların PublishContext'i.

Değer	Description
all	Çalıştırma herhangi bir Bağlam için yayımlanır.
build	Çalıştırma, Derleme Bağlamı için yayımlanır.
release	Çalıştırma Yayın Bağlamı için yayımlanır.

TestRunState

Listeleme

Değer	Description
aborted	Çalıştırma durduruldu ve kalan testler durduruldu
completed	Tüm testler tamamlandı veya atlandı.
inProgress	Testler çalışıyor.
needsInvestigation	Çalıştırma, bir test noktası hatası nedeniyle araştırma gerektirir Bu eski bir durumdur ve artık kullanılmamalıdır
notStarted	Çalıştırma oluşturulmaya devam ediyor. Henüz hiçbir test başlatılmadı.
unspecified	Yalnızca mevcut değeri korumak için güncelleştirme sırasında kullanılır.
waiting	Çalıştırma şu anda başlatılıyor Bu eski bir durumdur ve artık kullanılmamalıdır

TestRunSubstate

Listeleme

Test çalıştırması için alt durum türleri.

Değer	Description
abortedBySystem	Sistem Tarafından Durdurulduğunda çalıştırma durumu.
analyzed	Analizden sonra çalıştırma durumu.
canceledByUser	Ortam Oluştururken çalıştırma durumu.
cancellationInProgress	İptal işlemi devam ederken çalıştırma durumu.
creatingEnvironment	Ortam Oluştururken çalıştırma durumu.
none	noState ile çalıştırın.
pendingAnalysis	Bekleyen Analiz sırasında çalıştırma durumu.
runningTests	Testleri Çalıştırırken durumu çalıştırın.
timedOut	Çalıştırma timedOut olduğunda çalıştırma durumu.

TestTag

Object

Bir çalıştırmaya veya sonuda eklenmiş etiket.

Name	Tür	Description
name	string	Etiketin adı, alfasayısal değer 30 karakterden küçük