Стандартные запросы API Graph
В этой статье представлены некоторые стандартные запросы, которые можно выполнять при работе с API Graph Azure AD . Дополнительные сведения о операциях, поддерживаемых при запросах Graph см. в статье "Поддерживаемые запросы, фильтры и операции разбиения на страницы в API Graph Azure AD ".
Важно!
Для доступа к ресурсам Azure Active Directory мы настоятельно рекомендуем использовать Microsoft Graph вместо API Azure AD Graph.Теперь наши усилия сфокусированы на разработке Microsoft Graph; дальнейшее продвижение API Azure AD Graph мы не планируем.Есть очень мало сценариев, в которых по-прежнему можно использовать API Azure AD Graph. Дополнительные сведения об этом см. в записи блога в центре разработчиков Office, где сравниваются решения Microsoft Graph и Azure AD 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 или userPrincipalName | https://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 Doe | https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 |
| Запрос и фильтр для определенных пользователей, в котором firstName имеет значение Jon | https://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 |
| Получение отдельной группы путем указания objectId | https://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.