Получение administrativeUnit

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Получение свойств и связей объекта administrativeUnit .

Так как ресурс administrativeUnit поддерживает расширения, можно также использовать GET операцию для получения пользовательских свойств и данных расширения в экземпляре administrativeUnit .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) AdministrativeUnit.Read.All AdministrativeUnit.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение AdministrativeUnit.Read.All AdministrativeUnit.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

В делегированных сценариях вызывающий пользователь должен быть участником или иметь по крайней мере одну из следующих Microsoft Entra ролей:

  • Читатели каталогов
  • Запись каталогов
  • Администратор приложений
  • Читатель сведений о безопасности
  • Администратор безопасности
  • Администратор привилегированных ролей
  • Администратор облачных приложений
  • Утверждающий доступ к lockBox клиента
  • Администратор Dynamics 365
  • Администратор Power BI
  • Администратор Information Protection Azure
  • Администратор Аналитика компьютеров
  • Администратор лицензий
  • Администратор компьютеров, управляемых Корпорацией Майкрософт
  • Администратор связи Teams
  • Инженер службы поддержки связи Teams
  • Специалист службы поддержки связи Teams
  • Администратор Teams
  • Администратор Insights
  • Администратор данных соответствия требованиям
  • Оператор безопасности
  • Администратор Kaizala
  • Глобальный читатель
  • Рецензент каталога

HTTP-запрос

GET /administrativeUnits/{id}
GET /directory/administrativeUnits/{id}

Необязательные параметры запросов

Этот метод поддерживает $selectпараметр запроса OData для настройки ответа. Свойства расширения также поддерживают параметры запроса следующим образом:

Тип расширения Комментарии
Расширения схемы Возвращается только с помощью $select. Поддерживает $filter (eq).
Расширения каталога Возвращается по умолчанию. Поддерживает $filter (eq).

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект administrativeUnit в тексте ответа.

Примеры

Пример 1. Получение административной единицы

Запрос

GET https://graph.microsoft.com/beta/administrativeUnits/4d7ea995-bc0f-45c0-8c3e-132e93bf95f8

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#administrativeUnits/$entity",
    "id": "49eb93f2-a5a2-4567-ad66-76a3ebd01d84",
    "deletedDateTime": null,
    "displayName": "Seattle District Technical Schools",
    "description": "Seattle district technical schools administration",
    "visibility": null,
    "membershipRule": "(user.country -eq \"United States\")",
    "membershipType": "Dynamic",
    "membershipRuleProcessingState": "On"
}

Пример 2. Получение административной единицы управления с ограниченным доступом

Запрос

GET https://graph.microsoft.com/beta/administrativeUnits/2sd35b05-ae71-48ab-9e7d-4r41a28te37d

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#administrativeUnits/$entity",
    "id": "2sd35b05-ae71-48ab-9e7d-4r41a28te37d",
    "deletedDateTime": null,
    "displayName": "Executive Division",
    "description": "Executive division administration",
    "isMemberManagementRestricted": true
}

Связанные материалы