Commits - Get Push Commits

Referência

Serviço:: Git

Versão da API:: 7.1

Recupere uma lista de confirmações associadas a um push específico.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
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.
pushId	query	True	integer (int32)	A ID do push.
includeLinks	query		boolean	Defina como false para evitar a inclusão de links de URL REST para recursos. O padrão é true.
skip	query		integer (int32)	O número de confirmações a serem ignoradas.
top	query		integer (int32)	O número máximo de confirmações a serem retornadas ("obter as confirmações x superiores").

Respostas

Nome	Tipo	Description
200 OK	GitCommitRef[]	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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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"
        }
      }
    }
  ]
}

Definições

Nome	Description
ChangeCountDictionary
GitChange
GitCommitRef	Fornece propriedades que descrevem uma confirmação do Git e metadados associados.
GitPushRef
GitStatus	Essa classe contém os metadados de um serviço/extensão postando um status.
GitStatusContext	Contexto de status que identifica exclusivamente o status.
GitStatusState	Estado do status.
GitTemplate
GitUserDate	Informações do usuário e data das operações do Git.
IdentityRef
ItemContent
ItemContentType
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ResourceRef
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.

GitCommitRef

Objeto

Fornece propriedades que descrevem uma confirmação do Git e metadados associados.

Nome	Tipo	Description
_links	ReferenceLinks	Uma coleção de links de referência REST relacionados.
author	GitUserDate	Autor da confirmação.
changeCounts	ChangeCountDictionary	Contagens dos tipos de alterações (edições, exclusões etc.) incluídas na confirmação.
changes	GitChange[]	Uma enumeração das alterações incluídas na confirmação.
comment	string	Comentário ou mensagem da confirmação.
commentTruncated	boolean	Indica se o comentário é truncado da mensagem de comentário de confirmação completa do Git.
commitId	string	ID (SHA-1) da confirmação.
commitTooManyChanges	boolean	Indica que a confirmação contém muitas alterações a serem exibidas
committer	GitUserDate	Committer da confirmação.
parents	string[]	Uma enumeração das IDs de confirmação pai para essa confirmação.
push	GitPushRef	O push associado a essa confirmação.
remoteUrl	string	Caminho de URL remoto para a confirmação.
statuses	GitStatus[]	Uma lista de metadados de status de serviços e extensões que podem associar informações adicionais à confirmação.
url	string	URL REST para esse recurso.
workItems	ResourceRef[]	Uma lista de workitems associados a essa confirmação.

GitPushRef

Objeto

Nome	Tipo	Description
_links	ReferenceLinks	A classe para representar uma coleção de links de referência REST.
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
url	string

GitStatus

Objeto

Essa classe contém os metadados de um serviço/extensão postando um status.

Nome	Tipo	Description
_links	ReferenceLinks	Links de referência.
context	GitStatusContext	Contexto do status.
createdBy	IdentityRef	Identidade que criou o status.
creationDate	string (date-time)	Data e hora de criação do status.
description	string	Descrição do status. Normalmente descreve o estado atual do status.
id	integer (int32)	Identificador de status.
state	GitStatusState	Estado do status.
targetUrl	string	URL com detalhes de status.
updatedDate	string (date-time)	Data e hora da última atualização do status.

GitStatusContext

Objeto

Contexto de status que identifica exclusivamente o status.

Nome	Tipo	Description
genre	string	Gênero do status. Normalmente, o nome do serviço/ferramenta que gera o status pode estar vazio.
name	string	O identificador de nome do status não pode ser nulo ou vazio.

GitStatusState

Enumeração

Estado do status.

Valor	Description
error	Status com um erro.
failed	Falha no status.
notApplicable	O status não é aplicável ao objeto de destino.
notSet	Estado de status não definido. Estado padrão.
pending	Status pendente.
succeeded	Status bem-sucedido.

GitTemplate

Objeto

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

GitUserDate

Objeto

Informações do usuário e data das operações do Git.

Nome	Tipo	Description
date	string (date-time)	Data da operação git.
email	string	Endereço de email do usuário que está executando a operação Git.
imageUrl	string	Url para o avatar do usuário.
name	string	Nome do usuário que está executando a operação Git.

IdentityRef

Objeto

Nome	Tipo	Description
_links	ReferenceLinks	Este campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo em contas e organizações.
directoryAlias	string	Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef
displayName	string	Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string	Preterido – Disponível na entrada "avatar" do dicionário "_links" do IdentityRef
inactive	boolean	Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser
isAadIdentity	boolean	Preterido – pode ser adiado do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Preterido - não em uso na maioria das implementações pré-existentes de ToIdentityRef
uniqueName	string	Preterido – use Domain+PrincipalName em vez disso
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

ItemContent

Objeto

Nome	Tipo	Description
content	string
contentType	ItemContentType

ItemContentType

Enumeração

Valor	Description
base64Encoded
rawText

ReferenceLinks

Objeto

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

ResourceRef

Objeto

Nome	Tipo	Description
id	string
url	string

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

Compartilhar via

Commits - Get Push Commits

Parâmetros de URI

Respostas

Segurança

oauth2

Escopos

Exemplos

Solicitação de exemplo

Resposta de exemplo

Definições

ChangeCountDictionary

GitChange

GitCommitRef

GitPushRef

GitStatus

GitStatusContext

GitStatusState

GitTemplate

GitUserDate

IdentityRef

ItemContent

ItemContentType

ReferenceLinks

ResourceRef

VersionControlChangeType