Adresování entity a operace v grafu, pro rozhraní API
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. 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.
Informace o provádění dotazů vůči adresáři, najdete v článku Azure AD Graph API podporován dotazy, filtrů a stránkování možnosti.
Informace o directory entity a operace, které lze provést na ně, a také o funkcích, které jsou zpřístupněny grafem najdete v tématu relevantní téma v Azure AD Graph REST API – referenční informace.
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. Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro 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.
Adresování klienta
Můžete vyřešit vašeho klienta v jednom ze tří způsobů:
ID objektu klientem. Toto je identifikátor GUID, který byl přiřazen při vytvoření klienta. Ta je ekvivalentní objectId vlastnost TenantDetail objektu. 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.Pomocí ověření (registrovaný) název domény. Toto je jedna z názvů domén, které jsou registrovány pro klienta. Ty lze najít v verifiedDomains vlastnost TenantDetail objektu. 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.Pomocí alias "TatoOrganizace". Tento alias je dostupná jenom při použití ověřování (s rameny-3) typ udělení autorizačního kódu OAuth. Alias se nerozlišují malá a velká písmena. Nahradí objekt domény ID nebo klienta v adrese 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. 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.Pomocí "Mě" 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. Alias se nerozlišují malá a velká písmena. Nahradí objekt domény ID nebo klienta v adrese 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. 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. (Poznámka: textu požadavku musí být uveden také s požadavek POST.)
Viz také
Azure AD Graph API podporován dotazy, filtrů a možností stránkování