Exportar (0) Imprimir
Expandir todo

Consultas comunes de la API Graph de Azure AD

Actualizado: abril de 2014

En este tema se enumeran las consultas comunes que se pueden usar con Azure AD Graph. Para obtener más información acerca de las operaciones admitidas al consultar el gráfico, vea Consultas admitidas, filtros y opciones de paginación en Azure AD Graph.

Todas las consultas siguientes se dirigen al inquilino mediante un nombre de dominio. Puede reemplazar contoso.com con uno de los nombres de dominio registrados del inquilino para ejecutar correctamente las consultas en su suscripción. Para obtener información sobre otras maneras de dirigirse al inquilino, vea Dirigirse a entidades y operaciones en la API Graph.

Las siguientes consultas comunes demuestran cómo acceder a recursos de nivel superior en el gráfico utilizando contoso.com como inquilino de ejemplo.

 

Recursos de nivel superior Resultados de la consulta URI (para contoso.com)

Recursos de nivel superior

Devuelve la lista de URI de los recursos de nivel superior para los servicios de directorio (también se muestran abajo)

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

Información de la compañía

Devuelve información de la compañía

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

Contacts

Devuelve información de contacto

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

Users

Devuelve información de usuarios

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

Groups

Devuelve datos de grupos

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

Roles

Devuelve todos los roles que tienen usuarios o grupos asignados

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

SubscribedSkus

Devuelve las suscripciones del inquilino

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

Metadatos del directorio

Devuelve un documento de metadatos del servicio que describe el modelo de datos (es decir, la estructura y la organización de los recursos del directorio)

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

Las siguientes consultas comunes demuestran cómo llevar a cabo una operación de consulta en el gráfico utilizando contoso.com como inquilino de ejemplo.

 

Operación de consulta URI (para contoso.com)

Mostrar todos los usuarios y grupos

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

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

Recuperar un usuario individual especificando 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

Solicitar y filtrar un usuario cuyo displayName es igual a "Jon Doe"

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

Solicitar y filtrar usuarios específicos cuyo firstName es igual a "Jon"

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

Filtrar por valores givenName y surname.

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

Recuperar un grupo individual especificando objectId

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

Recuperar el jefe de un usuario

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

Recuperar la lista de personas que dependen directamente de un usuario

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

Recuperar una lista de vínculos a las personas que dependen directamente de un usuario

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

Recuperar la lista de pertenencias de un grupo

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

Recuperar una lista de vínculos a los miembros de un grupo.

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

Recuperar la pertenencia a grupos de un usuario (no transitiva)

https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=2013-04-05

Recuperar una lista de los grupos de los que el usuario es miembro (no transitiva)

https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=2013-04-05

Solicitar y filtrar los grupos cuyo displayName => 'az' y <= 'dz'

https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=2013-04-05

noteNota
El espacio en blanco de la cadena de consulta debe codificarse para URL antes de enviar una solicitud. Por ejemplo, la cadena de consulta siguiente, https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=2013-04-05, debe codificarse para URL como: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=2013-04-05.

Vea también

Mostrar:
© 2015 Microsoft