Pull Request Reviewers - Create Pull Request Reviewer

Referencia

Servicio:: Git

Versión de la API:: 7.1

Agregue un revisor a una solicitud de incorporación de cambios o emita un voto.

PUT https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/reviewers/{reviewerId}?api-version=7.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	Nombre de la organización de Azure DevOps.
pullRequestId	path	True	integer (int32)	Identificador de la solicitud de incorporación de cambios.
repositoryId	path	True	string	Identificador del repositorio de la rama de destino de la solicitud de incorporación de cambios.
reviewerId	path	True	string	Identificador del revisor.
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" para usar esta versión de la API.

Cuerpo de la solicitud

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" 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 "_links" de GraphUser.
isAadIdentity	boolean	En desuso: se puede deducir del tipo de sujeto 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 esta votación 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 requieran 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 (int16)	Vote por una solicitud de incorporación de cambios: 10 - aprobado 5 - aprobado con sugerencias 0 - sin voto -5 - esperando el 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 el equipo vota, ese voto se acumula en el grupo o el voto del equipo. VoteFor es una lista de tales votos.

Respuestas

Nombre	Tipo	Description
200 OK	IdentityRefWithVote	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

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

Add a reviewer

Set vote

Add a reviewer

Solicitud de ejemplo

HTTP

PUT https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/19d9411e-9a34-45bb-b985-d24d9d87c0c9?api-version=7.1

{
  "vote": 0,
  "id": "19d9411e-9a34-45bb-b985-d24d9d87c0c9"
}

Respuesta de muestra

status code:: 200

{
  "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/19d9411e-9a34-45bb-b985-d24d9d87c0c9",
  "vote": 0,
  "id": "19d9411e-9a34-45bb-b985-d24d9d87c0c9",
  "displayName": "Johnnie McLeod",
  "uniqueName": "fabrikamfiber2@hotmail.com",
  "url": "https://dev.azure.com/fabrikam/_apis/Identities/19d9411e-9a34-45bb-b985-d24d9d87c0c9",
  "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=19d9411e-9a34-45bb-b985-d24d9d87c0c9"
}

Set vote

Solicitud de ejemplo

HTTP

PUT https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db?api-version=7.1

{
  "vote": 10,
  "id": "d6245f20-2af8-44f4-9451-8107cb2767db"
}

Respuesta de muestra

status code:: 200

{
  "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db",
  "vote": 10,
  "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"
}

Definiciones

Nombre	Description
IdentityRefWithVote	Información de identidad, incluida una votación sobre una solicitud de incorporación de cambios.
ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.

IdentityRefWithVote

Object

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" 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 "_links" de GraphUser.
isAadIdentity	boolean	En desuso: se puede deducir del tipo de sujeto 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 esta votación 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 requieran 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 (int16)	Vote por una solicitud de incorporación de cambios: 10 - aprobado 5 - aprobado con sugerencias 0 - sin voto -5 - esperando el 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 el equipo vota, ese voto se acumula en el grupo o el voto del equipo. VoteFor es una lista de tales votos.

ReferenceLinks

Object

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

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

Compartir a través de

Pull Request Reviewers - Create Pull Request Reviewer

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

oauth2

Ámbitos

Ejemplos

Add a reviewer

Solicitud de ejemplo

Respuesta de muestra

Set vote

Solicitud de ejemplo

Respuesta de muestra

Definiciones

IdentityRefWithVote

ReferenceLinks