ediscoverySearch: exportResult
Пространство имен: microsoft.graph.security
Экспорт результатов из предполагаемого 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')