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
.