Table of contents

Adresování entity a operace v grafu, pro rozhraní APIAddressing Entities and Operations in the Graph API

Jimaco Brannian|Poslední aktualizace: 19. 6. 2018
|
1 Přispěvatel

Toto téma popisuje různé adresování alternativy, které můžete použít při zadávání adresy directory entity volání funkce adresáře, provádění dotazů vůči adresáři, nebo provádění operací na adresář entity a prostředků nastaví pomocí služby Azure AD Rozhraní Graph API.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.Podrobné informace o provádění konkrétní operace nebo dotazy, adresování directory entit nebo volání funkcí, naleznete v tématu příslušné operace v referenční dokumentace rozhraní API 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.

Důležité

Důrazně doporučujeme použít Microsoft Graph místo Azure AD Graph API pro přístup k prostředkům Azure Active Directory.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro Azure AD Graph API.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.Je velmi omezený počet scénářů, pro které Azure AD Graph API může být vhodné; Další informace najdete v tématu Microsoft Graph nebo Azure AD Graph příspěvku na blogu v Office Dev Center.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.

Adresování klientaTenant Addressing

Můžete vyřešit vašeho klienta v jednom ze tří způsobů:You can address your tenant in one of three ways:

  • ID objektu klientem.By tenant object ID.Toto je identifikátor GUID, který byl přiřazen při vytvoření klienta.This is a GUID that was assigned when the tenant was created.Ta je ekvivalentní objectId vlastnost TenantDetail objektu.It is equivalent to the objectId property of the TenantDetail object.Následující adresa URL ukazuje, jak vyřešit nejvyšší úrovně prostředky klienta adresáře pomocí ID objektu: 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.

  • Pomocí ověření (registrovaný) název domény.By verified (registered) domain name.Toto je jedna z názvů domén, které jsou registrovány pro klienta.This is one of the domain names that are registered for the tenant.Ty lze najít v verifiedDomains vlastnost TenantDetail objektu.These can be found in the verifiedDomains property of the TenantDetail object.Následující adresa URL ukazuje, jak vyřešit nejvyšší úrovně prostředky klienta, který má doménu 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.

  • Pomocí alias "TatoOrganizace".By using the “MyOrganization” alias.Tento alias je dostupná jenom při použití ověřování (s rameny-3) typ udělení autorizačního kódu OAuth.This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.Alias se nerozlišují malá a velká písmena.The alias is not case sensitive.Nahradí objekt domény ID nebo klienta v adrese URL.It replaces the object ID or tenant domain in the URL.Pokud alias se používá, rozhraní Graph API klienta odvozená z deklarací identity předkládaných v tokenu připojené k požadavku.When the alias is used, Graph API derives the tenant from the claims presented in the token attached to the request.Následující adresa URL ukazuje, jak vyřešit nejvyšší úrovně prostředků klienta pomocí tento 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.

  • Pomocí "Mě" alias.By using the “Me” alias.Tento alias je dostupná jenom při použití ověřování (s rameny-3) typ udělení autorizačního kódu OAuth.This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.Alias se nerozlišují malá a velká písmena.The alias is not case sensitive.Nahradí objekt domény ID nebo klienta v adrese URL.It replaces the object ID or tenant domain in the URL.Pokud alias se používá, rozhraní Graph API odvozená z deklarací identity předkládaných v připojené k žádosti o token uživatele.When the alias is used, Graph API derives the user from the claims presented in the token attached to the request.Následující adresa URL je možné volat getMemberGroups funkci vrátíte přenositelné členství ve skupinách aktuálního uživatele: 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.(Poznámka: textu požadavku musí být uveden také s požadavek POST.)(Note: a request body must also be supplied with the POST request.)

Viz takéSee Also

Azure AD Graph API podporován dotazy, filtrů a možností stránkováníAzure AD Graph API Supported Queries, Filters, and Paging Options

Referenční dokumentace rozhraní API REST Azure AD GraphAzure AD Graph REST API Reference

© 2018 Microsoft