Вывод списка владельцев групп

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

Получение списка владельцев группы. Владельцы — это группа пользователей или субъектов-служб, которым разрешено изменять этот групповой объект. Владельцы в настоящее время недоступны в Microsoft Graph для групп, созданных в Exchange, групп рассылки или групп, синхронизированных из локальной среды.

Примечание. В настоящее время субъекты-службы не указаны как владельцы группы благодаря поэтапному развертыванию субъектов-служб в конечной точке Microsoft Graph версии 1.0.

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

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

Разрешения

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

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

Важно!

Когда приложение запрашивает связь, которая возвращает коллекцию типов directoryObject , если у него нет разрешения на чтение определенного типа ресурсов, возвращаются члены этого типа, но с ограниченной информацией. Например, возвращается только свойство @odata.type для типа объекта и идентификатор , в то время как другие свойства указываются как null. При таком поведении приложения могут запрашивать необходимые разрешения с наименьшими привилегиями, а не полагаться на набор каталогов.*Разрешения. Сведения см. в разделе Ограниченные сведения, возвращаемые для недоступных объектов member.

В делегированных сценариях вошедшему пользователю также должна быть назначена поддерживаемая Microsoft Entra роль или пользовательская роль с разрешением ролиmicrosoft.directory/groups/owners/read. Для этой операции поддерживаются следующие наименее привилегированные роли:

  • Владельцы групп
  • Пользователи -члены
  • "Гостевые" пользователи — имеют ограниченные разрешения на чтение
  • Читатели каталогов
  • Запись каталогов
  • Администратор Группы
  • Администратор пользователей
  • Администратор Exchange — только для групп Microsoft 365
  • Администратор SharePoint — только для групп Microsoft 365
  • Администратор Teams — только для групп Microsoft 365
  • Администратор Yammer — только для групп Microsoft 365
  • администратор Intune — только для групп безопасности

HTTP-запрос

GET /groups/{id}/owners

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

Этот метод поддерживает $filterпараметры запроса ,$count, $select, $searchи $expand OData для настройки ответа. Приведение OData также включено, например, можно приведения, чтобы получить только владельцев группы, которые являются пользователями. Вы можете использовать $search в свойствах displayName и description.

Некоторые запросы поддерживаются только при использовании заголовка ConsistencyLevel с присвоенным значением eventual и $count. Дополнительные сведения см. в разделе Расширенные возможности запросов к объектам каталогов.

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

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

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

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

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и коллекцию объектов user в тексте отклика.

Пример

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/owners

Отклик

Ниже показан пример отклика.

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

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#directoryObjects",
    "value": [
        {
            "@odata.type": "#microsoft.graph.user",
            "id": "4562bcc8-c436-4f95-b7c0-4f8ce89dca5e",
            "accountEnabled": true,
            "displayName": "MOD Administrator",
            "userPrincipalName": "admin@contoso.com"
        },
        {
            "@odata.type": "#microsoft.graph.user",
            "id": "f0206b06-7c5d-461c-ae24-08f68b7ef463",
            "accountEnabled": true,
            "displayName": "Megan Bowen",
            "userPrincipalName": "MeganB@contoso.com"
        },
        {
            "@odata.type": "#microsoft.graph.user",
            "id": "5c70937c-d9ea-4a47-8852-ab77630f803d",
            "accountEnabled": true,
            "displayName": "Diego Siciliani",
            "userPrincipalName": "DiegoS@contoso.com"
        }
    ]
}