Создание externalGroupMember

  • Статья

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

Важно!

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

Создайте объект externalGroupMember .

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

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

Разрешения

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

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

HTTP-запрос

POST /external/connections/{connectionsId}/groups/{externalGroupId}/members

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

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

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

В тексте запроса укажите представление объекта externalGroupMember в формате JSON.

При создании externalGroupMember можно указать следующие свойства.

Свойство Тип Описание
id String Уникальность id элемента. Это будет objectId в случае Microsoft Entra пользователей или групп и externalGroupId в случае внешних групп. Обязательно.
type microsoft.graph.externalConnectors.externalGroupMemberType Тип члена, добавленного во внешнюю группу. Возможные значения: user или group , если identitySource имеет значение azureActiveDirectory и только group тогда, когда identitySource имеет значение external. Обязательно.
identitySource microsoft.graph.externalConnectors.identitySourceType Источник удостоверений, к которому принадлежит элемент. Возможные значения: azureActiveDirectory, external. Обязательно.

Отклик

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

Примеры

Пример 1. Добавление пользователя Microsoft Entra в качестве участника

Запрос

POST https://graph.microsoft.com/beta/external/connections/contosohr/groups/31bea3d537902000/members
Content-Type: application/json

{
  "id": "e811976d-83df-4cbd-8b9b-5215b18aa874",
  "type": "user",
}

Отклик

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "e811976d-83df-4cbd-8b9b-5215b18aa874",
  "type": "user",
}

Пример 2. Добавление Microsoft Entra группы в качестве участника

Запрос

POST https://graph.microsoft.com/beta/external/connections/contosohr/groups/31bea3d537902000/members
Content-Type: application/json

{
  "id": "e5477431-1038-484e-bf69-1dfedb97a110",
  "type": "externalGroup",
}

Отклик

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "e5477431-1038-484e-bf69-1dfedb97a110",
  "type": "externalGroup",
}

Пример 3. Добавление другой внешней группы в качестве участника

Запрос

POST https://graph.microsoft.com/beta/external/connections/contosohr/groups/31bea3d537902000/members
Content-Type: application/json

{
  "id": "1431b9c38ee647f6a",
  "type": "externalGroup",
}

Отклик

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "14m1b9c38qe647f6a",
  "type": "externalGroup",
}