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	提交的 ID。
organization	path	True	string	Azure DevOps 组织的名称。
repositoryId	path	True	string	存储库的 ID 或友好名称。 若要使用友好名称，还必须指定 projectId。
project	path		string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。
skip	query		integer (int32)	要跳过的更改数。
top	query		integer (int32)	要返回的最大更改数。

响应

名称	类型	说明
200 OK	GitCommitChanges	成功作

安全性

oauth2

类型: oauth2
流向: 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)	更改组中更改的 ID。
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