Commits - Get Changes

Serviço:

Git

Versão da API:

7.1

Recuperar alterações para uma confirmação específica.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
commitId	path	True	string	A ID da confirmação.
organization	path	True	string	O nome da organização do Azure DevOps.
repositoryId	path	True	string	A ID ou o nome amigável do repositório. Para usar o nome amigável, projectId também deve ser especificado.
project	path		string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.
skip	query		integer (int32)	O número de alterações a serem ignoradas.
top	query		integer (int32)	O número máximo de alterações a serem retornadas.

Respostas

Nome	Tipo	Description
200 OK	GitCommitChanges	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

Nome	Description
vso.code	Concede a capacidade de ler o código-fonte e metadados sobre commits, conjuntos de alterações, branches e outros artefatos de controle de versão. Também concede a capacidade de pesquisar código e ser notificado sobre eventos de controle de versão por meio de ganchos de serviço.

Exemplos

With changes

Solicitação de exemplo

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

Resposta de exemplo

Código de status:

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

Definições

Nome	Description
ChangeCountDictionary
GitChange
GitCommitChanges
GitTemplate
ItemContent
ItemContentType
VersionControlChangeType	O tipo de alteração feita no item.

ChangeCountDictionary

Objeto

GitChange

Objeto

Nome	Tipo	Description
changeId	integer (int32)	ID da alteração no grupo de alterações.
changeType	VersionControlChangeType	O tipo de alteração feita no item.
item	string (T)	Versão atual.
newContent	ItemContent	Conteúdo do item após a alteração.
newContentTemplate	GitTemplate	Novo modelo de conteúdo a ser usado ao enviar novas alterações por push.
originalPath	string	Caminho original do item, se diferente do caminho atual.
sourceServerItem	string	Caminho do item no servidor.
url	string	URL para recuperar o item.

GitCommitChanges

Objeto

Nome	Tipo	Description
changeCounts	ChangeCountDictionary
changes	GitChange[]

GitTemplate

Objeto

Nome	Tipo	Description
name	string	Nome do modelo
type	string	Tipo do modelo

ItemContent

Objeto

Nome	Tipo	Description
content	string
contentType	ItemContentType

ItemContentType

Enumeração

Valor	Description
base64Encoded
rawText

VersionControlChangeType

Enumeração

O tipo de alteração feita no item.

Valor	Description
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete