Compartir a través de

Commits - Get Push Commits

  • Referencia
Service:
Git
API Version:
7.1-preview.1

Recupera una lista de confirmaciones asociadas a una inserción determinada.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

El nombre de la organización de Azure DevOps.
repositoryId
 path True

string

Identificador o nombre descriptivo del repositorio. Para usar el nombre descriptivo, también se debe especificar projectId.
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.1" para usar esta versión de la API.
pushId
 query True

integer

int32

Identificador de la inserción.
includeLinks
 query

boolean

Establézcalo en false para evitar incluir vínculos url de REST para los recursos. El valor predeterminado es true.
skip
 query

integer

int32

Número de confirmaciones que se van a omitir.
top
 query

integer

int32

Número máximo de confirmaciones que se van a devolver ("obtener las confirmaciones x principales").

Respuestas

Nombre Tipo Description
200 OK

GitCommitRef[]

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 el código fuente y los 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 los eventos de control de versiones a través de enlaces de servicio.

Ejemplos

Sample Request

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

Sample Response

Status code:
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"
        }
      }
    }
  ]
}

Definiciones

Nombre Description
ChangeCountDictionary
GitChange
GitCommitRef

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

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

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

Estado del estado.
GitTemplate
GitUserDate

Información del usuario y fecha de las operaciones de Git.
IdentityRef
ItemContent
ItemContentType
ReferenceLinks

Clase que representa una colección de vínculos de referencia de REST.
ResourceRef
VersionControlChangeType

Tipo de cambio que se realizó en el elemento.

ChangeCountDictionary

GitChange

Nombre Tipo Description
changeId

integer

Identificador del cambio dentro del grupo de cambios.
changeType

VersionControlChangeType

Tipo de cambio que se realizó 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 mostrarán.
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.

GitPushRef

Nombre Tipo Description
_links

ReferenceLinks

Clase que representa una colección de vínculos de referencia de REST.
date

string

pushId

integer

pushedBy

IdentityRef

url

string

GitStatus

Esta clase contiene los metadatos de un servicio o extensión que registra 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 la 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 del usuario y fecha de 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 el 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

Clase que representa una colección de vínculos de referencia de REST.

Nombre Tipo Description
links

object

Vista de solo 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

VersionControlChangeType

Tipo de cambio que se realizó 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