Runs - Get Test Run By Id
Kimliğine göre bir test çalıştırması alın.
GET https://dev.azure.com/{organization}/{project}/_apis/test/runs/{runId}?api-version=7.1-preview.3
GET https://dev.azure.com/{organization}/{project}/_apis/test/runs/{runId}?includeDetails={includeDetails}&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ı |
run
|
path | True |
integer int32 |
Alınacak çalıştırmanın kimliği. |
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. |
include
|
query |
boolean |
True varsayılan değerdir. Çalıştırma istatistikleri, yayın, derleme, test ortamı, işlem sonrası durumu ve daha fazlası gibi ayrıntıları içerir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
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. |
Örnekler
Sample Request
GET https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs/1?api-version=7.1-preview.3
Sample Response
{
"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
}
Tanımlar
Name | Description |
---|---|
Build |
BuildConfiguration Ayrıntıları. |
Custom |
Özel alan bilgileri. İzin Verilen Anahtar : Değer çiftleri - ( AttemptId: int değeri, IsTestResultFlaky: bool) |
Dtl |
Bu, test çalıştırması ortamı için ayrıntıları sağlayan geçici bir sınıftır. |
Identity |
|
Job |
İşlem hattındaki iş. Bu, YAML'deki matrisle ilgilidir. |
Phase |
İşlem hattında aşama |
Pipeline |
İşlem hattı başvurusu |
Reference |
REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf. |
Release |
Sürüm başvurusu. |
Result |
Verilen sonuç/sayı için ResultMetadata. |
Run |
Bu sınıf bulma için kullanılan filtreleri sağlamak için kullanılır |
Run |
Sonuç başına test çalıştırması istatistikleri. |
Shallow |
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. |
Stage |
İşlem hattında aşama |
Test |
Test ortamı Ayrıntısı. |
Test |
Test Çözümleme Durumu Ayrıntıları. |
Test |
Test çalıştırması ayrıntıları. |
Test |
Test çalıştırması için alt durum türleri. |
Test |
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 |
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 |
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 |
İşin başvurusu |
|
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 |
Aşamanın 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 |
Yayın 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 |
Test çalıştırması Çözümleme Durumu. |
|
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 |
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 |
Bu test çalıştırmasıyla ilişkili derleme. |
|
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 |
TestRun için Özel Alanlar Listesi. |
|
dropLocation |
string |
Test Çalıştırması için Bırakma Konumu. |
dtlAutEnvironment |
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 |
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 |
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 |
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 |
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 |
Ç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 |
Bu test çalıştırmasının ait olduğu işlem hattının başvurusu. |
|
plan |
Bu test çalıştırmasıyla ilişkili test planı. |
|
postProcessState |
string |
İşlem Sonrası Durumu. |
project |
Bu çalıştırmayla ilişkili proje. |
|
release |
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 |
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 |
TestRun Alt Durumu. |
|
tags |
Test |
Bu test çalıştırmasıyla eklenen etiketler. |
testEnvironment |
Çalıştırmayla ilişkili test ortamı. |
|
testMessageLogId |
integer |
|
testSettings |
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. |
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 |