Runs - Create

Başvuru

Service:: Test

API Version:: 7.1-preview.3

Yeni test çalıştırması oluşturun.

POST https://dev.azure.com/{organization}/{project}/_apis/test/runs?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 sürümü. Api'nin bu sürümünü kullanmak için bu değer '7.1-preview.3' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
automated	boolean	test çalıştırması otomatikse true, aksi takdirde false. Varsayılan olarak false olur.
build	ShallowReference	Ait olduğu derlemeye soyut bir başvuru.
buildDropLocation	string	Test çalıştırması için kullanılan derlemenin bırakma konumu.
buildFlavor	string	Test çalıştırması için kullanılan derlemenin tadı. (Örneğin: Yayın, Hata Ayıklama)
buildPlatform	string	Test çalıştırması için kullanılan derlemenin platformu. (Ör. x86, amd64)
buildReference	BuildConfiguration	Test çalıştırmasının BuildReference'ı.
comment	string	Çalıştırmayı analiz edenler tarafından girilen açıklamalar.
completeDate	string	Çalıştırmanın tamamlanma tarihi.
configurationIds	integer[]	Çalıştırmayla ilişkili test yapılandırmalarının kimlikleri.
controller	string	Otomatik çalıştırma için kullanılan test denetleyicisinin adı.
customTestFields	CustomTestField[]	Test Çalıştırması'nın ek özellikleri.
dtlAutEnvironment	ShallowReference	DtlAutEnvironment'a soyut bir başvuru.
dtlTestEnvironment	ShallowReference	DtlTestEnvironment'a soyut bir başvuru.
dueDate	string	Test çalıştırması için son tarih ve saat.
environmentDetails	DtlEnvironmentDetails	Bu, test çalıştırması ortamı için ayrıntıları sağlayan geçici bir sınıftır.
errorMessage	string	Çalıştırmayla ilişkili hata iletisi.
filter	RunFilter	Çalıştır'ı bulmak için kullanılan filtre.
iteration	string	Çalıştırmanın oluşturulacağı yineleme. Takım projesinin kök yinelemesi varsayılan olacaktır
name	string	Test çalıştırmasının adı.
owner	IdentityRef	Çalıştırma sahibinin görünen adı.
pipelineReference	PipelineReference	Bu test çalıştırmasının ait olduğu işlem hattının başvurusu. PipelineReference.PipelineId değeri RunCreateModel.Build.Id eşit olmalıdır
plan	ShallowReference	Ait olduğu plana soyut bir başvuru.
pointIds	integer[]	Çalıştırmada kullanılacak test noktalarının kimlikleri.
releaseEnvironmentUri	string	Çalıştırmayla ilişkili yayın ortamının URI'sini.
releaseReference	ReleaseReference	Test çalıştırmasıyla ilişkili sürüme başvuru.
releaseUri	string	Çalıştırmayla ilişkili yayının URI'sini.
runSummary	RunSummaryModel[]	Çalıştırma türü = NoConfigRun için çalıştırma özeti.
runTimeout	string	Çalışma zaman aşımına kadar zaman aralığı.
sourceWorkflow	string	Test çalıştırmasının SourceWorkFlow(CI/CD).
startDate	string	Çalıştırmanın başlangıç tarihi saati.
state	string	Çalıştırmanın durumu. TestRunState Geçerli durumları Yazın - NotStarted, InProgress, Waiting
tags	TestTag[]	Test çalıştırmasına eklenecek etiketler, çalıştırmak için en fazla 5 etiket eklenebilir.
testConfigurationsMapping	string	TestConfiguration Test çalıştırmasının eşlemesi.
testEnvironmentId	string	Çalıştırmayla ilişkili test ortamının kimliği.
testSettings	ShallowReference	Test ayarları kaynağına soyut bir başvuru.
type	string	Run(RunType) Geçerli Değerlerin Türü: (Belirtilmemiş, Normal, Engelleme, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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_write	Test planlarını, çalışmalarını, sonuçlarını ve diğer test yönetimiyle ilgili yapıtları okuma, oluşturma ve güncelleştirme olanağı sağlar.

Örnekler

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/runs?api-version=7.1-preview.3

{
  "name": "NewTestRun",
  "plan": {
    "id": "1"
  },
  "pointIds": [
    1,
    1
  ]
}

Sample Response

Status code:: 200

{
  "id": 31,
  "name": "NewTestRun",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Runs/31",
  "isAutomated": false,
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1\\Sprint 1",
  "owner": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "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-28T16:39:00.44Z",
  "state": "InProgress",
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "postProcessState": "Complete",
  "totalTests": 2,
  "incompleteTests": 2,
  "createdDate": "2014-05-28T16:39:00.4Z",
  "lastUpdatedDate": "2014-05-28T16:39:00.44Z",
  "lastUpdatedBy": {
    "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabrikamfiber3@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
  },
  "revision": 2
}

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.
RunCreateModel	Test çalıştırması oluşturma ayrıntıları.
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.
RunSummaryModel	Her test çıkış türü için özet çalıştırın.
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ı.
TestOutcome
TestResolutionState	Test Çözümleme Durumu Ayrıntıları.
TestRun	Test çalıştırması ayrıntıları.
TestRunSubstate	Test çalıştırması için alt durum türleri.
TestTag	Bir çalıştırmaya veya sonucu eklenmiş 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ş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

RunCreateModel

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

Name	Tür	Description
automated	boolean	test çalıştırması otomatikse true, aksi takdirde false. Varsayılan olarak false olur.
build	ShallowReference	Ait olduğu derlemeye soyut başvuru.
buildDropLocation	string	Test çalıştırması için kullanılan derlemenin bırakma konumu.
buildFlavor	string	Test çalıştırması için kullanılan derlemenin tadı. (Örneğin: Yayın, Hata Ayıklama)
buildPlatform	string	Test çalıştırması için kullanılan derlemenin platformu. (Ör. x86, amd64)
buildReference	BuildConfiguration	Test çalıştırmasının BuildReference'ı.
comment	string	Çalıştırmayı analiz edenler tarafından girilen açıklamalar.
completeDate	string	Çalıştırmanın tamamlanma tarihi.
configurationIds	integer[]	Çalıştırmayla ilişkili test yapılandırmalarının kimlikleri.
controller	string	Otomatik çalıştırma için kullanılan test denetleyicisinin adı.
customTestFields	CustomTestField[]	Test Çalıştırması'nın ek özellikleri.
dtlAutEnvironment	ShallowReference	DtlAutEnvironment'a soyut başvuru.
dtlTestEnvironment	ShallowReference	DtlTestEnvironment'a soyut başvuru.
dueDate	string	Test çalıştırması için son tarih ve saat.
environmentDetails	DtlEnvironmentDetails	Bu, test çalıştırması ortamı için ayrıntıları sağlayan geçici bir sınıftır.
errorMessage	string	Çalıştırmayla ilişkili hata iletisi.
filter	RunFilter	Çalıştır'ı bulmak için kullanılan filtre.
iteration	string	Çalıştırmanın oluşturulacağı yineleme. Takım projesinin kök yinelemesi varsayılan olacaktır
name	string	Test çalıştırmasının adı.
owner	IdentityRef	Çalıştırma sahibinin görünen adı.
pipelineReference	PipelineReference	Bu test çalıştırmasının ait olduğu işlem hattının başvurusu. PipelineReference.PipelineId değeri RunCreateModel.Build.Id eşit olmalıdır
plan	ShallowReference	Ait olduğu plana soyut bir başvuru.
pointIds	integer[]	Çalıştırmada kullanılacak test noktalarının kimlikleri.
releaseEnvironmentUri	string	Çalıştırmayla ilişkili yayın ortamının URI'sini.
releaseReference	ReleaseReference	Test çalıştırmasıyla ilişkili sürüme başvuru.
releaseUri	string	Çalıştırmayla ilişkili yayının URI'sini.
runSummary	RunSummaryModel[]	Çalıştırma türü = NoConfigRun için çalıştırma özeti.
runTimeout	string	Koşu zaman aşımına kadar zaman aralığı.
sourceWorkflow	string	Test çalıştırmasının SourceWorkFlow(CI/CD).
startDate	string	Çalıştırmanın başlangıç tarihi saati.
state	string	Çalıştırmanın durumu. Type TestRunState Valid states - NotStarted, InProgress, Waiting
tags	TestTag[]	Test çalıştırmasına eklenecek etiketler, çalıştırılacak en fazla 5 etiket eklenebilir.
testConfigurationsMapping	string	Test çalıştırmasının TestConfigurationMapping'i.
testEnvironmentId	string	Çalıştırmayla ilişkili test ortamının kimliği.
testSettings	ShallowReference	Test ayarları kaynağına soyut başvuru.
type	string	Run(RunType) Geçerli Değerlerin Türü: (Belirtilmemiş, Normal, Engelleme, Web, MtrRunInitiatedFromWeb, RunWithDtlEnv, NoConfigRun)

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

RunSummaryModel

Her test çıkış türü için özet çalıştırın.

Name	Tür	Description
duration	integer	Milisaniye cinsinden geçen toplam süre.
resultCount	integer	Sonuç TestiOutcome için sonuç sayısı
testOutcome	TestOutcome	Özet, sonuca dayanır

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