Table of contents

Consultas comunes de la API Graph

Jimaco Brannian|Última actualización: 22/08/2016
|
1 Colaborador

En este tema se muestran algunas consultas comunes que se pueden realizar con la API Graph de Azure AD. Para más información sobre las operaciones admitidas al consultar Graph, consulte Consultas, filtros y opciones de paginación admitidos con la API de Azure AD Graph.

Importante: La funcionalidad de la API de Azure AD Graph también se encuentra disponible a través de Microsoft Graph, una API unificada que también incluye las API de otros servicios Microsoft como Outlook, OneDrive, OneNote, Planner y Office Graph, todos ellos accesibles a través de un solo punto de conexión con un solo token de acceso.

Direccionamiento

Todas las consultas siguientes se dirigen al inquilino mediante un nombre de dominio. Puede reemplazar contoso.com por uno de los nombres de dominio registrados de su inquilino, por el identificador de su inquilino (GUID) o por el alias MyOrganization (para acceso delegado). Para obtener información sobre otras maneras de dirigirse al inquilino, consulte Dirigirse a entidades y operaciones en la API Graph.

Consulta de recursos de nivel superior

Las siguientes consultas comunes muestran cómo acceder a recursos de nivel superior con la API Graph mediante contoso.com como inquilino de ejemplo. Tenga en cuenta que será necesario un encabezado Authorization que contenga un token de portador válido recibido de Azure AD para ejecutar consultas en un inquilino.

Recurso de nivel superiorResultados de la consultaURI (para contoso.com)
Recursos de nivel superiorDevuelve la lista de URI de los recursos de nivel superior para los servicios de directorio (también se muestran a continuación)https://graph.windows.net/contoso.com?api-version=1.6
Información de la compañíaDevuelve información de la compañíahttps://graph.windows.net/contoso.com/tenantDetails?api-version=1.6
ContactosDevuelve información de contacto organizativahttps://graph.windows.net/contoso.com/contacts?api-version=1.6
UsuariosDevuelve información de usuarioshttps://graph.windows.net/contoso.com/users?api-version=1.6
GruposDevuelve datos de gruposhttps://graph.windows.net/contoso.com/groups?api-version=1.6
Roles de directorioDevuelve todos los roles de directorio activados en el inquilinohttps://graph.windows.net/contoso.com/roles?api-version=1.6
SubscribedSkusDevuelve las suscripciones del inquilinohttps://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6
Metadatos de directorioDevuelve 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=1.6

Operaciones de consulta

La siguiente tabla muestra algunos ejemplos de consultas de la API Graph que utilizan contoso.com como inquilino de ejemplo.

Operación de consultaURI (para contoso.com)
Mostrar todos los usuarios y gruposhttps://graph.windows.net/contoso.com/users?api-version=1.6

https://graph.windows.net/contoso.com/groups?api-version=1.6
Recuperar un usuario individual especificando objectId o userPrincipalNamehttps://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
Solicitud y filtrado de un usuario cuyo displayName es igual a "Jon Doe"https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6
Solicitar y filtrar usuarios específicos cuyo firstName es igual que "Jon"https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6
Filtrar por valores givenName y surnamehttps://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6
Recuperar un grupo individual especificando objectIdhttps://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6
Recuperar el administrador de un usuariohttps://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6
Recuperar la lista de subordinados directos de un usuariohttps://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6
Recuperar una lista de vínculos a los subordinados directos de un usuariohttps://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6
Recuperar la lista de pertenencias de un grupohttps://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6
Recuperar una lista de vínculos a los miembros de un grupohttps://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6
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=1.6
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=1.6
Solicitud y filtrado para grupos con displayName >= "az" y <= "dz"https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6

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

© 2017 Microsoft