Table of contents

Endereçando entidades e operações da Graph APIAddressing Entities and Operations in the Graph API

Jimaco Brannian|Última Atualização: 19/06/2018
|
2 Colaboradores

Este tópico aborda diferentes alternativas de endereçamento que você pode usar ao endereçar entidades de diretório, chamar funções de diretório, executar consultas no diretório ou realizar operações em entidades de diretório e conjuntos de recursos usando a API do Azure AD Graph.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 obter informações mais detalhadas sobre executar operações ou consultas específicas, abordar entidades de diretório ou chamar funções, consulte o tópico de operações apropriado nesta documentação de referência da API do Azure AD Graph.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

Recomendamos que você use o Microsoft Graph em vez da API do Azure AD Graph para acessar os recursos do Azure Active Directory.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Nossos esforços de implantação agora estão concentrados no Microsoft Graph e não há planos de novos aprimoramento para a API do Azure AD Graph.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.Há um número muito limitado de cenários para os quais a API do Azure AD Graph ainda pode ser adequada. Para saber mais, confira a postagem do blog sobre Microsoft Graph ou Azure AD Graph no Centro de Desenvolvimento do 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.

Endereçamento de locatárioTenant Addressing

É possível endereçar seu locatário em uma de três maneiras:You can address your tenant in one of three ways:

  • Pela ID do objeto de locatário.By tenant object ID.Este é um GUID que foi atribuído quando o locatário foi criado.This is a GUID that was assigned when the tenant was created.Isso é equivalente à propriedade objectId do objeto TenantDetail.It is equivalent to the objectId property of the TenantDetail object.A URL a seguir mostra como abordar os recursos de nível superior do diretório de um locatário usando a ID do 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 nome de domínio verificado (registrado).By verified (registered) domain name.Este é um dos nomes de domínio que são registrados para o locatário.This is one of the domain names that are registered for the tenant.Eles podem ser encontrados na propriedade verifiedDomains do objeto TenantDetail.These can be found in the verifiedDomains property of the TenantDetail object.A URL a seguir mostra como abordar os recursos de nível superior de um locatário que tem o domínio 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.

  • Usando o alias “MyOrganization”.By using the “MyOrganization” alias.Este alias só está disponível quando se usa a autenticação de tipo de código de autorização do OAuth (3 pernas).This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.O alias não diferencia maiúsculas de minúsculas.The alias is not case sensitive.Ele substitui a ID de objeto ou o domínio de locatário na URL.It replaces the object ID or tenant domain in the URL.Quando o alias é usado, a Graph API deriva o locatário das reivindicações apresentadas no token anexado à solicitação.When the alias is used, Graph API derives the tenant from the claims presented in the token attached to the request.A URL a seguir mostra como abordar os recursos de nível superior de um locatário usando o 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.

  • Usando o alias “Me”.By using the “Me” alias.Este alias só está disponível quando se usa a autenticação de tipo de código de autorização do OAuth (3 pernas).This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.O alias não diferencia maiúsculas de minúsculas.The alias is not case sensitive.Ele substitui a ID de objeto ou o domínio de locatário na URL.It replaces the object ID or tenant domain in the URL.Quando o alias é usado, a Graph API deriva o usuário das reivindicações apresentadas no token anexado à solicitação.When the alias is used, Graph API derives the user from the claims presented in the token attached to the request.A URL a seguir pode ser usada para chamar a função getMemberGroups para retornar as associações de grupo transitivas do usuário atual: 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.(Observação: um corpo de solicitação também deve ser fornecido com a solicitação POST.)(Note: a request body must also be supplied with the POST request.)

Consulte TambémSee Also

Opções de Filtros de Consultas e Paginação com Suporte da API do Azure AD GraphAzure AD Graph API Supported Queries, Filters, and Paging Options

Referência da API REST do Azure AD GraphAzure AD Graph REST API Reference

© 2018 Microsoft