Table of contents
Свернуть оглавление
Развернуть оглавление

Стандартные запросы API Graph

Jimaco Brannian|Последнее обновление: 22.08.2016
|
1 Участник

В этой статье представлены некоторые стандартные запросы, которые можно выполнять при работе с API Graph Azure AD . Дополнительные сведения о операциях, поддерживаемых при запросах Graph см. в статье "Поддерживаемые запросы, фильтры и операции разбиения на страницы в API Graph Azure AD ".

Важно. Доступ к функциональным возможностям API Graph Azure AD также можно получить через Microsoft Graph — универсальный API, который также включает API других служб Майкрософт, таких как Outlook, OneDrive, OneNote, Планировщик и Office Graph, и позволяет получать к ним доступ через единую конечную точку с маркером единого доступа.

Адресация

Все приведенные ниже запросы обращаются к клиенту по имени домена. Вы можете заменить contoso.com на одно из зарегистрированных доменных имен вашего клиента с идентификатором GUID или с псевдонимом MyOrganization вашего клиента (для делегированного доступа). Сведения о других способах адресации клиента см. в статье "Адресация сущностей и операций в API Graph".

Запросы к ресурсам верхнего уровня

В следующих стандартных запросах показано, как получить доступ к ресурсам верхнего уровня в API Graph на примере клиента contoso.com. Обратите внимание на то, что для выполнения запросов к клиенту потребуется заголовок авторизации, который содержит действительный токен носителя, полученный из Azure AD.

Ресурс верхнего уровняРезультаты запросаURI (для contoso.com)
Ресурсы верхнего уровняВозвращает список URI ресурсов верхнего уровня для службы каталогов (также перечисленных ниже)https://graph.windows.net/contoso.com?api-version=1.6
Сведения об организацииВозвращает сведения об организацииhttps://graph.windows.net/contoso.com/tenantDetails?api-version=1.6
КонтактыВозвращает контактную информацию организацииhttps://graph.windows.net/contoso.com/contacts?api-version=1.6
UsersВозвращает сведения о пользователеhttps://graph.windows.net/contoso.com/users?api-version=1.6
ГруппыВозвращает данные о группеhttps://graph.windows.net/contoso.com/groups?api-version=1.6
Роли каталогаВозвращает все активированные роли каталога в клиентеhttps://graph.windows.net/contoso.com/roles?api-version=1.6
SubscribedSkusВозвращает подписки клиентаhttps://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6
Метаданные каталогаВозвращает документ метаданных службы, описывающий модель данных (то есть структуру и организацию ресурсов каталога)https://graph.windows.net/contoso.com/$metadata?api-version=1.6

Операции запросов

В следующей таблице представлены некоторые примеры запросов API Graph, где в качестве примера используется клиент contoso.com.

Операция запросаURI (для contoso.com)
Выводит список всех пользователей и группhttps://graph.windows.net/contoso.com/users?api-version=1.6

https://graph.windows.net/contoso.com/groups?api-version=1.6
Получение отдельных пользователей путем указания objectId или userPrincipalNamehttps://graph.windows.net/contoso.com/users/d1f67a6c-02c9-4fe5-81fb-58160ce24fe5?api-version=1.6

https://graph.windows.net/contoso.com/users/admin@contoso.com?api-version=1.6
Запрос и фильтр для пользователя, в котором displayName имеет значение Jon Doehttps://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6
Запрос и фильтр для определенных пользователей, в котором firstName имеет значение Jonhttps://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6
Фильтр по значениям givenName и фамилии.https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6
Получение отдельной группы путем указания objectIdhttps://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6
Получение руководителя пользователяhttps://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6
Получение списка непосредственных подчиненных пользователяhttps://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6
Получение списка ссылок на непосредственных подчиненных пользователяhttps://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6
Получение списка членов группыhttps://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6
Получение списка ссылок на членов группы.https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6
Получение списка групп, членом (постоянным) которых является пользовательhttps://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6
Получение списка групп, членом (постоянным) которых является пользовательhttps://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6
Запрос и фильтр для групп с displayName >= "az" and <= "dz"https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6

Примечание. Пробел в строке запроса должен быть закодирован в формате URL перед отправкой запроса. Например, следующая строка запроса https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 должна быть закодирована в формате URL-адреса так: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6.

© 2017 Microsoft