Commits - Get Changes

Служба:

Git

Версия API:

7.1

Получение изменений для конкретной фиксации.

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
commitId	path	True	string	Идентификатор фиксации.
organization	path	True	string	Имя организации Azure DevOps.
repositoryId	path	True	string	Идентификатор или понятное имя репозитория. Чтобы использовать понятное имя, необходимо также указать projectId.
project	path		string	Идентификатор проекта или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение "7.1".
skip	query		integer (int32)	Количество пропускаемых изменений.
top	query		integer (int32)	Максимальное количество возвращаемых изменений.

Ответы

Имя	Тип	Описание
200 OK	GitCommitChanges	успешная операция

Безопасность

oauth2

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
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

Области

Имя	Описание
vso.code	Предоставляет возможность читать исходный код и метаданные о фиксациях, изменениях, ветвях и других артефактах управления версиями. Кроме того, предоставляет возможность искать код и получать уведомления о событиях управления версиями с помощью перехватчиков служб.

Примеры

With changes

Образец запроса

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

Пример ответа

Код состояния:

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

Определения

Имя	Описание
ChangeCountDictionary
GitChange
GitCommitChanges
GitTemplate
ItemContent
ItemContentType
VersionControlChangeType	Тип изменений, внесенных в элемент.

ChangeCountDictionary

Object

GitChange

Object

Имя	Тип	Описание
changeId	integer (int32)	Идентификатор изменения в группе изменений.
changeType	VersionControlChangeType	Тип изменений, внесенных в элемент.
item	string (T)	Текущая версия.
newContent	ItemContent	Содержимое элемента после изменения.
newContentTemplate	GitTemplate	Новый шаблон контента, используемый при отправке новых изменений.
originalPath	string	Исходный путь элемента, если отличается от текущего пути.
sourceServerItem	string	Путь к элементу на сервере.
url	string	URL-адрес для получения элемента.

GitCommitChanges

Object

Имя	Тип	Описание
changeCounts	ChangeCountDictionary
changes	GitChange[]

GitTemplate

Object

Имя	Тип	Описание
name	string	Имя шаблона
type	string	Тип шаблона

ItemContent

Object

Имя	Тип	Описание
content	string
contentType	ItemContentType

ItemContentType

Перечисление

Значение	Описание
base64Encoded
rawText

VersionControlChangeType

Перечисление

Тип изменений, внесенных в элемент.

Значение	Описание
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete