Condividi tramite


Pull Request Reviewers - Get

Recuperare informazioni su un revisore specifico in una richiesta pull

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
path True

string

Nome dell'organizzazione di Azure DevOps.

pullRequestId
path True

integer (int32)

ID della richiesta pull.

repositoryId
path True

string

ID repository del ramo di destinazione della richiesta pull.

reviewerId
path True

string

ID del revisore.

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

IdentityRefWithVote

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.

Esempio

Esempio di richiesta

GET https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/{reviewerId}?api-version=7.1

Risposta di esempio

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

Definizioni

Nome Descrizione
IdentityRefWithVote

Informazioni sull'identità, tra cui un voto su una richiesta pull.

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

IdentityRefWithVote

Informazioni sull'identità, tra cui un voto su una richiesta pull.

Nome Tipo Descrizione
_links

ReferenceLinks

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.

hasDeclined

boolean

Indica se il revisore ha rifiutato di esaminare questa richiesta pull.

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

isFlagged

boolean

Indica se il revisore è contrassegnato per l'attenzione su questa richiesta pull.

isReapprove

boolean

Indica se il voto approvato deve comunque essere gestito anche se il voto non è stato modificato.

isRequired

boolean

Indica se si tratta di un revisore obbligatorio per questa richiesta pull.
I rami possono avere criteri che richiedono revisori specifici sono necessari per le richieste pull.

profileUrl

string

Deprecato: non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef

reviewerUrl

string

URL per recuperare informazioni su questa identità

uniqueName

string

Deprecato: usare invece Domain+PrincipalName

url

string

Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

vote

integer (int16)

Votare su una richiesta pull:
10 - approvato 5 - approvato con suggerimenti 0 - nessun voto -5 - in attesa di -10 autore - rifiutato

votedFor

IdentityRefWithVote[]

Gruppi o team a cui ha contribuito questo revisore.
I gruppi e i team possono essere revisori nelle richieste pull, ma non possono votare direttamente. Quando un membro del gruppo o dei voti del team, tale voto viene inserito nel gruppo o nel voto del team. VotedFor è un elenco di tali voti.

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.