Pull Request Statuses - List
Obtenga todos los estados asociados a una solicitud de incorporación de cambios.
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses?api-version=4.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. |
pull
|
path | True |
integer int32 |
Id. de la PR. |
repository
|
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 "4.1-preview.1" para usar esta versión de la API. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
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 código fuente y metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio. |
vso.code_status | Concede la capacidad de leer y escribir el estado de la solicitud de incorporación de cambios y confirmación. |
Ejemplos
Sample Request
GET https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses?api-version=4.1-preview.1
Sample Response
transfer-Encoding: chunked
{
"value": [
{
"id": 1,
"state": "succeeded",
"description": "Sample status succeeded",
"context": {
"name": "sample-status-2",
"genre": "vsts-samples"
},
"creationDate": "2017-09-19T14:50:27.064405Z",
"updatedDate": "2017-09-19T14:50:27.064405Z",
"createdBy": {
"id": "6f168adb-59d4-4fc0-be3b-fb21b939b2a6",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://dev.azure.com/fabrikam/_apis/Identities/6f168adb-59d4-4fc0-be3b-fb21b939b2a6",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=6f168adb-59d4-4fc0-be3b-fb21b939b2a6"
},
"targetUrl": "http://fabrikam-fiber-inc.com/CI/builds/1"
},
{
"id": 2,
"state": "succeeded",
"description": "Sample status succeeded",
"context": {
"name": "sample-status-4",
"genre": "vsts-samples"
},
"creationDate": "2017-09-19T14:50:27.0894136Z",
"updatedDate": "2017-09-19T14:50:27.0894136Z",
"createdBy": {
"id": "6f168adb-59d4-4fc0-be3b-fb21b939b2a6",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://dev.azure.com/fabrikam/_apis/Identities/6f168adb-59d4-4fc0-be3b-fb21b939b2a6",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=6f168adb-59d4-4fc0-be3b-fb21b939b2a6"
},
"targetUrl": "http://fabrikam-fiber-inc.com/CI/builds/1"
}
],
"count": 2
}
Definiciones
Nombre | Description |
---|---|
Git |
Esta clase contiene los metadatos de un estado de solicitud de incorporación de cambios de publicación de servicio o extensión. El estado se puede asociar a una solicitud de incorporación de cambios o a una iteración. |
Git |
Contexto de estado que identifica de forma única el estado. |
Git |
Estado del estado. |
Identity |
|
Properties |
La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con ) |
Reference |
Clase que se va a representar una colección de vínculos de referencia de REST. |
GitPullRequestStatus
Esta clase contiene los metadatos de un estado de solicitud de incorporación de cambios de publicación de servicio o extensión. El estado se puede asociar a una solicitud de incorporación de cambios o a una iteración.
Nombre | Tipo | Description |
---|---|---|
_links |
Vínculos de referencia. |
|
context |
Contexto del estado. |
|
createdBy |
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. |
iterationId |
integer |
Identificador de la iteración con la que se va a asociar el estado. El valor mínimo es 1. |
properties |
Propiedades personalizadas del estado. |
|
state |
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. |
IdentityRef
Nombre | Tipo | Description |
---|---|---|
_links |
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 |
|
profileUrl |
string |
|
uniqueName |
string |
|
url |
string |
Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo. |
PropertiesCollection
La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con ) TypeCode != TypeCode.Object
excepto .DBNull
Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como una cadena. Byte[] se esperaba como cadena codificada en base64.
Nombre | Tipo | Description |
---|---|---|
count |
integer |
Recuento de propiedades de la colección. |
item |
object |
|
keys |
string[] |
Conjunto de claves de la colección. |
values |
string[] |
Conjunto de valores de la colección. |
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. |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de