Commits - Get Changes

Usługa:

Git

Wersja interfejsu API:

7.1

Pobieranie zmian dla określonego zatwierdzenia.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
commitId	path	True	string	Identyfikator zatwierdzenia.
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
repositoryId	path	True	string	Identyfikator lub przyjazna nazwa repozytorium. Aby użyć przyjaznej nazwy, należy również określić identyfikator projectId.
project	path		string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
skip	query		integer (int32)	Liczba zmian do pominięcia.
top	query		integer (int32)	Maksymalna liczba zmian do zwrócenia.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	GitCommitChanges	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa	Opis
vso.code	Przyznaje możliwość odczytywania kodu źródłowego i metadanych dotyczących zatwierdzeń, zestawów zmian, gałęzi i innych artefaktów kontroli wersji. Umożliwia również wyszukiwanie kodu i otrzymywanie powiadomień o zdarzeniach kontroli wersji za pośrednictwem punktów zaczepienia usługi.

Przykłady

With changes

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

200

{
  "changeCounts": {
    "Add": 456
  },
  "changes": [
    {
      "item": {
        "gitObjectType": "blob",
        "path": "/MyWebSite/MyWebSite/favicon.ico",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/favicon.ico?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/MyWebSite/fonts",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/fonts?versionType=Commit"
      },
      "changeType": "add"
    }
  ]
}

Definicje

Nazwa	Opis
ChangeCountDictionary
GitChange
GitCommitChanges
GitTemplate
ItemContent
ItemContentType
VersionControlChangeType	Typ zmiany wprowadzonej w elemencie.

ChangeCountDictionary

Objekt

GitChange

Objekt

Nazwa	Typ	Opis
changeId	integer (int32)	Identyfikator zmiany w grupie zmian.
changeType	VersionControlChangeType	Typ zmiany wprowadzonej w elemencie.
item	string (T)	Bieżąca wersja.
newContent	ItemContent	Zawartość elementu po zmianie.
newContentTemplate	GitTemplate	Nowy szablon zawartości do użycia podczas wypychania nowych zmian.
originalPath	string	Oryginalna ścieżka elementu, jeśli różni się od bieżącej ścieżki.
sourceServerItem	string	Ścieżka elementu na serwerze.
url	string	Adres URL pobierania elementu.

GitCommitChanges

Objekt

Nazwa	Typ	Opis
changeCounts	ChangeCountDictionary
changes	GitChange[]

GitTemplate

Objekt

Nazwa	Typ	Opis
name	string	Nazwa szablonu
type	string	Typ szablonu

ItemContent

Objekt

Nazwa	Typ	Opis
content	string
contentType	ItemContentType

ItemContentType

Wyliczanie

Wartość	Opis
base64Encoded
rawText

VersionControlChangeType

Wyliczanie

Typ zmiany wprowadzonej w elemencie.

Wartość	Opis
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete