Runs - Query

Service:

Test

API Version:

7.1-preview.3

Sorgu Testi, filtrelere göre çalıştırılır. 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-preview.3

With optional parameters:

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-preview.3

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-preview.3' olarak ayarlanmalıdır.
maxLastUpdatedDate	query	True	string date-time	Sorgulanacak En Fazla Son Değiştirme Tarihi (Zorunlu, en düşük ve en yüksek tarih arasındaki fark en fazla 7 gün olabilir).
minLastUpdatedDate	query	True	string date-time	Sorgulanacak çalıştırmanın En Düşük Son Değiştirilme 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şlem için null. Kullanıcı tarafından oluşturulmaması (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 Çalıştırma Başlığı.
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

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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

Scopes

Name	Description
vso.test	Test planlarını, çalışmalarını, sonuçlarını 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ı için ayrıntıları sağlayan geçici bir sınıftır.
IdentityRef
JobReference	İşlem hattındaki iş. Bu, YAML'deki matrisle ilgilidir.
PhaseReference	İşlem hattında aşama
PipelineReference	İşlem hattı başvurusu
ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
ReleaseReference	Sürüm başvurusu.
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
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 sonucu iliştirilmiş etiket.

BuildConfiguration

BuildConfiguration Ayrıntıları.

Name	Tür	Description
branchName	string	Derlemenin oluşturulduğu dal adı.
buildDefinitionId	integer	Derleme için BuildDefinitionId.
buildSystem	string	Derleme sistemi.
creationDate	string	Derleme Oluşturma Tarihi.
flavor	string	Derleme aroması (derleme/yayın gibi).
id	integer	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

Ö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

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

Name	Tür	Description
csmContent	string
csmParameters	string
subscriptionName	string

IdentityRef

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusu hakkında sıfır veya daha fazla ilgi çekici 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üğün "membershipState" girişinde 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 (Descriptor.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

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

Name	Tür	Description
attempt	integer	İş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

İşlem hattında aşama

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

PipelineReference

İşlem hattı başvurusu

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

ReferenceLinks

REST başvuru bağlantılarının 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

Sürüm başvurusu.

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

ResultMetadata

Verilen sonuç/sayı için ResultMetadata.

Name	Tür	Description
flaky	string	Flaky meta verileri
rerun	string	Meta verileri yeniden çalıştırma

RunFilter

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

RunStatistic

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

Name	Tür	Description
count	integer	Verilen sonucun test sonucu sayısı.
outcome	string	Test 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

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

İşlem hattında aşama

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

TestEnvironment

Test ortamı Ayrıntısı.

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

TestResolutionState

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

Name	Tür	Description
id	integer	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

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	Çalıştırmanın tamamlanma tarihi.
controller	string	Test Çalıştırma Denetleyicisi.
createdDate	string	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ı için ayrıntıları sağlayan geçici bir sınıftır.
dueDate	string	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	Test çalıştırmasının kimliği.
incompleteTests	integer	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	Son güncelleştirme tarihi ve saati
name	string	Test çalıştırmasının adı.
notApplicableTests	integer	Uygulanamaz Test sayısı.
owner	IdentityRef	Çalıştırmaların sahibinin Team Foundation Kimliği.
passedTests	integer	Ç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
runStatistics	RunStatistic[]	Sonuca göre RunSummary.
startedDate	string	Çalıştırmanın başlangıç tarihi saati.
state	string	Çalıştırmanın durumu. Type TestRunState Valid states - Unspecified,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
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	Çalıştırmadaki toplam test sayısı
unanalyzedTests	integer	Ç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

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

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

TestRunState

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

TestRunSubstate

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

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

TestTag

Bir çalıştırmaya veya sonucu iliştirilmiş etiket.

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