Экспорт (0) Печать
Развернуть все

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

Обновлено: Апрель 2014 г.

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

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

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

 

Ресурсы верхнего уровня Результаты запроса URI (для contoso.com)

Ресурсы верхнего уровня

Возвращает список URI ресурсов верхнего уровня для службы каталогов (также перечисленных ниже)

https://graph.windows.net/contoso.com?api-version=2013-04-05

Сведения об организации

Возвращает сведения об организации

https://graph.windows.net/contoso.com/tenantDetails?api-version=2013-04-05

Контакты

Возвращает контактную информацию

https://graph.windows.net/contoso.com/contacts?api-version=2013-04-05

Пользователи

Возвращает сведения о пользователе

https://graph.windows.net/contoso.com/users?api-version=2013-04-05

Группы

Возвращает данные о группе

https://graph.windows.net/contoso.com/groups?api-version=2013-04-05

Роли

Возвращает все роли, к которым приписаны пользователи или группы

https://graph.windows.net/contoso.com/roles?api-version=2013-04-05

SubscribedSkus

Возвращает подписки клиента

https://graph.windows.net/contoso.com/subscribedSkus?api-version=2013-04-05

Метаданные каталога

Возвращает документ метаданных службы, описывающий модель данных (то есть структуру и организацию ресурсов каталога)

https://graph.windows.net/contoso.com/$metadata?api-version=2013-04-05

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

 

Операция запроса URI (для contoso.com)

Выводит список всех пользователей и групп

https://graph.windows.net/contoso.com/users?api-version=2013-04-05

https://graph.windows.net/contoso.com/groups?api-version=2013-04-05

Получение отдельных пользователей путем указания objectId или userPrincipalName

https://graph.windows.net/contoso.com/users/d1f67a6c-02c9-4fe5-81fb-58160ce24fe5?api-version=2013-04-05

https://graph.windows.net/contoso.com/users/admin@contoso.com?api-version=2013-04-05

Запрос и фильтр для пользователя, в котором displayName имеет значение Jon Doe

https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=2013-04-05

Запрос и фильтр для определенных пользователей, в котором firstName имеет значение Jon

https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=2013-04-05

Фильтр по значениям givenName и фамилии.

https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=2013-04-05

Получение отдельной группы путем указания objectId

https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=2013-04-05

Получение руководителя пользователя

https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=2013-04-05

Получение списка непосредственных подчиненных пользователя

https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=2013-04-05

Получение списка ссылок на непосредственных подчиненных пользователя

https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=2013-04-05

Получение списка членов группы

https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=2013-04-05

Получение списка ссылок на членов группы.

https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=2013-04-05

Получение списка групп, членом (постоянным) которых является пользователь

https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=2013-04-05

Получение списка групп, членом (постоянным) которых является пользователь

https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=2013-04-05

Запрос и фильтр для групп с displayName => ‘az’ и <= ‘dz’

https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=2013-04-05

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

См. также

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft