Consulta da Graph API comuns
Este tópico mostra algumas consultas comuns que podem ser efetuadas com a Azure AD Graph API. Para obter mais informações sobre as operações suportadas ao consultar o gráfico, consulte suportadas consultas, filtros e as opções de paginação no AD Graph API do Azure.
Importante
Recomendamos vivamente que utilize Microsoft Graph em vez do AD Graph API do Azure para aceder aos recursos do Azure Active Directory. A nossa esforços de desenvolvimento são agora concentrated no Microsoft Graph e estão a ser planeados sem melhoramentos adicionais para AD Graph API do Azure. Existem um número muito limitado de cenários para o qual AD Graph API do Azure ainda poderá ser apropriado; Para obter mais informações, consulte o Microsoft Graph ou o Azure AD Graph blogue no Dev Center do Office.
Endereçamento
As consultas abaixo todos os endereços de inquilino utilizando um nome de domínio. Pode substituir contoso.com com um dos nomes de domínio registado do seu inquilino, com o ID do inquilino (GUID) ou com o MyOrganization alias (para acesso delegado). Para obter informações sobre outras formas de endereçamento de inquilino, consulte endereçamento entidades e operações na Graph API.
Consulta de recursos de nível superior
As seguintes consultas comuns demonstram como aceder a recursos de nível superior com a Graph API utilizando contoso.com como o inquilino de exemplo. Tenha em atenção que um cabeçalho de autorização que contém um token de portador válido recebido do Azure AD irá ser necessário para executar consultas contra um inquilino.
| Recurso de nível superior | Resultados da consulta | URI (para contoso.com) |
|---|---|---|
| Recursos de nível superior | Devolve URI lista dos recursos de nível superior dos serviços do directory (também listados abaixo) | https://graph.windows.net/contoso.com?api-version=1.6 |
| Informações da empresa | Devolve informações de empresa | https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6 |
| Contactos | Informações de contacto devolve organizacional | https://graph.windows.net/contoso.com/contacts?api-version=1.6 |
| Users | Devolve informações do utilizador | https://graph.windows.net/contoso.com/users?api-version=1.6 |
| Grupos | Devolve dados de grupo | https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| Funções de diretório | Devolve todas as funções de diretório ativada no inquilino do | https://graph.windows.net/contoso.com/roles?api-version=1.6 |
| SubscribedSkus | Devolve a subscrições do inquilino | https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6 |
| Metadados do diretório | Devolve um documento de metadados do serviço que descreve o modelo de dados (ou seja, a estrutura e a organização de recursos de diretório) | https://graph.windows.net/contoso.com/$metadata?api-version=1.6 |
Operações de consulta
A tabela seguinte mostra alguns exemplos de consultas de Graph API utilizando utilizando contoso.com como o inquilino de exemplo.
| Operação de consulta | URI (para contoso.com) |
|---|---|
| Listar todos os utilizadores e grupos | https://graph.windows.net/contoso.com/users?api-version=1.6 https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| Obter utilizadores individuais especificando o objectId ou userPrincipalName | https://graph.windows.net/contoso.com/users/d1f67a6c-02c9-4fe5-81fb-58160ce24fe5?api-version=1.6 https://graph.windows.net/contoso.com/users/admin@contoso.com?api-version=1.6 |
| Pedir e filtrar para um utilizador com o displayName igual a "Jon Silva" | https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 |
| Pedir e filtrar para utilizadores específicos com firstName igual a "Jon" | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6 |
| Filtrar por valores givenName e apelido. | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6 |
| Obter grupo individuais especificando o objectId | https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6 |
| Obter o Gestor do utilizador | https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6 |
| Obter a lista de relatórios diretos de um utilizador | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6 |
| Obter uma lista de ligações para relatórios diretos de um utilizador | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6 |
| Obter a lista de membros de um grupo | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6 |
| Obter uma lista de ligações para os membros de um grupo. | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6 |
| Obter associação a grupos do utilizador (não transitiva) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6 |
| Obter uma lista dos grupos de que o utilizador é membro de (não transitiva) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6 |
| Pedido e filtrar grupos com o displayName > = "az" e < = "dz" | https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6 |
Tenha em atenção: o espaço em branco na cadeia de consulta deve ser com codificação URL antes de enviar um pedido. Por exemplo, a seguinte consulta cadeia, https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6, deve ser URL codificado como: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6.