Partilhar via

Endereçamento entidades e operações no gráfico de API

  • Artigo

Este tópico aborda as alternativas endereçamento diferentes que pode utilizar ao endereçamento entidades de diretório, chamar as funções de diretório, executar consultas contra o diretório ou efetuar operações em entidades de diretório e recursos define a utilizar o Azure AD Graph API. Para obter mais informações sobre a realização de operações específicas ou consultas, endereçamento entidades de diretório ou chamar as funções, consulte o tópico de adequadas no documentação de referência da API do Azure AD Graph.

Importante

Recomendamos vivamente que utilize Microsoft Graph em vez do AD Graph API do Azure para aceder aos recursos do Azure Active Directory. A nossa esforços de desenvolvimento são agora concentrated no Microsoft Graph e estão a ser planeados sem melhoramentos adicionais para AD Graph API do Azure. Existem um número muito limitado de cenários para o qual AD Graph API do Azure ainda poderá ser apropriado; Para obter mais informações, consulte o Microsoft Graph ou o Azure AD Graph blogue no Dev Center do Office.

Endereçamento de inquilino

Pode resolver seu inquilino de uma das três formas:

  • ID de objeto por inquilino. Este é um GUID que foi atribuído quando o inquilino foi criado. É equivalente ao objectId propriedade o TenantDetail objeto. O URL seguinte mostra como a abordar os recursos de nível superior do diretório de um inquilino utilizando o ID de objeto: https://graph.windows.net/12345678-9abc-def0-1234-56789abcde/?api-version=1.6.

  • Ao verificar o nome de domínio (registado). Este é um dos nomes de domínio que estão registados para o inquilino. Pode encontrá-las no verifiedDomains propriedade o TenantDetail objeto. O URL seguinte mostra como a abordar os recursos de nível superior de um inquilino com o domínio contoso.com: https://graph.windows.net/contoso.com/?api-version=1.6.

  • Ao utilizar o alias "MyOrganization". Este alias só está disponível quando utiliza a autenticação de (3-legged) de tipo de conceder de código de autorização do OAuth. O alias não é sensível às maiúsculas e minúsculas. Substitui o domínio de inquilino ou um ID de objeto no URL. Quando é utilizado o alias, Graph API deriva de um inquilino afirmações apresentadas no token anexado ao pedido. O URL seguinte mostra como os recursos de nível superior de um inquilino com este alias de endereço: https://graph.windows.net/myorganization/?api-version=1.6.

  • Ao utilizar o "-Me" alias. Este alias só está disponível quando utiliza a autenticação de (3-legged) de tipo de conceder de código de autorização do OAuth. O alias não é sensível às maiúsculas e minúsculas. Substitui o domínio de inquilino ou um ID de objeto no URL. Quando é utilizado o alias, Graph API deriva de um utilizador afirmações apresentadas no token anexado ao pedido. O seguinte URL pode ser utilizado para chamar o getMemberGroups função para devolver as associações transitiva do utilizador atual: https://graph.windows.net/me/getMemberGroups?api-version=1.6. (Nota: um corpo do pedido também tem de ser fornecido com o pedido POST.)

Consulte Também

Azure AD Graph API suportadas consultas, filtros e as opções de paginação

Referência da API REST do Azure AD Graph