Pushes - Get

Referência

Serviço:: Git

Versão da API:: 5.0

Recupera um push específico.

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

Com parâmetros opcionais:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes/{pushId}?includeCommits={includeCommits}&includeRefUpdates={includeRefUpdates}&api-version=5.0

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
pushId	path	True	integer int32	ID do push.
repositoryId	path	True	string	O nome ou a ID do repositório.
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 '5.0' para usar esta versão da API.
includeCommits	query		integer int32	O número de commits a serem incluídos no resultado.
includeRefUpdates	query		boolean	Se for true, inclua a lista de refs que foram atualizados pelo push.

Respostas

Nome	Tipo	Description
200 OK	GitPush	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 os 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

Just the push

Solicitação de exemplo

HTTP

GET https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23?api-version=5.0

Resposta de exemplo

Código de status:: 200

{
  "commits": [],
  "pushedBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
  },
  "pushId": 23,
  "date": "2014-06-30T18:11:18.0929091Z",
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249"
    },
    "commits": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23/commits"
    },
    "pusher": {
      "href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  }
}

Definições

Nome	Description
ChangeCountDictionary
GitChange
GitCommitRef	Fornece propriedades que descrevem uma confirmação do Git e metadados associados.
GitPush
GitPushRef
GitRefUpdate
GitRepository
GitRepositoryRef
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
ProjectState	Estado do projeto.
ProjectVisibility	Visibilidade do projeto.
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ResourceRef
TeamProjectCollectionReference	Objeto de referência para um TeamProjectCollection.
TeamProjectReference	Representa uma referência superficial a um TeamProject.
VersionControlChangeType	O tipo de alteração feita no item.

ChangeCountDictionary

Object

GitChange

Object

Nome	Tipo	Description
changeId	integer	ID da alteração dentro do grupo de alterações.
changeType	VersionControlChangeType	O tipo de alteração feita no item.
item	string	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 por push novas alterações.
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

Object

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 do commit.
changeCounts	ChangeCountDictionary	Contagens dos tipos de alterações (edições, exclusões etc.) incluídas no commit.
changes	GitChange[]	Uma enumeração das alterações incluídas no commit.
comment	string	Comentário ou mensagem do commit.
commentTruncated	boolean	Indica se o comentário está truncado da mensagem de comentário de confirmação completa do Git.
commitId	string	ID (SHA-1) do commit.
committer	GitUserDate	Committer do commit.
parents	string[]	Uma enumeração das IDs de commit pai para esse commit.
push	GitPushRef	O push associado a este commit.
remoteUrl	string	Caminho da URL remota para a confirmação.
statuses	GitStatus[]	Uma lista de metadados status de serviços e extensões que podem associar informações adicionais ao commit.
url	string	URL REST para esse recurso.
workItems	ResourceRef[]	Uma lista de workitems associados a essa confirmação.

GitPush

Object

Nome	Tipo	Description
_links	ReferenceLinks	A classe para representar uma coleção de links de referência REST.
commits	GitCommitRef[]	Fornece propriedades que descrevem uma confirmação do Git e metadados associados.
date	string
pushId	integer
pushedBy	IdentityRef
refUpdates	GitRefUpdate[]
repository	GitRepository
url	string

GitPushRef

Object

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

GitRefUpdate

Object

Nome	Tipo	Description
isLocked	boolean
name	string
newObjectId	string
oldObjectId	string
repositoryId	string

GitRepository

Object

Nome	Tipo	Description
_links	ReferenceLinks	A classe para representar uma coleção de links de referência REST.
defaultBranch	string
id	string
isFork	boolean	True se o repositório foi criado como um fork
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Representa uma referência superficial a um TeamProject.
remoteUrl	string
size	integer	Tamanho compactado (bytes) do repositório.
sshUrl	string
url	string
validRemoteUrls	string[]

GitRepositoryRef

Object

Nome	Tipo	Description
collection	TeamProjectCollectionReference	Coleção de Projetos de Equipe em que esse Fork reside
id	string
isFork	boolean	True se o repositório foi criado como um fork
name	string
project	TeamProjectReference	Representa uma referência superficial a um TeamProject.
remoteUrl	string
sshUrl	string
url	string

GitStatus

Object

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	Data e hora de criação do status.
description	string	Descrição do status. Normalmente descreve o estado atual do status.
id	integer	Identificador de status.
state	GitStatusState	Estado do status.
targetUrl	string	URL com status detalhes.
updatedDate	string	Data e hora da última atualização do status.

GitStatusContext

Object

Contexto de status que identifica exclusivamente o status.

Nome	Tipo	Description
genre	string	Gênero da 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

Enumeration

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

Object

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

GitUserDate

Object

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

Nome	Tipo	Description
date	string	Data da operação git.
email	string	Email endereço 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

Object

Nome	Tipo	Description
_links	ReferenceLinks	Esse 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 do grafo entre contas e organizações.
directoryAlias	string
displayName	string	Este é 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
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

ItemContent

Object

Nome	Tipo	Description
content	string
contentType	ItemContentType

ItemContentType

Enumeration

Valor	Description
base64Encoded
rawText

ProjectState

Enumeration

Estado do projeto.

Valor	Description
all	Todos os projetos, independentemente do estado.
createPending	O projeto foi enfileirado para criação, mas o processo ainda não foi iniciado.
deleted	O projeto foi excluído.
deleting	O Project está em processo de exclusão.
new	O projeto está em processo de criação.
unchanged	O projeto não foi alterado.
wellFormed	O project é completamente criado e pronto para uso.

ProjectVisibility

Enumeration

Visibilidade do projeto.

Valor	Description
private	O projeto só é visível para usuários com acesso explícito.
public	O projeto é visível para todos.

ReferenceLinks

Object

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

Object

Nome	Tipo	Description
id	string
url	string

TeamProjectCollectionReference

Object

Objeto de referência para um TeamProjectCollection.

Nome	Tipo	Description
id	string	ID da coleção.
name	string	Nome da Coleção.
url	string	URL REST da coleção.

TeamProjectReference

Object

Representa uma referência superficial a um TeamProject.

Nome	Tipo	Description
abbreviation	string	Abreviação do projeto.
defaultTeamImageUrl	string	Url para a imagem de identidade de equipe padrão.
description	string	A descrição do projeto (se houver).
id	string	Identificador do projeto.
name	string	Nome do projeto.
revision	integer	Revisão do projeto.
state	ProjectState	Estado do projeto.
url	string	URL para a versão completa do objeto.
visibility	ProjectVisibility	Visibilidade do projeto.

VersionControlChangeType

Enumeration

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

Pushes - Get

Parâmetros de URI

Respostas

Segurança

oauth2

Escopos

Exemplos

Just the push

Solicitação de exemplo

Resposta de exemplo

Definições

ChangeCountDictionary

GitChange

GitCommitRef

GitPush

GitPushRef

GitRefUpdate

GitRepository

GitRepositoryRef

GitStatus

GitStatusContext

GitStatusState

GitTemplate

GitUserDate

IdentityRef

ItemContent

ItemContentType

ProjectState

ProjectVisibility

ReferenceLinks

ResourceRef

TeamProjectCollectionReference

TeamProjectReference

VersionControlChangeType