Esporta (0) Stampa
Espandi tutto

Query comuni dell'API di Azure AD Graph

Aggiornamento: aprile 2014

In questo argomento vengono elencate query comuni che possono essere utilizzate con Azure AD Graph. Per ulteriori informazioni sulle operazioni supportate quando si eseguono query su Graph, vedere Query, opzioni di paging e filtri supportati in Azure AD Graph.

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 per eseguire correttamente le query sulla sottoscrizione. Per informazioni su altre modalità di indirizzamento del tenant, vedere Indirizzamento delle entità e delle operazioni nell'API Graph.

Le query comuni riportate di seguito indicano come accedere a risorse di livello superiore in Graph tramite contoso.com come tenant di esempio.

 

Risorse di livello superiore Risultati della query URI (per contoso.com)

Risorse di livello superiore

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=2013-04-05

Informazioni sulla società

Vengono restituite le informazioni sulla società

https://graph.windows.net/contoso.com/tenantDetails?api-version=2013-04-05

Contatti

Vengono restituite le informazioni sui contatti

https://graph.windows.net/contoso.com/contacts?api-version=2013-04-05

Utenti

Vengono restituite le informazioni sugli utenti

https://graph.windows.net/contoso.com/users?api-version=2013-04-05

Gruppi

Vengono restituiti i dati dei gruppi

https://graph.windows.net/contoso.com/groups?api-version=2013-04-05

Ruoli

Vengono restituiti tutti i ruoli a cui sono associati utenti o gruppi

https://graph.windows.net/contoso.com/roles?api-version=2013-04-05

SubscribedSkus

Vengono restituite le sottoscrizioni del tenant

https://graph.windows.net/contoso.com/subscribedSkus?api-version=2013-04-05

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=2013-04-05

Le query comuni riportate di seguito indicano come eseguire un'operazione di query in Graph tramite 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=2013-04-05

https://graph.windows.net/contoso.com/groups?api-version=2013-04-05

Recuperare il singolo utente specificando objectId o userPrincipalName

https://graph.windows.net/contoso.com/users/d1f67a6c-02c9-4fe5-81fb-58160ce24fe5?api-version=2013-04-05

https://graph.windows.net/contoso.com/users/admin@contoso.com?api-version=2013-04-05

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=2013-04-05

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=2013-04-05

Filtrare per i valori givenName e surname.

https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=2013-04-05

Recuperare il singolo gruppo specificando il valore objectId

https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=2013-04-05

Recuperare la gestione di un utente

https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=2013-04-05

Recuperare l'elenco di report diretti di un utente

https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=2013-04-05

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=2013-04-05

Recuperare l'elenco di appartenenze di un gruppo

https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=2013-04-05

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=2013-04-05

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=2013-04-05

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=2013-04-05

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=2013-04-05

noteNota
Lo spazio vuoto nella stringa di query deve essere con codifica URL prima di inviare una richiesta. La stringa di query https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=2013-04-05, ad esempio, deve essere codificata come URL, ovvero https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=2013-04-05.

Vedere anche

Mostra:
© 2014 Microsoft