Pushes - Get

Service:

Git

API Version:

7.1-preview.2

Recupera una inserción determinada.

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

With optional parameters:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
pushId	path	True	integer int32	Identificador de la inserción.
repositoryId	path	True	string	Nombre o identificador del repositorio.
project	path		string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1-preview.2" para usar esta versión de la API.
includeCommits	query		integer int32	Número de confirmaciones que se van a incluir en el resultado.
includeRefUpdates	query		boolean	Si es true, incluya la lista de referencias actualizadas por la inserción.

Respuestas

Nombre	Tipo	Description
200 OK	GitPush	operación correcta

Seguridad

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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

Scopes

Nombre	Description
vso.code	Concede la capacidad de leer código fuente y metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de buscar código y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Ejemplos

Just the push

Sample Request

HTTP

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

Sample Response

Status code:

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

Definiciones

Nombre	Description
ChangeCountDictionary
GitChange
GitCommitRef	Proporciona propiedades que describen una confirmación de Git y los metadatos asociados.
GitPush
GitPushRef
GitRefUpdate
GitRepository
GitRepositoryRef
GitStatus	Esta clase contiene los metadatos de un servicio o extensión que publica un estado.
GitStatusContext	Contexto de estado que identifica de forma única el estado.
GitStatusState	Estado del estado.
GitTemplate
GitUserDate	Información de usuario y fecha para las operaciones de Git.
IdentityRef
ItemContent
ItemContentType
ProjectState	Estado del proyecto.
ProjectVisibility	Visibilidad del proyecto.
ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
ResourceRef
TeamProjectCollectionReference	Objeto reference de teamProjectCollection.
TeamProjectReference	Representa una referencia superficial a un TeamProject.
VersionControlChangeType	Tipo de cambio realizado en el elemento.

ChangeCountDictionary

GitChange

Nombre	Tipo	Description
changeId	integer	Identificador del cambio dentro del grupo de cambios.
changeType	VersionControlChangeType	Tipo de cambio realizado en el elemento.
item	string	Versión actual.
newContent	ItemContent	Contenido del elemento después del cambio.
newContentTemplate	GitTemplate	Nueva plantilla de contenido que se usará al insertar nuevos cambios.
originalPath	string	Ruta de acceso original del elemento si es diferente de la ruta de acceso actual.
sourceServerItem	string	Ruta de acceso del elemento en el servidor.
url	string	Dirección URL para recuperar el elemento.

GitCommitRef

Proporciona propiedades que describen una confirmación de Git y los metadatos asociados.

Nombre	Tipo	Description
_links	ReferenceLinks	Colección de vínculos de referencia de REST relacionados.
author	GitUserDate	Autor de la confirmación.
changeCounts	ChangeCountDictionary	Recuentos de los tipos de cambios (ediciones, eliminaciones, etc.) incluidos con la confirmación.
changes	GitChange[]	Enumeración de los cambios incluidos con la confirmación.
comment	string	Comentario o mensaje de la confirmación.
commentTruncated	boolean	Indica si el comentario se trunca desde el mensaje completo del comentario de confirmación de Git.
commitId	string	Id. (SHA-1) de la confirmación.
commitTooManyChanges	boolean	Indica que la confirmación contiene demasiados cambios que se van a mostrar.
committer	GitUserDate	Committer de la confirmación.
parents	string[]	Enumeración de los identificadores de confirmación primarios para esta confirmación.
push	GitPushRef	Inserción asociada a esta confirmación.
remoteUrl	string	Ruta de acceso de dirección URL remota a la confirmación.
statuses	GitStatus[]	Lista de metadatos de estado de servicios y extensiones que pueden asociar información adicional a la confirmación.
url	string	Dirección URL de REST para este recurso.
workItems	ResourceRef[]	Lista de elementos de trabajo asociados a esta confirmación.

GitPush

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
commits	GitCommitRef[]	Proporciona propiedades que describen una confirmación de Git y los metadatos asociados.
date	string
pushId	integer
pushedBy	IdentityRef
refUpdates	GitRefUpdate[]
repository	GitRepository
url	string

GitPushRef

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
date	string
pushId	integer
pushedBy	IdentityRef
url	string

GitRefUpdate

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

GitRepository

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
defaultBranch	string
id	string
isDisabled	boolean	True si el repositorio está deshabilitado. En caso contrario, devuelve un valor falso.
isFork	boolean	True si el repositorio se creó como bifurcación.
isInMaintenance	boolean	True si el repositorio está en mantenimiento. En caso contrario, devuelve un valor falso.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Representa una referencia superficial a un TeamProject.
remoteUrl	string
size	integer	Tamaño comprimido (bytes) del repositorio.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Nombre	Tipo	Description
collection	TeamProjectCollectionReference	Colección de proyectos de equipo donde reside esta bifurcación
id	string
isFork	boolean	True si el repositorio se creó como bifurcación
name	string
project	TeamProjectReference	Representa una referencia superficial a un TeamProject.
remoteUrl	string
sshUrl	string
url	string

GitStatus

Esta clase contiene los metadatos de un servicio o extensión que publica un estado.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos de referencia.
context	GitStatusContext	Contexto del estado.
createdBy	IdentityRef	Identidad que creó el estado.
creationDate	string	Fecha y hora de creación del estado.
description	string	Descripción del estado. Normalmente se describe el estado actual del estado.
id	integer	Identificador de estado.
state	GitStatusState	Estado del estado.
targetUrl	string	Dirección URL con detalles de estado.
updatedDate	string	Fecha y hora de la última actualización del estado.

GitStatusContext

Contexto de estado que identifica de forma única el estado.

Nombre	Tipo	Description
genre	string	Género del estado. Normalmente, el nombre del servicio o herramienta que genera el estado puede estar vacío.
name	string	El identificador de nombre del estado no puede ser nulo ni estar vacío.

GitStatusState

Estado del estado.

Nombre	Tipo	Description
error	string	Estado con un error.
failed	string	Error de estado.
notApplicable	string	El estado no es aplicable al objeto de destino.
notSet	string	Estado de estado no establecido. Estado predeterminado.
pending	string	Estado pendiente.
succeeded	string	El estado se realizó correctamente.

GitTemplate

Nombre	Tipo	Description
name	string	Nombre de la plantilla
type	string	Tipo de la plantilla

GitUserDate

Información de usuario y fecha para las operaciones de Git.

Nombre	Tipo	Description
date	string	Fecha de la operación de Git.
email	string	Email dirección del usuario que realiza la operación de Git.
imageUrl	string	Dirección URL del avatar del usuario.
name	string	Nombre del usuario que realiza la operación de Git.

IdentityRef

Nombre	Tipo	Description
_links	ReferenceLinks	Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo.
descriptor	string	El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones.
directoryAlias	string	En desuso: se puede recuperar consultando al usuario de Graph al que se hace referencia en la entrada "self" del diccionario identityRef "_links".
displayName	string	Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen.
id	string
imageUrl	string	En desuso: disponible en la entrada "avatar" del diccionario "_links" de IdentityRef
inactive	boolean	En desuso: se puede recuperar consultando el estado de pertenencia de Graph al que se hace referencia en la entrada "membershipState" del diccionario GraphUser "_links".
isAadIdentity	boolean	En desuso: se puede deducir del tipo de asunto del descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	En desuso: se puede deducir del tipo de sujeto del descriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	En desuso: no en uso en la mayoría de las implementaciones preexistentes de ToIdentityRef
uniqueName	string	En desuso: use Domain+PrincipalName en su lugar.
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

ItemContent

Nombre	Tipo	Description
content	string
contentType	ItemContentType

ItemContentType

Nombre	Tipo	Description
base64Encoded	string
rawText	string

ProjectState

Estado del proyecto.

Nombre	Tipo	Description
all	string	Todos los proyectos independientemente del estado excepto Eliminado.
createPending	string	El proyecto se ha puesto en cola para su creación, pero el proceso aún no se ha iniciado.
deleted	string	Se ha eliminado el proyecto.
deleting	string	El proyecto está en proceso de eliminación.
new	string	El proyecto está en proceso de creación.
unchanged	string	No se ha cambiado el proyecto.
wellFormed	string	El proyecto se crea completamente y está listo para usarse.

ProjectVisibility

Visibilidad del proyecto.

Nombre	Tipo	Description
private	string	El proyecto solo es visible para los usuarios con acceso explícito.
public	string	El proyecto es visible para todos.

ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.

Nombre	Tipo	Description
links	object	Vista de lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

ResourceRef

Nombre	Tipo	Description
id	string
url	string

TeamProjectCollectionReference

Objeto reference de teamProjectCollection.

Nombre	Tipo	Description
avatarUrl	string	Dirección URL del avatar de la colección.
id	string	Identificador de colección.
name	string	Nombre de la colección.
url	string	Dirección URL de REST de la colección.

TeamProjectReference

Representa una referencia superficial a un TeamProject.

Nombre	Tipo	Description
abbreviation	string	Abreviatura del proyecto.
defaultTeamImageUrl	string	Dirección URL a la imagen de identidad de equipo predeterminada.
description	string	Descripción del proyecto (si existe).
id	string	Identificador del proyecto.
lastUpdateTime	string	Hora de la última actualización del proyecto.
name	string	Nombre del proyecto.
revision	integer	Revisión del proyecto.
state	ProjectState	Estado del proyecto.
url	string	Dirección URL a la versión completa del objeto.
visibility	ProjectVisibility	Visibilidad del proyecto.

VersionControlChangeType

Tipo de cambio realizado en el elemento.

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