Condividi tramite


Query comuni dell'API Graph

Questo argomento illustra alcune query comuni che possono essere usate con l'API di Azure AD Graph. Per altre informazioni sulle operazioni supportate per le query nell'API Graph, vedere Query, opzioni di paging e filtri supportati nell'API di Azure AD Graph.

Importante

Per accedere alle risorse di Azure Active Directory è fortemente consigliabile usare Microsoft Graph anziché l'API di Azure AD Graph. Le attività di sviluppo Microsoft sono ora concentrate su Microsoft Graph e non sono previsti altri miglioramenti per l'API di Azure AD Graph. Può essere ancora opportuno usare questa API in un numero molto limitato di scenari. Per altre informazioni, vedere il post di blog Microsoft Graph or the Azure AD Graph (Microsoft Graph o Azure AD Graph) in Office Developer Center.

Indirizzamento

Le query riportate di seguito fanno tutte riferimento al tenant con un nome di dominio. È possibile sostituire contoso.com con uno dei nomi di dominio registrati del tenant in uso, con l'ID del tenant (GUID) oppure con l'alias MyOrganization (per l'accesso delegato). Per informazioni su altre modalità di definizione del percorso del tenant vedere Definire il percorso di entità e operazioni nell'API Graph.

Esecuzione di query su risorse di livello superiore

Le query comuni seguenti indicano come accedere a risorse di primo livello con l'API Graph usando contoso.com come tenant di esempio. Si noti che per eseguire query su un tenant è necessaria un'intestazione di autorizzazione contenente un token di connessione valido ricevuto da Azure AD.

Risorsa di primo livello Risultati della query URI (per contoso.com)
Risorse di primo livello Viene restituito l'elenco di URI delle risorse di livello superiore per i servizi directory (elencati anche di seguito) https://graph.windows.net/contoso.com?api-version=1.6
Informazioni sulla società Vengono restituite le informazioni sulla società https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6
Contatti Restituisce le informazioni sui contatti aziendali https://graph.windows.net/contoso.com/contacts?api-version=1.6
Users Vengono restituite le informazioni sugli utenti https://graph.windows.net/contoso.com/users?api-version=1.6
Gruppi Vengono restituiti i dati dei gruppi https://graph.windows.net/contoso.com/groups?api-version=1.6
Ruoli della directory Restituisce tutti i ruoli della directory attivati nel tenant https://graph.windows.net/contoso.com/roles?api-version=1.6
SubscribedSkus Vengono restituite le sottoscrizioni del tenant https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6
Metadati di directory Viene restituito un documento dei metadati del servizio in cui viene descritto il modello di dati, vale a dire la struttura e l'organizzazione delle risorse della directory https://graph.windows.net/contoso.com/$metadata?api-version=1.6

Operazioni di query

La tabella seguente mostra alcuni esempi di query eseguite con l'API Graph usando contoso.com come tenant di esempio.

Operazione di query URI (per contoso.com)
Elencare tutti gli utenti e gruppi https://graph.windows.net/contoso.com/users?api-version=1.6

https://graph.windows.net/contoso.com/groups?api-version=1.6
Recuperare il singolo utente specificando objectId o 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
Effettuare una richiesta e filtrare per un utente con displayName uguale a "Jon Doe" https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6
Effettuare una richiesta e filtrare per utenti specifici con firstName uguale a "Jon" https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6
Filtrare per i valori givenName e surname. https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6
Recuperare il singolo gruppo specificando il valore objectId https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6
Recuperare la gestione di un utente https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6
Recuperare l'elenco di report diretti di un utente https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6
Recuperare un elenco di collegamenti ai report diretti di un utente https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6
Recuperare l'elenco di appartenenze di un gruppo https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6
Recuperare un elenco di collegamenti ai membri di un gruppo. https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6
Recuperare l'appartenenza a un gruppo di un utente (non transitiva) https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6
Recuperare un elenco dei gruppi di cui l'utente è un membro (non transitiva) https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6
Effettuare una richiesta e filtrare per gruppi con displayName >= "az" e <= "dz" https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6

Nota: per gli spazi vuoti nella stringa di query è necessario applicare la codifica URL prima di inviare una richiesta. Ad esempio, alla stringa di query https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 seguente deve essere applicata la codifica URL come: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6.