Поделиться через

Добавление дополнительных источников

  • Статья

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

Важно!

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

Создайте дополнительный источник , связанный с поиском eDiscovery.

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

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

Разрешения

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

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

HTTP-запрос

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/additionalSources

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

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

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

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

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

Заметка: Требуется электронная почта или сайт , но не и то, и другое.

Свойство Тип Описание
email строка SMTP-адрес почтового ящика. Чтобы получить адрес электронной почты группы, используйте команду Список групп или Получить группу. Вы можете запросить по имени группы, используя $filter; например, https://graph.microsoft.com/v1.0/groups?$filter=displayName eq 'secret group'&$select=mail,id,displayName.
site string URL-адрес сайта; например, https://contoso.sharepoint.com/sites/HumanResources.

Отклик

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

Примеры

Пример 1. Создание дополнительного источника обнаружения электронных данных из источника сайта

Запрос

В следующем примере показан запрос, который создает источник обнаружения электронных данных из источника сайта.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/additionalSources

{
    "@odata.type": "microsoft.graph.security.siteSource",
    "site": {
        "webUrl": "https://m365x809305.sharepoint.com/sites/Design-topsecret"
    }
}

Отклик

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

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

HTTP/1.1 201 Created

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/searches('c61a5860-d634-4d14-aea7-d82b6f4eb7af')/additionalSources/$entity",
    "@odata.type": "#microsoft.graph.security.siteSource",
    "@odata.id": "https://graph.microsoft.com/v1.0/sites/46303732-3434-4630-3832-363333363441",
    "displayName": "Design - top secret",
    "createdDateTime": "2022-07-15T22:45:36.1096267Z",
    "holdStatus": "0",
    "id": "46303732-3434-4630-3832-363333363441",
    "createdBy": {
        "application": null,
        "user": {
            "id": null,
            "displayName": null
        }
    }
}

Пример 2. Создание дополнительного источника обнаружения электронных данных из пользовательского источника

Запрос

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

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/17011798-ca63-4282-9cb3-0086f1042bfc/searches/2f5cc5a6-9728-4ba0-acfa-edce25e91244/additionalSources

{
    "@odata.type": "microsoft.graph.security.userSource",
    "email": "admin@edbig.onmicrosoft.com"
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 200 Created

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('17011798-ca63-4282-9cb3-0086f1042bfc')/searches('2f5cc5a6-9728-4ba0-acfa-edce25e91244')/additionalSources/$entity",
    "@odata.type": "#microsoft.graph.security.userSource",
    "displayName": "eDisco Big",
    "createdDateTime": "2024-11-19T20:11:11.5950513Z",
    "holdStatus": "0",
    "id": "5933247d-7011-494d-b9a6-65a3870d88fa",
    "email": "admin@edbig.onmicrosoft.com",
    "includedSources": "mailbox,site",
    "siteWebUrl": "https://edbig-my.sharepoint.com/personal/admin_edbig_onmicrosoft_com",
    "createdBy": {
        "application": null,
        "user": {
            "id": null,
            "displayName": null
        }
    }
}