Commits - Get

Başvuru

Service:: Git

API Version:: 7.1-preview.1

Belirli bir işlemeyi alma.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commits/{commitId}?api-version=7.1-preview.1

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commits/{commitId}?changeCount={changeCount}&api-version=7.1-preview.1

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
commitId	path	True	string	İşlemenin kimliği.
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-preview.1' olarak ayarlanmalıdır.
changeCount	query		integer int32	Sonuda eklenecek değişikliklerin sayısı.

Yanıtlar

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

Örnekler

Get by ID

With limited changes

Get by ID

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "parents": [],
  "treeId": "7fa1a3523ffef51c525ea476bffff7d648b8cb3d",
  "push": {
    "pushedBy": {
      "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"
    },
    "pushId": 1,
    "date": "2014-01-29T23:33:15.2434002Z"
  },
  "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\n",
  "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"
    },
    "changes": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4/changes"
    },
    "web": {
      "href": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4"
    },
    "tree": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/trees/7fa1a3523ffef51c525ea476bffff7d648b8cb3d"
    }
  }
}

With limited changes

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "parents": [],
  "treeId": "7fa1a3523ffef51c525ea476bffff7d648b8cb3d",
  "push": {
    "pushedBy": {
      "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"
    },
    "pushId": 1,
    "date": "2014-01-29T23:33:15.2434002Z"
  },
  "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\n",
  "changeCounts": {
    "Add": 456
  },
  "changes": [
    {
      "item": {
        "gitObjectType": "blob",
        "path": "/.gitattributes",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/.gitattributes?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "blob",
        "path": "/.gitignore",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/.gitignore?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/MyWebSite",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "blob",
        "path": "/MyWebSite/MyWebSite.sln",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite.sln?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/packages",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/packages?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/MyWebSite/App_Start",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/App_Start?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/MyWebSite/Areas",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/Areas?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/MyWebSite/Content",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/Content?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/MyWebSite/Controllers",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/Controllers?versionType=Commit"
      },
      "changeType": "add"
    }
  ],
  "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"
    },
    "changes": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4/changes"
    },
    "web": {
      "href": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4"
    },
    "tree": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/trees/7fa1a3523ffef51c525ea476bffff7d648b8cb3d"
    }
  }
}

Tanımlar

Name	Description
ChangeCountDictionary
GitChange
GitCommit
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 tarihi.
IdentityRef
ItemContent
ItemContentType
ReferenceLinks	REST başvuru bağlantılarının 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	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.

GitCommit

Name	Tür	Description
_links	ReferenceLinks	İlgili REST başvuru bağlantıları 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 bir 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ülenemeyecek kadar çok değişiklik içerdiğini gösterir
committer	GitUserDate	İşlemenin commit'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 hizmetlerden ve uzantılardan gelen durum meta verilerinin listesi.
treeId	string
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ının koleksiyonunu temsil eden sınıf.
date	string
pushId	integer
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	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 beklemede.
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 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

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	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üğündeki "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 (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

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.

ResourceRef

Name	Tür	Description
id	string
url	string

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ş

Commits - Get

URI Parametreleri

Yanıtlar

Güvenlik

oauth2

Scopes

Örnekler

Get by ID

Sample Request

Sample Response

With limited changes

Sample Request

Sample Response

Tanımlar

ChangeCountDictionary

GitChange

GitCommit

GitPushRef

GitStatus

GitStatusContext

GitStatusState

GitTemplate

GitUserDate

IdentityRef

ItemContent

ItemContentType

ReferenceLinks

ResourceRef

VersionControlChangeType

Ek kaynaklar