Commits - Get Push Commits

Reference

Service:: Git

API Version:: 5.0

Načte seznam potvrzení přidružených k určitému nabízenému oznámení.

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

With optional parameters:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
repositoryId	path	True	string	ID nebo popisný název úložiště. Pokud chcete použít popisný název, musí být zadáno také projectId.
project	path		string	ID projektu nebo název projektu
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavena na hodnotu 5.0.
pushId	query	True	integer int32	ID nasdílení změn.
includeLinks	query		boolean	Nastavte na hodnotu false, abyste se vyhnuli zahrnutí odkazů REST Url pro prostředky. Výchozí hodnota je true.
skip	query		integer int32	Počet potvrzení, která se mají přeskočit.
top	query		integer int32	Maximální počet potvrzení, která se mají vrátit ("get the top x commits").

Odpovědi

Name	Typ	Description
200 OK	GitCommitRef[]	úspěšná operace

Zabezpečení

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	Umožňuje číst zdrojový kód a metadata o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Umožňuje také prohledávat kód a dostávat oznámení o událostech správy verzí prostřednictvím služby Hooks.

Příklady

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "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"
        }
      }
    }
  ]
}

Definice

Name	Description
ChangeCountDictionary
GitChange
GitCommitRef	Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata.
GitPushRef
GitStatus	Tato třída obsahuje metadata služby nebo rozšíření, které publikuje stav.
GitStatusContext	Kontext stavu, který jednoznačně identifikuje stav.
GitStatusState	Stav stavu.
GitTemplate
GitUserDate	Informace o uživateli a datum pro operace Gitu
IdentityRef
ItemContent
ItemContentType
ReferenceLinks	Třída představující kolekci odkazů REST.
ResourceRef
VersionControlChangeType	Typ změny, která byla provedena u položky.

ChangeCountDictionary

GitChange

Name	Typ	Description
changeId	integer	ID změny v rámci skupiny změn
changeType	VersionControlChangeType	Typ změny, která byla provedena u položky.
item	string	Aktuální verze.
newContent	ItemContent	Obsah položky po změně.
newContentTemplate	GitTemplate	Nová šablona obsahu, která se má použít při vkládání nových změn.
originalPath	string	Původní cesta k položce, pokud se liší od aktuální cesty.
sourceServerItem	string	Cesta k položce na serveru.
url	string	Adresa URL pro načtení položky

GitCommitRef

Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata.

Name	Typ	Description
_links	ReferenceLinks	Kolekce souvisejících odkazů rest.
author	GitUserDate	Autor potvrzení.
changeCounts	ChangeCountDictionary	Počítá typy změn (úpravy, odstranění atd.), které jsou součástí potvrzení.
changes	GitChange[]	Výčet změn zahrnutých v potvrzení.
comment	string	Komentář nebo zpráva potvrzení
commentTruncated	boolean	Označuje, jestli je komentář zkrácený od úplné zprávy o potvrzení Gitu.
commitId	string	ID (SHA-1) potvrzení.
committer	GitUserDate	Committer potvrzení.
parents	string[]	Výčet ID nadřazeného potvrzení pro toto potvrzení.
push	GitPushRef	Nabízené oznámení přidružené k tomuto potvrzení.
remoteUrl	string	Vzdálená cesta URL k potvrzení.
statuses	GitStatus[]	Seznam metadat stavu ze služeb a rozšíření, která můžou k potvrzení přidružit další informace.
url	string	Adresa URL REST pro tento prostředek.
workItems	ResourceRef[]	Seznam pracovních položek přidružených k tomuto potvrzení.

GitPushRef

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
date	string
pushId	integer
pushedBy	IdentityRef
url	string

GitStatus

Tato třída obsahuje metadata služby nebo rozšíření, které publikuje stav.

Name	Typ	Description
_links	ReferenceLinks	Odkazy.
context	GitStatusContext	Kontext stavu.
createdBy	IdentityRef	Identita, která vytvořila stav.
creationDate	string	Datum a čas vytvoření stavu.
description	string	Popis stavu. Obvykle popisuje aktuální stav stavu.
id	integer	Identifikátor stavu.
state	GitStatusState	Stav stavu.
targetUrl	string	Adresa URL s podrobnostmi o stavu
updatedDate	string	Datum a čas poslední aktualizace stavu.

GitStatusContext

Kontext stavu, který jednoznačně identifikuje stav.

Name	Typ	Description
genre	string	Žánr stavu. Název služby nebo nástroje, který generuje stav, může být obvykle prázdný.
name	string	Identifikátor názvu stavu nesmí být null nebo prázdný.

GitStatusState

Stav stavu.

Name	Typ	Description
error	string	Stav s chybou.
failed	string	Stav selhal.
notApplicable	string	Stav se nevztahuje na cílový objekt.
notSet	string	Stav není nastavený. Výchozí stav.
pending	string	Stav čeká na vyřízení.
succeeded	string	Stav byl úspěšný.

GitTemplate

Name	Typ	Description
name	string	Název šablony
type	string	Typ šablony

GitUserDate

Informace o uživateli a datum pro operace Gitu

Name	Typ	Description
date	string	Datum operace Git.
email	string	Email adresu uživatele provádějícího operaci Git.
imageUrl	string	Adresa URL avatara uživatele
name	string	Jméno uživatele, který provádí operaci Git.

IdentityRef

Name	Typ	Description
_links	ReferenceLinks	Toto pole obsahuje nula nebo více zajímavých odkazů o předmětu grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto předmětu grafu.
descriptor	string	Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu napříč účty i organizacemi.
directoryAlias	string
displayName	string	Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Tato adresa URL je úplná trasa ke zdrojovému prostředku tohoto předmětu grafu.

ItemContent

Name	Typ	Description
content	string
contentType	ItemContentType

ItemContentType

Name	Typ	Description
base64Encoded	string
rawText	string

ReferenceLinks

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako jen pro čtení.

ResourceRef

Name	Typ	Description
id	string
url	string

VersionControlChangeType

Typ změny, která byla provedena u položky.

Name	Typ	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

Sdílet prostřednictvím