Listar directReportsList directReports

Namespace: microsoft.graphNamespace: microsoft.graph

Obtenha relatórios diretos do usuário.Get a user's direct reports.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllUser.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporteNot supported
AplicativoApplication User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.AllUser.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Quando um aplicativo consulta um relacionamento que retorna uma coleção de tipos de directoryobject, se ele não tiver permissão para ler um determinado tipo derivado (como dispositivo), os membros desse tipo serão retornados, mas com informações limitadas.When an application queries a relationship that returns a directoryObject type collection, if it does not have permission to read a certain derived type (like device), members of that type are returned but with limited information. Com esse comportamento, os aplicativos podem solicitar as permissões menos privilegiadas necessárias, em vez de confiar no conjunto de permissões de Directory. *.With this behaviour applications can request the least privileged permissions they need, rather than rely on the set of Directory.* permissions. Para obter detalhes, consulte informações limitadas retornadas para objetos membro inacessíveis.For details, see Limited information returned for inaccessible member objects.

Solicitação HTTPHTTP request

GET /me/directReports
GET /users/{id | userPrincipalName}/directReports

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the OData query parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se bem-sucedido, este método retorna um código de resposta 200 OK e uma coleção de objetos directoryObject no corpo da resposta.If successful, this method returns a 200 OK response code and a collection of directoryObject objects in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/directReports

RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 55

{
  "value": [
    {
      "id": "id-value"
    }
  ]
}