Pull Requests - Get Pull Request

Hizmet:

Git

API Sürümü:

5.0

Çekme isteği alın.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests/{pullRequestId}?api-version=5.0

İsteğe bağlı parametrelerle:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests/{pullRequestId}?maxCommentLength={maxCommentLength}&$skip={$skip}&$top={$top}&includeCommits={includeCommits}&includeWorkItemRefs={includeWorkItemRefs}&api-version=5.0

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
pullRequestId	path	True	integer int32	Alınacak çekme isteğinin kimliği.
repositoryId	path	True	string	Çekme isteğinin hedef dalının depo kimliği.
project	path		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 '5.0' olarak ayarlanmalıdır.
$skip	query		integer int32	Kullanılmadı.
$top	query		integer int32	Kullanılmadı.
includeCommits	query		boolean	True ise, çekme isteği ilişkili işlemelerle birlikte döndürülür.
includeWorkItemRefs	query		boolean	True ise, çekme isteği ilişkili iş öğesi başvuruları ile döndürülür.
maxCommentLength	query		integer int32	Kullanılmadı.

Yanıtlar

Name	Tür	Description
200 OK	GitPullRequest	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.code	İşlemeler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkında kaynak kodu ve meta verileri okuma yeteneği verir. Ayrıca kod arama ve hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı verir.

Tanımlar

Name	Description
ChangeCountDictionary
GitChange
GitCommitRef	Git işleme ve ilişkili meta verileri açıklayan özellikler sağlar.
GitForkRef	Çatal başvurusu hakkında bilgi.
GitPullRequest	Çekme isteğiyle ilişkili tüm verileri temsil eder.
GitPullRequestCompletionOptions	Çekme isteğinin nasıl tamamlanması gerektiğiyle ilgili tercihler.
GitPullRequestMergeOptions	Çekme isteği birleştirme oluşturulduğunda kullanılan seçenekler.
GitPushRef
GitRepository
GitRepositoryRef
GitStatus	Bu sınıf, durum gönderen bir hizmetin/uzantının meta verilerini içerir.
GitStatusContext	Durumu benzersiz olarak tanımlayan durum bağlamı.
GitStatusState	Durumun durumu.
GitTemplate
GitUserDate	Git işlemleri için kullanıcı bilgileri ve tarihi.
IdentityRef
IdentityRefWithVote	Çekme isteğine oy verme dahil olmak üzere kimlik bilgileri.
ItemContent
ItemContentType
ProjectState	Proje durumu.
ProjectVisibility	Proje görünürlüğü.
PullRequestAsyncStatus	Çekme isteği birleştirmenin geçerli durumu.
PullRequestMergeFailureType	Çekme isteği birleştirme işleminin hata türü (varsa).
PullRequestStatus	Çekme isteğinin durumu.
ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
ResourceRef
TeamProjectCollectionReference	TeamProjectCollection için başvuru nesnesi.
TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.
VersionControlChangeType	Öğede yapılan değişikliğin türü.
WebApiTagDefinition	Tel üzerinden gönderilen etiket tanımının gösterimi.

ChangeCountDictionary

Object

GitChange

Object

Name	Tür	Description
changeId	integer	Değişiklik grubu içindeki değişikliğin kimliği.
changeType	VersionControlChangeType	Öğede yapılan değişikliğin türü.
item	string	Geçerli sürüm.
newContent	ItemContent	Değişiklik sonrasında öğenin içeriği.
newContentTemplate	GitTemplate	Yeni değişiklikler gönderildiğinde kullanılacak yeni İçerik şablonu.
originalPath	string	Geçerli yoldan farklıysa öğenin özgün yolu.
sourceServerItem	string	Sunucudaki öğenin yolu.
url	string	Öğeyi almak için URL.

GitCommitRef

Object

Git işleme ve ilişkili meta verileri açıklayan özellikler sağlar.

Name	Tür	Description
_links	ReferenceLinks	İlgili REST başvuru bağlantılarından oluşan bir koleksiyon.
author	GitUserDate	İşlemenin yazarı.
changeCounts	ChangeCountDictionary	İşlemeye dahil edilen değişiklik türlerinin (düzenleme, silme vb.) sayısı.
changes	GitChange[]	İşlemeye dahil edilen değişikliklerin sabit listesi.
comment	string	İşlemenin açıklaması veya iletisi.
commentTruncated	boolean	Açıklamanın tam Git işleme açıklama iletisinden kesilip kesilmediğini gösterir.
commitId	string	İşlemenin kimliği (SHA-1).
committer	GitUserDate	İşlemenin commiter'i.
parents	string[]	Bu işleme için üst işleme kimliklerinin sabit listesi.
push	GitPushRef	Bu işlemeyle ilişkili gönderim.
remoteUrl	string	İşlemenin uzak URL yolu.
statuses	GitStatus[]	Ek bilgileri işlemeyle ilişkilendirebilecek hizmet ve uzantılardan gelen durum meta verilerinin listesi.
url	string	Bu kaynağın REST URL'si.
workItems	ResourceRef[]	Bu işlemeyle ilişkili iş öğeleri listesi.

GitForkRef

Object

Çatal başvurusu hakkında bilgi.

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
creator	IdentityRef
isLocked	boolean
isLockedBy	IdentityRef
name	string
objectId	string
peeledObjectId	string
repository	GitRepository	Çatalın depo kimliği.
statuses	GitStatus[]	Bu sınıf, durum gönderen bir hizmetin/uzantının meta verilerini içerir.
url	string

GitPullRequest

Object

Çekme isteğiyle ilişkili tüm verileri temsil eder.

Name	Tür	Description
_links	ReferenceLinks	Diğer ilgili nesnelere bağlantılar.
artifactId	string	Bu çekme isteğini benzersiz olarak tanımlayan bir dize. Çekme isteği için yapıt kimliği oluşturmak için şu şablonu kullanın: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}
autoCompleteSetBy	IdentityRef	Ayarlanırsa, bu çekme isteği için otomatik tamamlama etkinleştirilir ve bunu etkinleştiren kimlik budur.
closedBy	IdentityRef	Çekme isteğini kapatan kullanıcı.
closedDate	string	Çekme isteğinin kapatıldığı tarih (tamamlandı, bırakıldı veya harici olarak birleştirildi).
codeReviewId	integer	Kod, çekme isteğinin kimliğini gözden geçirir. Dahili olarak kullanılır.
commits	GitCommitRef[]	Çekme isteğinde yer alan işlemeler.
completionOptions	GitPullRequestCompletionOptions	Çekme isteğinin tamamlandığında nasıl birleştirileceğini etkileyen seçenekler.
completionQueueTime	string	Tamamlanmak üzere çekme isteğinin kuyruğa girdiği en son tarih. Dahili olarak kullanılır.
createdBy	IdentityRef	Çekme isteğini oluşturan kullanıcının kimliği.
creationDate	string	Çekme isteğinin oluşturulduğu tarih.
description	string	Çekme isteğinin açıklaması.
forkSource	GitForkRef	Bu bir çataldan gelen çekme isteğiyse, kaynağı hakkında bilgi içerir.
isDraft	boolean	Taslak / WIP çekme isteği.
labels	WebApiTagDefinition[]	Çekme isteğiyle ilişkili etiketler.
lastMergeCommit	GitCommitRef	En son çekme isteği birleştirme işleminin işlemesi. Boşsa, en son birleştirme devam ediyor veya başarısız oldu.
lastMergeSourceCommit	GitCommitRef	Son çekme isteği birleştirme sırasında kaynak dalın başındaki işleme.
lastMergeTargetCommit	GitCommitRef	Son çekme isteği birleştirme sırasında hedef dalın başındaki işleme.
mergeFailureMessage	string	Ayarlandıysa, çekme isteği birleştirme bu nedenle başarısız oldu.
mergeFailureType	PullRequestMergeFailureType	Çekme isteği birleştirme işleminin hata türü (varsa).
mergeId	string	Çekme isteği birleştirmeyi çalıştırmak için kullanılan işin kimliği. Dahili olarak kullanılır.
mergeOptions	GitPullRequestMergeOptions	Çekme isteği birleştirme işlemi çalıştırıldığında kullanılan seçenekler. Tamamlama yalnızca bir kez gerçekleştiğinden ve çekme isteğinin kaynak dalı her değiştiğinde yeni bir birleştirme çalıştırılacağından bunlar tamamlama seçeneklerinden ayrıdır.
mergeStatus	PullRequestAsyncStatus	Çekme isteği birleştirmenin geçerli durumu.
pullRequestId	integer	Çekme isteğinin kimliği.
remoteUrl	string	Dahili olarak kullanılır.
repository	GitRepository	Çekme isteğinin hedef dalını içeren depo.
reviewers	IdentityRefWithVote[]	Çekme isteğindeki gözden geçirenlerin listesi ve oylarının durumu.
sourceRefName	string	Çekme isteğinin kaynak dalının adı.
status	PullRequestStatus	Çekme isteğinin durumu.
supportsIterations	boolean	Doğruysa, bu çekme isteği birden çok yinelemeyi destekler. Yineleme desteği, çekme isteğinin kaynak dalına yapılan tek tek gönderimlerin gözden geçirilebileceği ve bir yinelemede bırakılan açıklamaların gelecekteki yinelemelerde izlendiği anlamına gelir.
targetRefName	string	Çekme isteğinin hedef dalının adı.
title	string	Çekme isteğinin başlığı.
url	string	Dahili olarak kullanılır.
workItemRefs	ResourceRef[]	Bu çekme isteğiyle ilişkili tüm iş öğesi başvuruları.

GitPullRequestCompletionOptions

Object

Çekme isteğinin nasıl tamamlanması gerektiğiyle ilgili tercihler.

Name	Tür	Description
bypassPolicy	boolean	Doğruysa, çekme isteği tamamlanırken ilkeler açıkça atlanır.
bypassReason	string	İlkeler atlanırsa, atlamanın neden kullanıldığıyla ilgili olarak bu neden depolanır.
deleteSourceBranch	boolean	Doğruysa, çekme isteğinin kaynak dalı tamamlandıktan sonra silinir.
mergeCommitMessage	string	Ayarlanırsa, birleştirme işlemesinin işleme iletisi olarak kullanılır.
squashMerge	boolean	True ise, çekme isteğindeki işlemeler tamamlandıktan sonra squash ile belirtilen hedef dalda birleştirilir.
transitionWorkItems	boolean	Doğruysa, çekme isteğine bağlı tüm iş öğelerini bir sonraki mantıksal duruma (örneğin Etkin -> Çözüldü) aktarmayı deneyeceğiz
triggeredByAutoComplete	boolean	Doğruysa, geçerli tamamlama denemesi otomatik tamamlama yoluyla tetiklendi. Dahili olarak kullanılır.

GitPullRequestMergeOptions

Object

Çekme isteği birleştirme oluşturulduğunda kullanılan seçenekler.

Name	Tür	Description
detectRenameFalsePositives	boolean
disableRenames	boolean	True ise, birleştirme sırasında yeniden adlandırma algılama gerçekleştirilmeyecektir.

GitPushRef

Object

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
date	string
pushId	integer
pushedBy	IdentityRef
url	string

GitRepository

Object

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
defaultBranch	string
id	string
isFork	boolean	Depo çatal olarak oluşturulduysa True
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.
remoteUrl	string
size	integer	Deponun sıkıştırılmış boyutu (bayt).
sshUrl	string
url	string
validRemoteUrls	string[]

GitRepositoryRef

Object

Name	Tür	Description
collection	TeamProjectCollectionReference	Bu Çatal'ın bulunduğu Takım Projesi Koleksiyonu
id	string
isFork	boolean	Depo çatal olarak oluşturulduysa True
name	string
project	TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.
remoteUrl	string
sshUrl	string
url	string

GitStatus

Object

Bu sınıf, durum gönderen bir hizmetin/uzantının meta verilerini içerir.

Name	Tür	Description
_links	ReferenceLinks	Başvuru bağlantıları.
context	GitStatusContext	Durumun bağlamı.
createdBy	IdentityRef	Durumu oluşturan kimlik.
creationDate	string	Durumun oluşturulma tarihi ve saati.
description	string	Durum açıklaması. Genellikle durumun geçerli durumunu açıklar.
id	integer	Durum tanımlayıcısı.
state	GitStatusState	Durumun durumu.
targetUrl	string	Durum ayrıntılarını içeren URL.
updatedDate	string	Durumun son güncelleştirme tarihi ve saati.

GitStatusContext

Object

Durumu benzersiz olarak tanımlayan durum bağlamı.

Name	Tür	Description
genre	string	Durumun türü. Genellikle durumu oluşturan hizmetin/aracın adı boş olabilir.
name	string	Durumun ad tanımlayıcısı null veya boş olamaz.

GitStatusState

Enumeration

Durumun durumu.

Değer	Description
error	Hata içeren durum.
failed	Durum başarısız oldu.
notApplicable	Durum hedef nesne için geçerli değil.
notSet	Durum durumu ayarlanmadı. Varsayılan durum.
pending	Durum beklemede.
succeeded	Durum başarılı oldu.

GitTemplate

Object

Name	Tür	Description
name	string	Şablonun Adı
type	string	Şablonun Türü

GitUserDate

Object

Git işlemleri için kullanıcı bilgileri ve tarihi.

Name	Tür	Description
date	string	Git işleminin tarihi.
email	string	Git işlemini gerçekleştiren kullanıcının adresini Email.
imageUrl	string	Kullanıcının avatarı url'si.
name	string	Git işlemini gerçekleştiren kullanıcının adı.

IdentityRef

Object

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
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
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur.

IdentityRefWithVote

Object

Çekme isteğine oy verme dahil olmak üzere kimlik bilgileri.

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusuyla ilgili sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında ek ilişkiler 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
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
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
isRequired	boolean	Bu çekme isteği için gerekli bir gözden geçiren olup olmadığını gösterir. Dallar, çekme istekleri için belirli gözden geçirenlerin gerekli olmasını gerektiren ilkelere sahip olabilir.
profileUrl	string
reviewerUrl	string	Bu kimlikle ilgili bilgileri almak için URL
uniqueName	string
url	string	Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur.
vote	integer	Çekme isteğine oy verin: 10 - onaylandı 5 - önerilerle onaylandı 0 - oy yok -5 - yazar bekleniyor -10 - reddedildi
votedFor	IdentityRefWithVote[]	Bu gözden geçirenin katkıda bulunduğu gruplar veya ekipler. Gruplar ve takımlar çekme isteklerinde gözden geçirenler olabilir, ancak doğrudan oy veremezler. Grubun veya ekibin bir üyesi oy verince, bu oy grup veya takım oyu içine alınır. VotedFor, bu tür oyların listesidir.

ItemContent

Object

Name	Tür	Description
content	string
contentType	ItemContentType

ItemContentType

Enumeration

Değer	Description
base64Encoded
rawText

ProjectState

Enumeration

Proje durumu.

Değer	Description
all	Durumundan bağımsız olarak tüm projeler.
createPending	Proje oluşturma için kuyruğa alındı, ancak işlem henüz başlamadı.
deleted	Proje silindi.
deleting	Project silinme sürecinde.
new	Proje oluşturulma aşamasındadır.
unchanged	Proje değiştirilmedi.
wellFormed	Proje tamamen oluşturulur ve kullanıma hazırdır.

ProjectVisibility

Enumeration

Proje görünürlüğü.

Değer	Description
private	Proje yalnızca açık erişimi olan kullanıcılar tarafından görülebilir.
public	Proje herkes tarafından görülebilir.

PullRequestAsyncStatus

Enumeration

Çekme isteği birleştirmenin geçerli durumu.

Değer	Description
conflicts	Çekme isteği birleştirme çakışmalar nedeniyle başarısız oldu.
failure	Çekme isteği birleştirme başarısız oldu.
notSet	Durum ayarlanmadı. Varsayılan durum.
queued	Çekme isteği birleştirme sıraya alındı.
rejectedByPolicy	Çekme isteği birleştirme ilke tarafından reddedildi.
succeeded	Çekme isteği birleştirme başarılı oldu.

PullRequestMergeFailureType

Enumeration

Çekme isteği birleştirme işleminin hata türü (varsa).

Değer	Description
caseSensitive	Çekme isteği birleştirme, büyük/küçük harf uyuşmazlığı nedeniyle başarısız oldu.
none	Tür ayarlanmadı. Varsayılan tür.
objectTooLarge	Çekme isteği birleştirme işlemi bir nesnenin çok büyük olması nedeniyle başarısız oldu.
unknown	Çekme isteği birleştirme hatası türü bilinmiyor.

PullRequestStatus

Enumeration

Çekme isteğinin durumu.

Değer	Description
abandoned	Çekme isteği bırakıldı.
active	Çekme isteği etkin.
all	Tüm durumları dahil etmek için çekme isteği arama ölçütlerinde kullanılır.
completed	Çekme isteği tamamlandı.
notSet	Durum ayarlanmadı. Varsayılan durum.

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 göstermek istiyoruz.

ResourceRef

Object

Name	Tür	Description
id	string
url	string

TeamProjectCollectionReference

Object

TeamProjectCollection için başvuru nesnesi.

Name	Tür	Description
id	string	Koleksiyon Kimliği.
name	string	Koleksiyon Adı.
url	string	Koleksiyon REST Url'si.

TeamProjectReference

Object

TeamProject'e basit bir başvuru temsil eder.

Name	Tür	Description
abbreviation	string	Proje kısaltması.
defaultTeamImageUrl	string	Varsayılan ekip kimliği görüntüsünün URL'si.
description	string	Projenin açıklaması (varsa).
id	string	Proje tanımlayıcısı.
name	string	Proje adı.
revision	integer	Proje düzeltmesi.
state	ProjectState	Proje durumu.
url	string	Nesnenin tam sürümünün URL'si.
visibility	ProjectVisibility	Proje görünürlüğü.

VersionControlChangeType

Enumeration

Öğede yapılan değişikliğin türü.

Değer	Description
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete

WebApiTagDefinition

Object

Tel üzerinden gönderilen etiket tanımının gösterimi.

Name	Tür	Description
active	boolean	Etiket tanımının etkin olup olmadığı.
id	string	Etiket tanımının kimliği.
name	string	Etiket tanımının adı.
url	string	Etiket Tanımı için kaynak URL'si.