Compartir a través de


Pull Requests - Create

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

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

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

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.