Table of contents

Dirigirse a entidades y operaciones en la API Graph

Jimaco Brannian|Última actualización: 07/09/2016
|
1 Colaborador

En este tema se tratan las distintas alternativas de direccionamiento que se pueden usar para dirigirse a entidades de directorio, llamar a funciones de directorio, realizar consultas en el directorio o realizar operaciones en entidades de directorio y conjuntos de recursos mediante la API Graph de Azure AD. Para más información sobre cómo realizar operaciones o consultas específicas, dirigirse a entidades de directorio o llamar a funciones, consulte el tema de operaciones apropiado en la documentación de referencia de la API Graph de Azure AD .

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.

Dirigirse a inquilinos

Puedes dirigirte a tu inquilino de tres maneras distintas:

  • Por identificador de objeto de inquilino. Se trata de un GUID que se asignó al crearse el inquilino. Equivale a la propiedad objectId del objeto TenantDetail. La siguiente dirección URL muestra cómo abordar los recursos de nivel superior de un directorio de inquilino mediante el identificador de objeto: https://graph.windows.net/12345678-9abc-def0-1234-56789abcde/?api-version=1.6.

  • Por nombre de dominio comprobado (registrado). Se trata de uno de los nombres de dominio registrados para el inquilino. Estos se pueden encontrar en la propiedad verifiedDomains del objeto TenantDetail. La siguiente dirección URL muestra cómo abordar los recursos de nivel superior de un inquilino que tiene el dominio contoso.com https://graph.windows.net/contoso.com/?api-version=1.6.

  • Mediante el alias “MyOrganization”. Este alias solo está disponible al usar la autenticación de tipo de concesión de código de autorización OAuth (3 segmentos). El alias no distingue entre mayúsculas y minúsculas. Reemplaza el identificador de objeto o el dominio de inquilino en la dirección URL. Cuando se usa el alias, la API Graph deriva el inquilino desde las notificaciones presentadas en el token adjunto a una solicitud. La siguiente dirección URL muestra cómo abordar los recursos de nivel superior de un inquilino mediante este alias https://graph.windows.net/myorganization/?api-version=1.6.

  • Mediante el alias “Me”. Este alias solo está disponible al usar la autenticación de tipo de concesión de código de autorización OAuth (3 segmentos). El alias no distingue entre mayúsculas y minúsculas. Reemplaza el identificador de objeto o el dominio de inquilino en la dirección URL. Cuando se usa el alias, la API Graph deriva el usuario desde las notificaciones presentadas en el token adjunto a la solicitud. Se puede usar la dirección URL siguiente para llamar a la función getMemberGroups para devolver la pertenencia transitiva a grupos del usuario actual: https://graph.windows.net/me/getMemberGroups?api-version=1.6. (Nota: También debe proporcionarse un cuerpo de la solicitud con la solicitud POST).

Véase también

Consultas, filtros y opciones de paginación admitidos con la API Graph de Azure AD

Referencia de la API de REST Graph de Azure AD

© 2017 Microsoft