Pull Requests - Create

Service:

Git

API Version:

7.1-preview.1

Cree una solicitud de incorporación de cambios.

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1-preview.1

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?supportsIterations={supportsIterations}&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 del repositorio de la rama de destino de la solicitud de incorporación de cambios.
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.
supportsIterations	query		boolean	Si es true, las inserciones posteriores a la solicitud de incorporación de cambios se podrán revisar individualmente. Establézcalo en false para solicitudes de incorporación de cambios de gran tamaño por motivos de rendimiento si esta funcionalidad no es necesaria.

Cuerpo de la solicitud

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos a otros objetos relacionados.
artifactId	string	Cadena que identifica de forma única esta solicitud de incorporación de cambios. Para generar un identificador de artefacto para una solicitud de incorporación de cambios, use esta plantilla: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}
autoCompleteSetBy	IdentityRef	Si se establece, se habilita autocompletar para esta solicitud de incorporación de cambios y se trata de la identidad que la habilitó.
closedBy	IdentityRef	Usuario que cerró la solicitud de incorporación de cambios.
closedDate	string	Fecha en la que se cerró la solicitud de incorporación de cambios (completada, abandonada o combinada externamente).
codeReviewId	integer	Identificador de revisión de código de la solicitud de incorporación de cambios. Utilizado de forma interna.
commits	GitCommitRef[]	Confirmaciones contenidas en la solicitud de incorporación de cambios.
completionOptions	GitPullRequestCompletionOptions	Opciones que afectan a cómo se combinará la solicitud de incorporación de cambios cuando se complete.
completionQueueTime	string	Fecha más reciente en la que la solicitud de incorporación de cambios entró en la cola que se va a completar. Utilizado de forma interna.
createdBy	IdentityRef	Identidad del usuario que creó la solicitud de incorporación de cambios.
creationDate	string	Fecha en que se creó la solicitud de incorporación de cambios.
description	string	Descripción de la solicitud de incorporación de cambios.
forkSource	GitForkRef	Si se trata de una solicitud de incorporación de cambios de una bifurcación, contendrá información sobre su origen.
hasMultipleMergeBases	boolean	Advertencia de varias bases de mezcla
isDraft	boolean	Solicitud de incorporación de cambios borrador/WIP.
labels	WebApiTagDefinition[]	Etiquetas asociadas a la solicitud de incorporación de cambios.
lastMergeCommit	GitCommitRef	Confirmación de la combinación de solicitudes de incorporación de cambios más reciente. Si está vacío, la combinación más reciente está en curso o no se realizó correctamente.
lastMergeSourceCommit	GitCommitRef	Confirmación en el encabezado de la rama de origen en el momento de la última combinación de solicitudes de incorporación de cambios.
lastMergeTargetCommit	GitCommitRef	Confirmación en el encabezado de la rama de destino en el momento de la última combinación de solicitudes de incorporación de cambios.
mergeFailureMessage	string	Si se establece, se produjo un error en la combinación de solicitudes de incorporación de cambios por este motivo.
mergeFailureType	PullRequestMergeFailureType	Tipo de error (si existe) de la combinación de solicitudes de incorporación de cambios.
mergeId	string	Identificador del trabajo usado para ejecutar la combinación de solicitudes de incorporación de cambios. Utilizado de forma interna.
mergeOptions	GitPullRequestMergeOptions	Opciones usadas cuando se ejecuta la combinación de solicitudes de incorporación de cambios. Son independientes de las opciones de finalización, ya que la finalización solo se produce una vez y se ejecutará una nueva combinación cada vez que cambia la rama de origen de la solicitud de incorporación de cambios.
mergeStatus	PullRequestAsyncStatus	Estado actual de la combinación de solicitudes de incorporación de cambios.
pullRequestId	integer	Identificador de la solicitud de incorporación de cambios.
remoteUrl	string	Utilizado de forma interna.
repository	GitRepository	Repositorio que contiene la rama de destino de la solicitud de incorporación de cambios.
reviewers	IdentityRefWithVote[]	Lista de revisores en la solicitud de incorporación de cambios junto con el estado de sus votos.
sourceRefName	string	Nombre de la rama de origen de la solicitud de incorporación de cambios.
status	PullRequestStatus	Estado de la solicitud de incorporación de cambios.
supportsIterations	boolean	Si es true, esta solicitud de incorporación de cambios admite varias iteraciones. La compatibilidad con iteración significa que se pueden revisar inserciones individuales en la rama de origen de la solicitud de incorporación de cambios y se realizará un seguimiento de los comentarios que quedan en una iteración en iteraciones futuras.
targetRefName	string	Nombre de la rama de destino de la solicitud de incorporación de cambios.
title	string	Título de la solicitud de incorporación de cambios.
url	string	Utilizado de forma interna.
workItemRefs	ResourceRef[]	Cualquier referencia de elemento de trabajo asociada a esta solicitud de incorporación de cambios.

Respuestas

Nombre	Tipo	Description
200 OK	GitPullRequest	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_write	Concede la capacidad de leer, actualizar y eliminar código fuente, acceder a metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de crear y administrar solicitudes de incorporación de cambios y revisiones de código y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Ejemplos

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullrequests?api-version=7.1-preview.1

{
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "title": "A new feature",
  "description": "Adding a new feature",
  "reviewers": [
    {
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  ]
}

Sample Response

Status code:

201

{
  "repository": {
    "id": "3411ebc1-d5aa-464f-9615-0b527bc66719",
    "name": "2016_10_31",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719",
    "project": {
      "id": "a7573007-bbb3-4341-b726-0c4148a07853",
      "name": "2016_10_31",
      "description": "test project created on Halloween 2016",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/a7573007-bbb3-4341-b726-0c4148a07853",
      "state": "wellFormed",
      "revision": 7
    },
    "remoteUrl": "https://dev.azure.com/fabrikam/_git/2016_10_31"
  },
  "pullRequestId": 22,
  "codeReviewId": 22,
  "status": "active",
  "createdBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://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"
  },
  "creationDate": "2016-11-01T16:30:31.6655471Z",
  "title": "A new feature",
  "description": "Adding a new feature",
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "mergeStatus": "queued",
  "mergeId": "f5fc8381-3fb2-49fe-8a0d-27dcc2d6ef82",
  "lastMergeSourceCommit": {
    "commitId": "b60280bc6e62e2f880f1b63c1e24987664d3bda3",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
  },
  "lastMergeTargetCommit": {
    "commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
  },
  "reviewers": [
    {
      "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db",
      "vote": 0,
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
      "displayName": "Normal Paulk",
      "uniqueName": "fabrikamfiber16@hotmail.com",
      "url": "https://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"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719"
    },
    "workItems": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/workitems"
    },
    "sourceBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "targetBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "sourceCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
    },
    "targetCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
    },
    "createdBy": {
      "href": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    },
    "iterations": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/iterations"
    }
  },
  "supportsIterations": true,
  "artifactId": "vstfs:///Git/PullRequestId/a7573007-bbb3-4341-b726-0c4148a07853%2f3411ebc1-d5aa-464f-9615-0b527bc66719%2f22"
}

Definiciones

Nombre	Description
ChangeCountDictionary
GitChange
GitCommitRef	Proporciona propiedades que describen una confirmación de Git y los metadatos asociados.
GitForkRef	Información sobre una referencia de bifurcación.
GitPullRequest	Representa todos los datos asociados a una solicitud de incorporación de cambios.
GitPullRequestCompletionOptions	Preferencias sobre cómo se debe completar la solicitud de incorporación de cambios.
GitPullRequestMergeOptions	Las opciones que se usan cuando se crea una combinación de solicitudes de incorporación de cambios.
GitPullRequestMergeStrategy	Especifique la estrategia utilizada para combinar la solicitud de incorporación de cambios durante la finalización. Si MergeStrategy no está establecido en ningún valor, se creará una combinación sin FF si SquashMerge == false. Si MergeStrategy no está establecido en ningún valor, las confirmaciones de la solicitud de incorporación de cambios se aplastarán si SquashMerge == true. La propiedad SquashMerge está en desuso. Se recomienda establecer explícitamente MergeStrategy en todos los casos. Si se proporciona un valor explícito para MergeStrategy, se omitirá la propiedad SquashMerge.
GitPushRef
GitRepository
GitRepositoryRef
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
IdentityRefWithVote	Información de identidad, incluida una votación sobre una solicitud de incorporación de cambios.
ItemContent
ItemContentType
ProjectState	Estado del proyecto.
ProjectVisibility	Visibilidad del proyecto.
PullRequestAsyncStatus	Estado actual de la combinación de solicitudes de incorporación de cambios.
PullRequestMergeFailureType	Tipo de error (si existe) de la combinación de solicitudes de incorporación de cambios.
PullRequestStatus	Estado de la solicitud de incorporación de cambios.
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.
WebApiTagDefinition	Representación de una definición de etiqueta que se envía a través de la conexión.

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	Identificador (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.

GitForkRef

Información sobre una referencia de bifurcación.

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
creator	IdentityRef
isLocked	boolean
isLockedBy	IdentityRef
name	string
objectId	string
peeledObjectId	string
repository	GitRepository	Identificador del repositorio de la bifurcación.
statuses	GitStatus[]	Esta clase contiene los metadatos de un servicio o extensión que publica un estado.
url	string

GitPullRequest

Representa todos los datos asociados a una solicitud de incorporación de cambios.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos a otros objetos relacionados.
artifactId	string	Cadena que identifica de forma única esta solicitud de incorporación de cambios. Para generar un identificador de artefacto para una solicitud de incorporación de cambios, use esta plantilla: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}
autoCompleteSetBy	IdentityRef	Si se establece, autocompletar está habilitado para esta solicitud de incorporación de cambios y esta es la identidad que la ha habilitado.
closedBy	IdentityRef	El usuario que cerró la solicitud de incorporación de cambios.
closedDate	string	Fecha en que se cerró la solicitud de incorporación de cambios (completada, abandonada o combinada externamente).
codeReviewId	integer	Identificador de revisión de código de la solicitud de incorporación de cambios. Utilizado de forma interna.
commits	GitCommitRef[]	Confirmaciones contenidas en la solicitud de incorporación de cambios.
completionOptions	GitPullRequestCompletionOptions	Opciones que afectan a cómo se combinará la solicitud de incorporación de cambios cuando se complete.
completionQueueTime	string	La fecha más reciente en la que la solicitud de incorporación de cambios entró en la cola que se va a completar. Utilizado de forma interna.
createdBy	IdentityRef	Identidad del usuario que creó la solicitud de incorporación de cambios.
creationDate	string	Fecha en que se creó la solicitud de incorporación de cambios.
description	string	Descripción de la solicitud de incorporación de cambios.
forkSource	GitForkRef	Si se trata de una solicitud de incorporación de cambios de una bifurcación, contendrá información sobre su origen.
hasMultipleMergeBases	boolean	Advertencia de varias bases de mezcla
isDraft	boolean	Borrador/solicitud de incorporación de cambios de WIP.
labels	WebApiTagDefinition[]	Las etiquetas asociadas a la solicitud de incorporación de cambios.
lastMergeCommit	GitCommitRef	Confirmación de la combinación de solicitudes de incorporación de cambios más reciente. Si está vacía, la combinación más reciente está en curso o no se realizó correctamente.
lastMergeSourceCommit	GitCommitRef	Confirmación en el encabezado de la rama de origen en el momento de la última combinación de solicitudes de incorporación de cambios.
lastMergeTargetCommit	GitCommitRef	Confirmación en el encabezado de la rama de destino en el momento de la última combinación de solicitudes de incorporación de cambios.
mergeFailureMessage	string	Si se establece, se produjo un error en la combinación de solicitudes de incorporación de cambios por este motivo.
mergeFailureType	PullRequestMergeFailureType	Tipo de error (si existe) de la combinación de solicitudes de incorporación de cambios.
mergeId	string	Identificador del trabajo usado para ejecutar la combinación de solicitudes de incorporación de cambios. Utilizado de forma interna.
mergeOptions	GitPullRequestMergeOptions	Opciones usadas cuando se ejecuta la combinación de solicitudes de incorporación de cambios. Son independientes de las opciones de finalización, ya que la finalización solo se produce una vez y se ejecutará una nueva combinación cada vez que cambia la rama de origen de la solicitud de incorporación de cambios.
mergeStatus	PullRequestAsyncStatus	Estado actual de la combinación de solicitudes de incorporación de cambios.
pullRequestId	integer	Identificador de la solicitud de incorporación de cambios.
remoteUrl	string	Utilizado de forma interna.
repository	GitRepository	Repositorio que contiene la rama de destino de la solicitud de incorporación de cambios.
reviewers	IdentityRefWithVote[]	Una lista de revisores en la solicitud de incorporación de cambios junto con el estado de sus votos.
sourceRefName	string	Nombre de la rama de origen de la solicitud de incorporación de cambios.
status	PullRequestStatus	Estado de la solicitud de incorporación de cambios.
supportsIterations	boolean	Si es true, esta solicitud de incorporación de cambios admite varias iteraciones. La compatibilidad con la iteración significa que se pueden revisar las inserciones individuales en la rama de origen de la solicitud de incorporación de cambios y se realizará un seguimiento de los comentarios que quedan en una iteración en iteraciones futuras.
targetRefName	string	Nombre de la rama de destino de la solicitud de incorporación de cambios.
title	string	Título de la solicitud de incorporación de cambios.
url	string	Utilizado de forma interna.
workItemRefs	ResourceRef[]	Cualquier referencia de elemento de trabajo asociada a esta solicitud de incorporación de cambios.

GitPullRequestCompletionOptions

Preferencias sobre cómo se debe completar la solicitud de incorporación de cambios.

Nombre	Tipo	Description
autoCompleteIgnoreConfigIds	integer[]	Lista de los identificadores de configuración de directiva que no deben esperar a completarse automáticamente. Solo se aplica a las directivas opcionales (isBlocking == false). Autocompletar siempre espera las directivas necesarias (isBlocking == true).
bypassPolicy	boolean	Si es true, las directivas se omitirán explícitamente mientras se completa la solicitud de incorporación de cambios.
bypassReason	string	Si se omiten las directivas, este motivo se almacena como por qué se usó la omisión.
deleteSourceBranch	boolean	Si es true, la rama de origen de la solicitud de incorporación de cambios se eliminará después de la finalización.
mergeCommitMessage	string	Si se establece, se usará como mensaje de confirmación de la confirmación de combinación.
mergeStrategy	GitPullRequestMergeStrategy	Especifique la estrategia usada para combinar la solicitud de incorporación de cambios durante la finalización. Si MergeStrategy no se establece en ningún valor, se creará una combinación sin FF si SquashMerge == false. Si MergeStrategy no está establecido en ningún valor, las confirmaciones de la solicitud de incorporación de cambios se aplastarán si SquashMerge == true. La propiedad SquashMerge está en desuso. Se recomienda establecer explícitamente MergeStrategy en todos los casos. Si se proporciona un valor explícito para MergeStrategy, se omitirá la propiedad SquashMerge.
squashMerge	boolean	SquashMerge está en desuso. Debe establecer explícitamente el valor de MergeStrategy. Si MergeStrategy se establece en cualquier valor, se omitirá el valor squashMerge. Si no se establece MergeStrategy, la estrategia de combinación no será de avance rápido si esta marca es false o squash si es true.
transitionWorkItems	boolean	Si es true, intentaremos realizar la transición de los elementos de trabajo vinculados a la solicitud de incorporación de cambios al siguiente estado lógico (es decir, Activo -> Resuelto)
triggeredByAutoComplete	boolean	Si es true, el intento de finalización actual se desencadenó a través de autocompletar. Utilizado de forma interna.

GitPullRequestMergeOptions

Las opciones que se usan cuando se crea una combinación de solicitudes de incorporación de cambios.

Nombre	Tipo	Description
conflictAuthorshipCommits	boolean	Si es true, las resoluciones de conflicto aplicadas durante la combinación se colocarán en confirmaciones independientes para conservar la información de autoría de la culpa de Git, etc.
detectRenameFalsePositives	boolean
disableRenames	boolean	Si es true, la detección de cambio de nombre no se realizará durante la combinación.

GitPullRequestMergeStrategy

Especifique la estrategia utilizada para combinar la solicitud de incorporación de cambios durante la finalización. Si MergeStrategy no está establecido en ningún valor, se creará una combinación sin FF si SquashMerge == false. Si MergeStrategy no está establecido en ningún valor, las confirmaciones de la solicitud de incorporación de cambios se aplastarán si SquashMerge == true. La propiedad SquashMerge está en desuso. Se recomienda establecer explícitamente MergeStrategy en todos los casos. Si se proporciona un valor explícito para MergeStrategy, se omitirá la propiedad SquashMerge.

Nombre	Tipo	Description
noFastForward	string	Combinación de dos elementos primarios y sin avance rápido. La rama de origen no cambia. Este es el comportamiento predeterminado.
rebase	string	Vuelva a basar la rama de origen en la parte superior de la confirmación HEAD de la rama de destino y reenvíe rápidamente la rama de destino. La rama de origen se actualiza durante la operación de rebase.
rebaseMerge	string	Vuelva a basar la rama de origen en la parte superior de la confirmación HEAD de la rama de destino y cree una combinación de dos elementos primarios y sin avance rápido. La rama de origen se actualiza durante la operación de rebase.
squash	string	Coloque todos los cambios de la solicitud de incorporación de cambios en una confirmación primaria única.

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

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 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 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 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.

IdentityRefWithVote

Información de identidad, incluida una votación sobre una solicitud de incorporación de cambios.

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.
hasDeclined	boolean	Indica si este revisor ha rechazado revisar esta solicitud de incorporación de cambios.
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
isFlagged	boolean	Indica si este revisor está marcado para prestar atención a esta solicitud de incorporación de cambios.
isReapprove	boolean	Indica si este voto de aprobación todavía debe controlarse aunque el voto no haya cambiado.
isRequired	boolean	Indica si se trata de un revisor necesario para esta solicitud de incorporación de cambios. Las ramas pueden tener directivas que requieren revisores concretos para las solicitudes de incorporación de cambios.
profileUrl	string	En desuso: no en uso en la mayoría de las implementaciones preexistentes de ToIdentityRef
reviewerUrl	string	Dirección URL para recuperar información sobre esta identidad
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.
vote	integer	Vote por una solicitud de incorporación de cambios: 10 - aprobado 5 - aprobado con sugerencias 0 - sin voto -5 - esperando autor -10 - rechazado
votedFor	IdentityRefWithVote[]	Grupos o equipos a los que contribuyó este revisor. Los grupos y equipos pueden ser revisores en las solicitudes de incorporación de cambios, pero no pueden votar directamente. Cuando un miembro del grupo o equipo vota, ese voto se acumula en el grupo o en el voto de equipo. VoteFor es una lista de tales votos.

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.

PullRequestAsyncStatus

Estado actual de la combinación de solicitudes de incorporación de cambios.

Nombre	Tipo	Description
conflicts	string	Error en la combinación de solicitudes de incorporación de cambios debido a conflictos.
failure	string	Error de combinación de solicitudes de incorporación de cambios.
notSet	string	No se ha establecido el estado. Estado predeterminado.
queued	string	La combinación de solicitudes de incorporación de cambios se pone en cola.
rejectedByPolicy	string	Combinación de solicitudes de incorporación de cambios rechazada por directiva.
succeeded	string	La combinación de solicitudes de incorporación de cambios se realizó correctamente.

PullRequestMergeFailureType

Tipo de error (si existe) de la combinación de solicitudes de incorporación de cambios.

Nombre	Tipo	Description
caseSensitive	string	Error en la combinación de solicitudes de incorporación de cambios debido a un error de coincidencia de mayúsculas y minúsculas.
none	string	No se ha establecido el tipo. Tipo predeterminado.
objectTooLarge	string	Error en la combinación de solicitudes de incorporación de cambios debido a que un objeto es demasiado grande.
unknown	string	Tipo de error de combinación de solicitudes de incorporación de cambios desconocido.

PullRequestStatus

Estado de la solicitud de incorporación de cambios.

Nombre	Tipo	Description
abandoned	string	Se abandona la solicitud de incorporación de cambios.
active	string	La solicitud de incorporación de cambios está activa.
all	string	Se usa en los criterios de búsqueda de solicitudes de incorporación de cambios para incluir todos los estados.
completed	string	Se ha completado la solicitud de incorporación de cambios.
notSet	string	Estado no establecido. Estado predeterminado.

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 del 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

WebApiTagDefinition

Representación de una definición de etiqueta que se envía a través de la conexión.

Nombre	Tipo	Description
active	boolean	Si la definición de etiqueta está activa o no.
id	string	Identificador de la definición de etiqueta.
name	string	Nombre de la definición de etiqueta.
url	string	Dirección URL del recurso para la definición de etiqueta.