Aracılığıyla paylaş


Commits - Get Push Commits

Belirli bir gönderimle ilişkili işlemelerin listesini alın.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commits?pushId={pushId}&api-version=7.1
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commits?pushId={pushId}&top={top}&skip={skip}&includeLinks={includeLinks}&api-version=7.1

URI Parametreleri

Name İçinde Gerekli Tür Description
organization
path True

string

Azure DevOps kuruluşunun adı.

repositoryId
path True

string

Deponun kimliği veya kolay adı. Kolay adı kullanmak için projectId de belirtilmelidir.

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 '7.1' olarak ayarlanmalıdır.

pushId
query True

integer (int32)

Göndermenin kimliği.

includeLinks
query

boolean

Kaynakların REST Url bağlantılarını eklemekten kaçınmak için false olarak ayarlayın. Varsayılan değer true'dır.

skip
query

integer (int32)

Atlana işleme sayısı.

top
query

integer (int32)

Döndürülecek işleme sayısı üst sınırı ("ilk x işlemeyi al").

Yanıtlar

Name Tür Description
200 OK

GitCommitRef[]

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

Örnekler

Örnek isteği

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

Örnek yanıt

{
  "count": 1,
  "value": [
    {
      "commitId": "be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4",
      "author": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-01-29T23:32:09Z"
      },
      "committer": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-01-29T23:32:09Z"
      },
      "comment": "First cut",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4",
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4"
        },
        "repository": {
          "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249"
        },
        "web": {
          "href": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4"
        },
        "changes": {
          "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4/changes"
        }
      }
    }
  ]
}

Tanımlar

Name Description
ChangeCountDictionary
GitChange
GitCommitRef

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

GitPushRef
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
ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

ResourceRef
VersionControlChangeType

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

ChangeCountDictionary

GitChange

Name Tür Description
changeId

integer (int32)

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 (T)

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ının koleksiyonu.

author

GitUserDate

İşlemenin yazarı.

changeCounts

ChangeCountDictionary

İşlemeye dahil edilen değişiklik türlerinin (düzenlemeler, silmeler vb.) sayısı.

changes

GitChange[]

İşlemeye dahil edilen değişikliklerin numaralandırması.

comment

string

İşlemenin açıklaması veya iletisi.

commentTruncated

boolean

Açıklamanın tam Git işleme açıklaması iletisinden kesilip kesilmediğini gösterir.

commitId

string

İşlemenin kimliği (SHA-1).

commitTooManyChanges

boolean

İşlemenin görüntülenecek çok fazla değişiklik içerdiğini gösterir

committer

GitUserDate

İşlemenin işleyicisi.

parents

string[]

Bu işleme için üst işleme kimliklerinin numaralandırması.

push

GitPushRef

Bu işlemeyle ilişkili gönderim.

remoteUrl

string

İşlemenin uzak URL yolu.

statuses

GitStatus[]

İşlemeyle ek bilgileri 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.

GitPushRef

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

date

string (date-time)

pushId

integer (int32)

pushedBy

IdentityRef

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 (date-time)

Durumun oluşturulma tarihi ve saati.

description

string

Durum açıklaması. Genellikle durumun geçerli durumunu açıklar.

id

integer (int32)

Durum tanımlayıcısı.

state

GitStatusState

Durumun durumu.

targetUrl

string

Durum ayrıntılarını içeren URL.

updatedDate

string (date-time)

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.

Değer Description
error

Hata içeren durum.

failed

Durum başarısız oldu.

notApplicable

Durum hedef nesne için geçerli değildir.

notSet

Durum durumu ayarlanmadı. Varsayılan durum.

pending

Durum bekleniyor.

succeeded

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 (date-time)

Git işleminin tarihi.

email

string

Git işlemini gerçekleştiren kullanıcının e-posta adresi.

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 ilginç 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üğündeki "membershipState" girdisinde 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 (Tanımlayıcı.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

Değer Description
base64Encoded
rawText

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 kullanıma açmak istiyoruz.

ResourceRef

Name Tür Description
id

string

url

string

VersionControlChangeType

Öğ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