Table of contents

Dirigirse a entidades y operaciones en la API GraphAddressing Entities and Operations in the Graph API

Jimaco Brannian|Última actualización: 19/06/2018
|
2 Colaboradores

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.This topic discusses different addressing alternatives that you can use when addressing directory entities, calling directory functions, performing queries against the directory, or performing operations on directory entities and resource sets using Azure AD Graph API.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 .For more detailed information about performing specific operations or queries, addressing directory entities, or calling functions, see the appropriate operations topic in the Azure AD Graph API reference documentation.

Importante

Se recomienda encarecidamente que utilice Microsoft Graph en lugar de la API de Azure AD Graph para tener acceso a recursos de Azure Active Directory.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Nuestros esfuerzos de desarrollo se concentran ahora en Microsoft Graph y no están previstas mejoras adicionales para la API de Azure AD Graph.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.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.There are a very limited number of scenarios for which Azure AD Graph API might still be appropriate; for more information, see the Microsoft Graph or the Azure AD Graph blog post in the Office Dev Center.

Dirigirse a inquilinosTenant Addressing

Puedes dirigirte a tu inquilino de tres maneras distintas:You can address your tenant in one of three ways:

  • Por identificador de objeto de inquilino.By tenant object ID.Se trata de un GUID que se asignó al crearse el inquilino.This is a GUID that was assigned when the tenant was created.Equivale a la propiedad objectId del objeto TenantDetail.It is equivalent to the objectId property of the TenantDetail object.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.The following URL shows how to address the top-level resources of a tenant’s directory by using the object ID: https://graph.windows.net/12345678-9abc-def0-1234-56789abcde/?api-version=1.6.

  • Por nombre de dominio comprobado (registrado).By verified (registered) domain name.Se trata de uno de los nombres de dominio registrados para el inquilino.This is one of the domain names that are registered for the tenant.Estos se pueden encontrar en la propiedad verifiedDomains del objeto TenantDetail.These can be found in the verifiedDomains property of the TenantDetail object.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.The following URL shows how to address the top-level resources of a tenant that has the domain contoso.com: https://graph.windows.net/contoso.com/?api-version=1.6.

  • Mediante el alias “MyOrganization”.By using the “MyOrganization” alias.Este alias solo está disponible al usar la autenticación de tipo de concesión de código de autorización OAuth (3 segmentos).This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.El alias no distingue entre mayúsculas y minúsculas.The alias is not case sensitive.Reemplaza el identificador de objeto o el dominio de inquilino en la dirección URL.It replaces the object ID or tenant domain in the URL.Cuando se usa el alias, la API Graph deriva el inquilino desde las notificaciones presentadas en el token adjunto a una solicitud.When the alias is used, Graph API derives the tenant from the claims presented in the token attached to the request.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.The following URL shows how to address the top-level resources of a tenant using this alias: https://graph.windows.net/myorganization/?api-version=1.6.

  • Mediante el alias “Me”.By using the “Me” alias.Este alias solo está disponible al usar la autenticación de tipo de concesión de código de autorización OAuth (3 segmentos).This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.El alias no distingue entre mayúsculas y minúsculas.The alias is not case sensitive.Reemplaza el identificador de objeto o el dominio de inquilino en la dirección URL.It replaces the object ID or tenant domain in the URL.Cuando se usa el alias, la API Graph deriva el usuario desde las notificaciones presentadas en el token adjunto a la solicitud.When the alias is used, Graph API derives the user from the claims presented in the token attached to the request.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.The following URL can be used to call the getMemberGroups function to return the transitive group memberships of the current user: https://graph.windows.net/me/getMemberGroups?api-version=1.6.(Nota: También debe proporcionarse un cuerpo de la solicitud con la solicitud POST).(Note: a request body must also be supplied with the POST request.)

Véase tambiénSee Also

Consultas, filtros y opciones de paginación admitidos con la API de Azure AD GraphAzure AD Graph API Supported Queries, Filters, and Paging Options

Referencia de la API de REST de Azure AD GraphAzure AD Graph REST API Reference

© 2018 Microsoft