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

ediscoverySearch: exportResult

  • Статья

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

Важно!

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

Экспорт результатов из предполагаемого ediscoverySearch. Дополнительные сведения см. в разделе Управление оценкой коллекции.

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

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

Разрешения

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

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

HTTP-запрос

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/exportResult
POST /security/cases/ediscoveryCases('{ediscoveryCaseId}')/searches('{ediscoverySearchId}')/exportResult

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

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

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

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

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

Параметр Тип Описание
дополнительныепараметры microsoft.graph.security.additionalOptions Дополнительные параметры для экспорта. Возможные значения: none, teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments, unknownFutureValue. Обязательный.
description String Описание результата экспорта.
displayName String Отображаемое имя результата экспорта.
exportCriteria microsoft.graph.security.exportCriteria Часть результатов оценки для экспорта. Допустимые значения: searchHits, partiallyIndexed, unknownFutureValue. Обязательно.
exportFormat microsoft.graph.security.exportFormat Требуемый формат экспортированных сообщений электронной почты. Допустимые значения: pst, msg, eml, unknownFutureValue. Обязательно.
exportLocation microsoft.graph.security.exportLocation Расположение область для частично индексированных элементов. Вы можете включить частично индексированные элементы только в адаптивных расположениях с поиском или во всех целевых расположениях. Допустимые значения: responsiveLocations, nonresponsiveLocations, unknownFutureValue.

Отклик

Если экспорт успешно запущен, это действие возвращает 202 Accepted код ответа. Ответ также содержит Location заголовок, включающий расположение microsoft.graph.security.ediscoverySearchExportOperation , созданного для обработки экспорта. Чтобы проверка состояние операции экспорта, отправьте запрос GET на URL-адрес расположения.

Примеры

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

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

Запрос

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

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 1 - simple PST",
  "exportCriteria": "searchHits",
  "additionalOptions": "none",
  "exportFormat": "pst"
}

Отклик

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

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('01826ce3-43a3-4235-a121-81d05926efae')

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

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

Запрос

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

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 2",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "none",
  "exportFormat": "pst"
}

Отклик

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

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('c74d3039-5c79-4093-8e45-2abb94e32ba9')

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

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

Запрос

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

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 3",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "none",
  "exportFormat": "msg"
}

Отклик

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

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('4bf812e0-44ad-4856-a302-b4ea79725573')

Пример 4. Экспорт результатов с частично индексируемыми элементами во всех целевых расположениях со всеми дополнительными параметрами в виде .eml файлов для каждого сообщения

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

Запрос

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

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 4",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments",
  "exportFormat": "eml"
}

Отклик

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

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('05b5c707-ed0d-4f5c-bbfd-e4941137baf1')

Пример 5. Экспорт результатов с частично индексируемыми элементами в расположениях поиска с облачными вложениями в виде .eml файлов для каждого сообщения

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

Запрос

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

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportResult
Content-Type: application/json

{
  "displayName": "Export 5",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "cloudAttachments",
  "exportFormat": "eml"
}

Отклик

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

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('d488f23e-f3cb-4a1c-9b9f-88ac4342f534')