Consultas comunes de Graph API
En este tema se muestran algunas consultas comunes que se pueden realizar con la API de Azure AD Graph. Para obtener 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
Se recomienda encarecidamente que use Microsoft Graph en lugar de la API de Azure AD Graph para acceder a recursos de Azure Active Directory. Nuestros esfuerzos de desarrollo se concentran ahora en Microsoft Graph y no están previstas mejoras adicionales para la API de Azure AD Graph. Hay un número muy limitado de escenarios para los que la API de Azure AD Graph todavía podría ser adecuada; para más información, vea la entrada del blog Microsoft Graph o Azure AD Graph en el centro de desarrollo de Office.
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 Graph API.
Consulta de recursos de nivel superior
Las siguientes consultas comunes muestran cómo acceder a recursos de nivel superior con Graph API 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 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 a continuación) | https://graph.windows.net/contoso.com?api-version=1.6 |
| Información de la compañía | Devuelve información de la compañía | https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6 |
| Contactos | Devuelve información de contacto organizativa | https://graph.windows.net/contoso.com/contacts?api-version=1.6 |
| Usuarios | Devuelve información de usuarios | https://graph.windows.net/contoso.com/users?api-version=1.6 |
| Grupos | Devuelve datos de grupos | https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| Roles de directorio | Devuelve todos los roles de directorio activados en el inquilino | https://graph.windows.net/contoso.com/roles?api-version=1.6 |
| SubscribedSkus | Devuelve las suscripciones del inquilino | https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6 |
| Metadatos de 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=1.6 |
Operaciones de consulta
En la siguiente tabla se muestran algunos ejemplos de consultas de Graph API que usan 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=1.6 https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| Recuperar un usuario individual especificando 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 |
| 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 surname | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6 |
| Recuperar un grupo individual especificando objectId | https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6 |
| Recuperar el administrador de un usuario | https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6 |
| Recuperar la lista de subordinados directos de un usuario | https://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 usuario | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6 |
| Recuperar la lista de pertenencias de un grupo | https://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 grupo | https://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.