Commits - Get Commits Batch

Referencia

Service:: Git

API Version:: 5.0

Recuperación de confirmaciones de Git para un proyecto que coincida con los criterios de búsqueda

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

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?$skip={$skip}&$top={$top}&includeStatuses={includeStatuses}&api-version=5.0

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	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 "5.0" para usar esta versión de la API.
$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.
includeStatuses	query		boolean	True para incluir información de estado de confirmación adicional.

Cuerpo de la solicitud

Nombre	Tipo	Description
$skip	integer	Número de entradas que se van a omitir
$top	integer	Número máximo de entradas que se van a recuperar
author	string	Alias o nombre para mostrar del autor
compareVersion	GitVersionDescriptor	Solo es aplicable cuando se especifica ItemVersion. Si se proporciona, empiece a caminar el historial a partir de esta confirmación.
excludeDeletes	boolean	Solo se aplica cuando se especifica itemPath. Esto determina si se excluyen las entradas de eliminación de la ruta de acceso especificada.
fromCommitId	string	Si se proporciona, un límite inferior para filtrar confirmaciones alfabéticamente
fromDate	string	Si se proporciona, incluya solo las entradas del historial creadas después de esta fecha (cadena)
historyMode	GitHistoryMode	Qué modo de historial de Git se debe usar. Esto solo se aplica a los criterios de búsqueda cuando se especifica Ids = null y itemPath.
ids	string[]	Si se proporciona, especifica los identificadores de confirmación exactos de las confirmaciones que se van a capturar. No se puede combinar con otros parámetros.
includeLinks	boolean	Si se debe incluir el campo _links en las referencias poco profundas
includePushData	boolean	Si se debe incluir la información de inserción
includeUserImageUrl	boolean	Si se debe incluir la dirección URL de la imagen para los autores y confirmadores
includeWorkItems	boolean	Si se deben incluir elementos de trabajo vinculados
itemPath	string	Ruta de acceso del elemento en la que se va a buscar
itemVersion	GitVersionDescriptor	Si se proporciona, identifica la confirmación o la rama que se va a buscar.
toCommitId	string	Si se proporciona, un límite superior para filtrar confirma alfabéticamente
toDate	string	Si se proporciona, incluya solo las entradas del historial creadas antes de esta fecha (cadena)
user	string	Alias o nombre para mostrar del committer

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

Commits between two versions

Commits by a list of commit IDs

Commits between two versions

Sample Request

HTTP

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

{
  "itemVersion": {
    "versionType": "branch",
    "version": "develop"
  },
  "compareVersion": {
    "versionType": "branch",
    "version": "master"
  }
}

Sample Response

Status code:: 200

{
  "count": 17,
  "value": [
    {
      "commitId": "23d0bc5b128a10056dc68afece360d8a0fabb014",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/23d0bc5b128a10056dc68afece360d8a0fabb014",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/23d0bc5b128a10056dc68afece360d8a0fabb014"
    },
    {
      "commitId": "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
    },
    {
      "commitId": "0360c963d7d86d040e9c33bba836feab14da4ad3",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-10T19:42:13Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-10T19:42:13Z"
      },
      "comment": "Fix for hello world class",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/0360c963d7d86d040e9c33bba836feab14da4ad3",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/0360c963d7d86d040e9c33bba836feab14da4ad3"
    },
    {
      "commitId": "097d82b8aeabe493bf4c3553d320ae2529bba591",
      "author": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-06-09T21:43:25Z"
      },
      "committer": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-06-09T21:43:25Z"
      },
      "comment": "fix registration page",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/097d82b8aeabe493bf4c3553d320ae2529bba591",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/097d82b8aeabe493bf4c3553d320ae2529bba591"
    },
    {
      "commitId": "33b55f7cb7e7e245323987634f960cf4a6e6bc74",
      "author": {
        "name": "Will Smythe",
        "email": "wismythe@microsoft.com",
        "date": "2014-05-02T19:17:05Z"
      },
      "committer": {
        "name": "Will Smythe",
        "email": "wismythe@microsoft.com",
        "date": "2014-05-02T19:17:05Z"
      },
      "comment": "Fixed bug in web.config file",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/33b55f7cb7e7e245323987634f960cf4a6e6bc74",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/33b55f7cb7e7e245323987634f960cf4a6e6bc74"
    },
    {
      "commitId": "aad331d8d3b131fa9ae03cf5e53965b51942618a",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-04-14T21:34:52Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-04-14T21:34:52Z"
      },
      "comment": "Fixed bug for address validation.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/aad331d8d3b131fa9ae03cf5e53965b51942618a",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/aad331d8d3b131fa9ae03cf5e53965b51942618a"
    },
    {
      "commitId": "7c18355d8c2d946c5e1ce7a56f49653854445a1a",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-28T17:05:58Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-28T17:05:58Z"
      },
      "comment": "Added validation logic.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/7c18355d8c2d946c5e1ce7a56f49653854445a1a",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/7c18355d8c2d946c5e1ce7a56f49653854445a1a"
    },
    {
      "commitId": "cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-27T19:51:11Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-27T19:51:11Z"
      },
      "comment": "Added validation logic for zip code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c"
    },
    {
      "commitId": "ef837766c5eb3ae81a4c663d36bf95a8aed91312",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T20:25:39Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T20:25:39Z"
      },
      "comment": "Add validation code for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/ef837766c5eb3ae81a4c663d36bf95a8aed91312",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/ef837766c5eb3ae81a4c663d36bf95a8aed91312"
    },
    {
      "commitId": "bd73638408daff89bcdac549a5a3396c9a7ce9dd",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:56:21Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:56:21Z"
      },
      "comment": "Added validation logic for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/bd73638408daff89bcdac549a5a3396c9a7ce9dd",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/bd73638408daff89bcdac549a5a3396c9a7ce9dd"
    },
    {
      "commitId": "03bea1cebffa5726da0e3c0bc1487796d0dd0ee8",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:42:24Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:42:24Z"
      },
      "comment": "Added validation logic for address values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/03bea1cebffa5726da0e3c0bc1487796d0dd0ee8",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/03bea1cebffa5726da0e3c0bc1487796d0dd0ee8"
    },
    {
      "commitId": "c093714168cdd190c1e171a803e996d685454352",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:37:32Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:37:32Z"
      },
      "comment": "Added validation logic for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/c093714168cdd190c1e171a803e996d685454352",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/c093714168cdd190c1e171a803e996d685454352"
    },
    {
      "commitId": "3d203ea73427cec36b77a3a5a2e4f1f8ba7de170",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:00:14Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:00:14Z"
      },
      "comment": "Added code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/3d203ea73427cec36b77a3a5a2e4f1f8ba7de170",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/3d203ea73427cec36b77a3a5a2e4f1f8ba7de170"
    },
    {
      "commitId": "1eea03b2ad9f14a5e7297c1307e36c980eb910ea",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T16:17:11Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T16:17:11Z"
      },
      "comment": "Added code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/1eea03b2ad9f14a5e7297c1307e36c980eb910ea",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/1eea03b2ad9f14a5e7297c1307e36c980eb910ea"
    },
    {
      "commitId": "c40b5ceb9c77096b9f59e6a9193dae527bda79d9",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:54:10Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:54:10Z"
      },
      "comment": "Added method for submitting new customer addrress.",
      "changeCounts": {
        "Edit": 2
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/c40b5ceb9c77096b9f59e6a9193dae527bda79d9",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/c40b5ceb9c77096b9f59e6a9193dae527bda79d9"
    },
    {
      "commitId": "6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:50:08Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:50:08Z"
      },
      "comment": "Adding customer address module project",
      "changeCounts": {
        "Add": 12
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe"
    },
    {
      "commitId": "03b1b831e41df536d836c95e2f68a42db4f3e0db",
      "author": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-02-10T21:52:47Z"
      },
      "committer": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-02-10T21:52:47Z"
      },
      "comment": "Add Hello World to TFS",
      "changeCounts": {
        "Add": 5
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/03b1b831e41df536d836c95e2f68a42db4f3e0db",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/03b1b831e41df536d836c95e2f68a42db4f3e0db"
    }
  ]
}

Commits by a list of commit IDs

Sample Request

HTTP

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

{
  "ids": [
    "23d0bc5b128a10056dc68afece360d8a0fabb014",
    "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
  ]
}

Sample Response

Status code:: 200

{
  "count": 2,
  "value": [
    {
      "commitId": "23d0bc5b128a10056dc68afece360d8a0fabb014",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/23d0bc5b128a10056dc68afece360d8a0fabb014",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/23d0bc5b128a10056dc68afece360d8a0fabb014"
    },
    {
      "commitId": "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
    }
  ]
}

Definiciones

Nombre	Description
ChangeCountDictionary
GitChange
GitCommitRef	Proporciona propiedades que describen una confirmación de Git y los metadatos asociados.
GitHistoryMode	Qué modo de historial de Git se debe usar. Esto solo se aplica a los criterios de búsqueda cuando se especifica Ids = null y itemPath.
GitPushRef
GitQueryCommitsCriteria
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.
GitVersionDescriptor
GitVersionOptions	Opciones de versión: especifique modificadores adicionales para la versión (por ejemplo, Anterior)
GitVersionType	Tipo de versión (rama, etiqueta o confirmación). Determina cómo se interpreta id.
IdentityRef
ItemContent
ItemContentType
ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
ResourceRef
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	Identificador (SHA-1) de la confirmació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.

GitHistoryMode

Qué modo de historial de Git se debe usar. Esto solo se aplica a los criterios de búsqueda cuando se especifica Ids = null y itemPath.

Nombre	Tipo	Description
firstParent	string	Modo de historial utilizado por `git log --first-parent`
fullHistory	string	Modo de historial utilizado por `git log --full-history`
fullHistorySimplifyMerges	string	Modo de historial utilizado por `git log --full-history --simplify-merges`
simplifiedHistory	string	Modo de historial utilizado por `git log`. Este es el valor predeterminado.

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

GitQueryCommitsCriteria

Nombre	Tipo	Description
$skip	integer	Número de entradas que se van a omitir
$top	integer	Número máximo de entradas que se van a recuperar
author	string	Alias o nombre para mostrar del autor
compareVersion	GitVersionDescriptor	Solo es aplicable cuando se especifica ItemVersion. Si se proporciona, comience a caminar el historial a partir de esta confirmación.
excludeDeletes	boolean	Solo se aplica cuando se especifica un itemPath. Esto determina si se van a excluir las entradas de eliminación de la ruta de acceso especificada.
fromCommitId	string	Si se proporciona, un límite inferior para filtrar confirmaciones alfabéticamente
fromDate	string	Si se proporciona, incluya solo las entradas del historial creadas después de esta fecha (cadena)
historyMode	GitHistoryMode	Qué modo de historial de Git se debe usar. Esto solo se aplica a los criterios de búsqueda cuando se especifica Ids = null y itemPath.
ids	string[]	Si se proporciona, especifica los identificadores de confirmación exactos de las confirmaciones que se van a capturar. No se puede combinar con otros parámetros.
includeLinks	boolean	Si se debe incluir el campo _links en las referencias poco profundas
includePushData	boolean	Si se debe incluir la información de inserción
includeUserImageUrl	boolean	Si se debe incluir la dirección URL de la imagen para los autores y los confirmadores
includeWorkItems	boolean	Si se deben incluir elementos de trabajo vinculados
itemPath	string	Ruta de acceso del elemento en la que se va a buscar
itemVersion	GitVersionDescriptor	Si se proporciona, identifica la confirmación o la rama que se va a buscar.
toCommitId	string	Si se proporciona, un límite superior para filtrar confirma alfabéticamente las confirmaciones
toDate	string	Si se proporciona, incluya solo las entradas del historial creadas antes de esta fecha (cadena)
user	string	Alias o nombre para mostrar del committer

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.

GitVersionDescriptor

Nombre	Tipo	Description
version	string	Identificador de cadena de versión (nombre de etiqueta/rama, SHA1 de confirmación)
versionOptions	GitVersionOptions	Opciones de versión: especifique modificadores adicionales para la versión (por ejemplo, Anterior)
versionType	GitVersionType	Tipo de versión (rama, etiqueta o confirmación). Determina cómo se interpreta id.

GitVersionOptions

Opciones de versión: especifique modificadores adicionales para la versión (por ejemplo, Anterior)

Nombre	Tipo	Description
firstParent	string	Primer elemento primario de confirmación (HEAD^)
none	string	Sin especificar
previousChange	string	Confirmar que cambió el elemento antes de la versión actual

GitVersionType

Tipo de versión (rama, etiqueta o confirmación). Determina cómo se interpreta id.

Nombre	Tipo	Description
branch	string	Interpretar la versión como un nombre de rama
commit	string	Interpretar la versión como un identificador de confirmación (SHA1)
tag	string	Interpretar la versión como un nombre de etiqueta

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
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
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
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

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

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

Compartir a través de

Commits - Get Commits Batch

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

oauth2

Scopes

Ejemplos

Commits between two versions

Sample Request

Sample Response

Commits by a list of commit IDs

Sample Request

Sample Response

Definiciones

ChangeCountDictionary

GitChange

GitCommitRef

GitHistoryMode

GitPushRef

GitQueryCommitsCriteria

GitStatus

GitStatusContext

GitStatusState

GitTemplate

GitUserDate

GitVersionDescriptor

GitVersionOptions

GitVersionType

IdentityRef

ItemContent

ItemContentType

ReferenceLinks

ResourceRef

VersionControlChangeType

Recursos adicionales