Pull Request Statuses - Get
Ottenere lo stato specifico della richiesta pull in base all'ID. L'ID di stato è univoco all'interno della richiesta pull in tutte le iterazioni.
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses/{statusId}?api-version=7.1
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
organization
|
path | True |
string |
Nome dell'organizzazione di Azure DevOps. |
pull
|
path | True |
integer (int32) |
ID della richiesta pull. |
repository
|
path | True |
string |
ID repository del ramo di destinazione della richiesta pull. |
status
|
path | True |
integer (int32) |
ID dello stato della richiesta pull. |
project
|
path |
string |
ID progetto o nome progetto |
|
api-version
|
query | True |
string |
Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
operazione riuscita |
Sicurezza
oauth2
Tipo:
oauth2
Flow:
accessCode
URL di autorizzazione:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL 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
Ambiti
Nome | Descrizione |
---|---|
vso.code | Concede la possibilità di leggere il codice sorgente e i metadati relativi a commit, insiemi di modifiche, rami e altri artefatti del controllo della versione. Concede inoltre la possibilità di cercare il codice e ricevere notifiche sugli eventi di controllo della versione tramite hook del servizio. |
vso.code_status | Concede la possibilità di leggere e scrivere lo stato di commit e richiesta pull. |
Esempio
Esempio di richiesta
GET https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses/{statusId}?api-version=7.1
Risposta di esempio
{
"id": 1,
"state": "succeeded",
"description": "Sample status succeeded",
"context": {
"name": "sample-status-1",
"genre": "vsts-samples"
},
"creationDate": "2017-09-19T14:50:27.4949745Z",
"updatedDate": "2017-09-19T14:50:27.4949745Z",
"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",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/b92c8408-a0c9-4292-88af-bc005a1b8272/pullRequests/5/statuses/1"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/b92c8408-a0c9-4292-88af-bc005a1b8272"
}
}
}
Definizioni
Nome | Descrizione |
---|---|
Git |
Questa classe contiene i metadati di uno stato della richiesta pull di registrazione di un servizio o di un'estensione. Lo stato può essere associato a una richiesta pull o a un'iterazione. |
Git |
Contesto di stato che identifica in modo univoco lo stato. |
Git |
Stato dello stato. |
Identity |
|
Properties |
La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un |
Reference |
Classe per rappresentare una raccolta di collegamenti di riferimento REST. |
GitPullRequestStatus
Questa classe contiene i metadati di uno stato della richiesta pull di registrazione di un servizio o di un'estensione. Lo stato può essere associato a una richiesta pull o a un'iterazione.
Nome | Tipo | Descrizione |
---|---|---|
_links |
Collegamenti di riferimento. |
|
context |
Contesto dello stato. |
|
createdBy |
Identità che ha creato lo stato. |
|
creationDate |
string (date-time) |
Data e ora di creazione dello stato. |
description |
string |
Descrizione dello stato. Descrive in genere lo stato corrente dello stato. |
id |
integer (int32) |
Identificatore di stato. |
iterationId |
integer (int32) |
ID dell'iterazione a cui associare lo stato. Il valore minimo è 1. |
properties |
Proprietà personalizzate dello stato. |
|
state |
Stato dello stato. |
|
targetUrl |
string |
URL con i dettagli sullo stato. |
updatedDate |
string (date-time) |
Data e ora dell'ultimo aggiornamento dello stato. |
GitStatusContext
Contesto di stato che identifica in modo univoco lo stato.
Nome | Tipo | Descrizione |
---|---|---|
genre |
string |
Genere dello stato. In genere, il nome del servizio o dello strumento che genera lo stato può essere vuoto. |
name |
string |
L'identificatore del nome dello stato non può essere null o vuoto. |
GitStatusState
Stato dello stato.
Valore | Descrizione |
---|---|
error |
Stato con un errore. |
failed |
Stato non riuscito. |
notApplicable |
Lo stato non è applicabile all'oggetto di destinazione. |
notSet |
Stato non impostato. Stato predefinito. |
pending |
Stato in sospeso. |
succeeded |
Stato completato. |
IdentityRef
Nome | Tipo | Descrizione |
---|---|---|
_links |
Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate sull'oggetto grafico. |
|
descriptor |
string |
Il descrittore è il modo principale per fare riferimento all'oggetto del grafo mentre il sistema è in esecuzione. Questo campo identificherà in modo univoco lo stesso soggetto del grafico in account e organizzazioni. |
directoryAlias |
string |
Deprecato: può essere recuperato eseguendo una query sull'utente graph a cui si fa riferimento nella voce "self" del dizionario IdentityRef "_links" |
displayName |
string |
Si tratta del nome visualizzato non univoco dell'oggetto del grafico. Per modificare questo campo, è necessario modificarne il valore nel provider di origine. |
id |
string |
|
imageUrl |
string |
Deprecato : disponibile nella voce "avatar" del dizionario IdentityRef "_links" |
inactive |
boolean |
Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza graph a cui si fa riferimento nella voce "membershipState" del dizionario "_links" GraphUser |
isAadIdentity |
boolean |
Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
isContainer |
boolean |
Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType) |
isDeletedInOrigin |
boolean |
|
profileUrl |
string |
Deprecato: non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef |
uniqueName |
string |
Deprecato: usare invece Domain+PrincipalName |
url |
string |
Questo URL è la route completa alla risorsa di origine di questo oggetto grafico. |
PropertiesCollection
La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object
) ad eccezione di DBNull
vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono ricreate come String. Byte[] previsto come stringa con codifica Base64.
Nome | Tipo | Descrizione |
---|---|---|
count |
integer (int32) |
Conteggio delle proprietà nell'insieme. |
item |
object |
|
keys |
string[] |
Set di chiavi nella raccolta. |
values |
string[] |
Set di valori nell'insieme. |
ReferenceLinks
Classe per rappresentare una raccolta di collegamenti di riferimento REST.
Nome | Tipo | Descrizione |
---|---|---|
links |
object |
Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura. |