Pushes - Get

Başvuru

Service:: Git

API Version:: 7.1-preview.2

Belirli bir gönderimi alır.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes/{pushId}?api-version=7.1-preview.2

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes/{pushId}?includeCommits={includeCommits}&includeRefUpdates={includeRefUpdates}&api-version=7.1-preview.2

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
pushId	path	True	integer int32	Gönderimin kimliği.
repositoryId	path	True	string	Deponun adı veya kimliği.
project	path		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.2' olarak ayarlanmalıdır.
includeCommits	query		integer int32	Sonuda eklenecek işleme sayısı.
includeRefUpdates	query		boolean	True ise, gönderim tarafından güncelleştirilen refs listesini ekleyin.

Yanıtlar

Name	Tür	Description
200 OK	GitPush	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.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 hizmet kancaları aracılığıyla kod arama ve sürüm denetimi olayları hakkında bildirim alma olanağı sağlar.

Örnekler

Just the push

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23?api-version=7.1-preview.2

Sample Response

Status code:: 200

{
  "commits": [],
  "pushedBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
  },
  "pushId": 23,
  "date": "2014-06-30T18:11:18.0929091Z",
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249"
    },
    "commits": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23/commits"
    },
    "pusher": {
      "href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  }
}

Tanımlar

Name	Description
ChangeCountDictionary
GitChange
GitCommitRef	Git işleme ve ilişkili meta verileri açıklayan özellikler sağlar.
GitPush
GitPushRef
GitRefUpdate
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 tarih.
IdentityRef
ItemContent
ItemContentType
ProjectState	Proje durumu.
ProjectVisibility	Proje görünürlüğü.
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ü.

ChangeCountDictionary

GitChange

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

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).
commitTooManyChanges	boolean	İşlemenin görüntülenemeyecek kadar çok değişiklik içerdiğini gösterir
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.

GitPush

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
commits	GitCommitRef[]	Git işleme ve ilişkili meta verileri açıklayan özellikler sağlar.
date	string
pushId	integer
pushedBy	IdentityRef
refUpdates	GitRefUpdate[]
repository	GitRepository
url	string

GitPushRef

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

GitRefUpdate

Name	Tür	Description
isLocked	boolean
name	string
newObjectId	string
oldObjectId	string
repositoryId	string

GitRepository

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
defaultBranch	string
id	string
isDisabled	boolean	Depo devre dışı bırakılırsa true. Aksi durumda false.
isFork	boolean	Depo çatal olarak oluşturulduysa true.
isInMaintenance	boolean	Depo bakımdaysa true. Aksi durumda false.
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[]
webUrl	string

GitRepositoryRef

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

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

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

Durumun durumu.

Name	Tür	Description
error	string	Hata içeren durum.
failed	string	Durum başarısız oldu.
notApplicable	string	Durum hedef nesne için geçerli değil.
notSet	string	Durum durumu ayarlanmadı. Varsayılan durum.
pending	string	Durum bekleniyor.
succeeded	string	Durum başarılı oldu.

GitTemplate

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

GitUserDate

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

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

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.

ItemContent

Name	Tür	Description
content	string
contentType	ItemContentType

ItemContentType

Name	Tür	Description
base64Encoded	string
rawText	string

ProjectState

Proje durumu.

Name	Tür	Description
all	string	Durumu ne olursa olsun, Silinmiş dışındaki tüm projeler.
createPending	string	Project oluşturma için kuyruğa alındı, ancak işlem henüz başlamadı.
deleted	string	Proje silindi.
deleting	string	Project silinme aşamasında.
new	string	Project oluşturulma aşamasındadır.
unchanged	string	Proje değiştirilmedi.
wellFormed	string	Proje tamamen oluşturuldu ve kullanıma hazır.

ProjectVisibility

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

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

ReferenceLinks

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

Name	Tür	Description
id	string
url	string

TeamProjectCollectionReference

TeamProjectCollection için başvuru nesnesi.

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

TeamProjectReference

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ı.
lastUpdateTime	string	Proje son güncelleştirme zamanı.
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

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

Name	Tür	Description
add	string
all	string
branch	string
delete	string
edit	string
encoding	string
lock	string
merge	string
none	string
property	string
rename	string
rollback	string
sourceRename	string
targetRename	string
undelete	string

Aracılığıyla paylaş