Compartilhar via


Pull Request Reviewers - List

Recuperar os revisores para uma solicitação de pull

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
path True

string

O nome da organização do Azure DevOps.

pullRequestId
path True

integer (int32)

ID da solicitação de pull.

repositoryId
path True

string

A ID do repositório do branch de destino da solicitação de pull.

project
path

string

ID do projeto ou nome do projeto

api-version
query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.

Respostas

Nome Tipo Description
200 OK

IdentityRefWithVote[]

operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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

Escopos

Nome Description
vso.code Concede a capacidade de ler o código-fonte e metadados sobre commits, conjuntos de alterações, branches e outros artefatos de controle de versão. Também concede a capacidade de pesquisar código e ser notificado sobre eventos de controle de versão por meio de ganchos de serviço.

Exemplos

Solicitação de exemplo

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

Resposta de exemplo

{
  "count": 1,
  "value": [
    {
      "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"
    }
  ]
}

Definições

Nome Description
IdentityRefWithVote

Informações de identidade, incluindo uma votação em uma solicitação de pull.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

IdentityRefWithVote

Informações de identidade, incluindo uma votação em uma solicitação de pull.

Nome Tipo Description
_links

ReferenceLinks

Este campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.

descriptor

string

O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo em contas e organizações.

directoryAlias

string

Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef

displayName

string

Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.

hasDeclined

boolean

Indica se esse revisor se recusou a examinar essa solicitação de pull.

id

string

imageUrl

string

Preterido – Disponível na entrada "avatar" do dicionário "_links" do IdentityRef

inactive

boolean

Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser

isAadIdentity

boolean

Preterido – pode ser adiado do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

isFlagged

boolean

Indica se esse revisor está sinalizado para atenção nesta solicitação de pull.

isReapprove

boolean

Indica se essa votação de aprovação ainda deve ser tratada, mesmo que a votação não tenha sido alterada.

isRequired

boolean

Indica se esse é um revisor necessário para essa solicitação de pull.
Os branches podem ter políticas que exigem revisores específicos para solicitações de pull.

profileUrl

string

Preterido - não em uso na maioria das implementações pré-existentes de ToIdentityRef

reviewerUrl

string

URL para recuperar informações sobre essa identidade

uniqueName

string

Preterido – use Domain+PrincipalName em vez disso

url

string

Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

vote

integer (int16)

Vote em uma solicitação de pull:
10 - aprovado 5 - aprovado com sugestões 0 - sem votação -5 - aguardando autor -10 - rejeitado

votedFor

IdentityRefWithVote[]

Grupos ou equipes para os quais este revisor contribuiu.
Grupos e equipes podem ser revisores em solicitações de pull, mas não podem votar diretamente. Quando um membro do grupo ou da equipe vota, essa votação é acumulada no grupo ou na votação da equipe. VotedFor é uma lista desses votos.

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.