Compartir a través de


ediscoverySearch: exportResult

Espacio de nombres: microsoft.graph.security

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Exporte los resultados de una ediscoverySearch estimada. Para obtener más información, consulte Administración de una estimación de recopilación.

Nota:

El uso de las API de eDiscovery para inquilinos con licencias de Standard Microsoft (por ejemplo, E3) requiere una suscripción a la facturación de pago por uso de Purview. Para obtener más información, vea Facturación en eDiscovery.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) eDiscovery.Read.All eDiscovery.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación eDiscovery.Read.All eDiscovery.ReadWrite.All

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.

En la tabla siguiente se enumeran los parámetros que puede usar con esta acción.

Parámetro Tipo Description
additionalOptions microsoft.graph.security.additionalOptions Opciones adicionales para la exportación. Los valores posibles son: none, teamsAndYammerConversations, , cloudAttachments, subfolderContentsallDocumentVersions, listAttachments, unknownFutureValue, , htmlTranscripts, advancedIndexing, allItemsInFolder, includeFolderAndPath, , condensePaths, friendlyName, , splitSource. includeReport Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: htmlTranscripts, advancedIndexing, allItemsInFolder, includeFolderAndPath, condensePaths, friendlyName, , splitSourceincludeReport. El advancedIndexing valor solo está disponible si exportCriteria incluye partiallyIndexed. Obligatorio.
cloudAttachmentVersion microsoft.graph.security.cloudAttachmentVersion Las versiones de los datos adjuntos en la nube que se van a incluir en los mensajes. Los valores posibles son: latest, recent10, recent100, all, unknownFutureValue. El valor predeterminado es latest.
description Cadena Descripción del resultado de la exportación.
displayName Cadena Nombre para mostrar del resultado de la exportación.
documentVersion microsoft.graph.security.documentVersion Las versiones de los archivos de SharePoint que se van a incluir. Los valores posibles son: latest, recent10, recent100, all, unknownFutureValue. El valor predeterminado es latest.
exportCriteria microsoft.graph.security.exportCriteria Parte de los resultados de la estimación que se van a exportar. Los valores posibles son: searchHits, partiallyIndexed, unknownFutureValue. Obligatorio.
exportFormat microsoft.graph.security.exportFormat El formato deseado de los correos electrónicos exportados. Los valores posibles son: pst, msg, eml (en desuso), unknownFutureValue. Obligatorio. El eml miembro está en desuso. Permanece en versión beta por compatibilidad con versiones anteriores. En el futuro, use pst o msg.
exportLocation microsoft.graph.security.exportLocation Ámbito de ubicación para elementos parcialmente indexados. Puede optar por incluir elementos parcialmente indexados solo en ubicaciones con capacidad de respuesta con aciertos de búsqueda o en todas las ubicaciones de destino. Los valores posibles son: responsiveLocations, nonresponsiveLocations, unknownFutureValue. El nonresponsiveLocations valor solo está disponible si exportCriteria incluye partiallyIndexed.

Respuesta

Si la exportación se inició correctamente, esta acción devuelve un código de 202 Accepted respuesta. La respuesta también contiene un Location encabezado que incluye la ubicación de microsoft.graph.security.ediscoverySearchExportOperation que se creó para controlar la exportación. Para comprobar el estado de la operación de exportación, realice una solicitud GET a la dirección URL de ubicación.

Ejemplos

Ejemplo 1: Exportación de resultados solo con aciertos de búsqueda, excepto elementos parcialmente indexados, como archivos .pst para cada buzón y mensajes de chat contextuales de subprocesos en transcripciones HTML

En el ejemplo siguiente se muestra cómo exportar resultados solo con aciertos de búsqueda, excepto elementos parcialmente indexados, como archivos .pst para cada buzón de correo y subprocesos de mensajes de chat contextuales en transcripciones HTML.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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": "htmlTranscripts, splitSource, includeFolderAndPath, condensePaths, friendlyName",
  "exportFormat": "pst"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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')

Ejemplo 2: Exportación de resultados con resultados de búsqueda y elementos parcialmente indexados de todas las ubicaciones como archivos .pst para cada buzón

En el ejemplo siguiente se muestra cómo exportar resultados con aciertos de búsqueda y elementos parcialmente indexados desde todas las ubicaciones, como archivos .pst para cada buzón de correo.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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": "splitSource",
  "exportFormat": "pst"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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')

Ejemplo 3: Exportación de resultados con aciertos de búsqueda y elementos parcialmente indexados desde ubicaciones con visitas de búsqueda, sin opciones adicionales, como archivos .msg para cada mensaje

En el ejemplo siguiente se muestra cómo exportar resultados con aciertos de búsqueda y elementos parcialmente indexados desde ubicaciones con visitas de búsqueda, sin opciones adicionales seleccionadas, como archivos .msg para cada mensaje.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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')

Ejemplo 4: Exportación de resultados con elementos parcialmente indexados desde todas las ubicaciones de destino, con todas las opciones adicionales, como archivos .eml para cada mensaje

En el ejemplo siguiente se muestra cómo exportar resultados con elementos indizados parcialmente desde todas las ubicaciones de destino, con todas las opciones adicionales seleccionadas, como archivos .eml para cada mensaje.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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": "advancedIndexing, subfolderContents, allItemsInFolder, listAttachments, teamsAndYammerConversations, htmlTranscripts, cloudAttachments, includeFolderAndPath, splitSource, condensePaths, friendlyName, includeReport",
  "exportFormat": "eml"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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')

Ejemplo 5: Exportación de resultados con elementos indizados parcialmente desde ubicaciones de búsqueda y datos adjuntos en la nube

En el ejemplo siguiente se muestra cómo exportar resultados con elementos indizados parcialmente desde ubicaciones de aciertos de búsqueda y datos adjuntos en la nube. Especifica cuántas versiones de documentos y datos adjuntos en la nube se van a incluir y exporta cada mensaje como un archivo .eml.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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": "splitSource, includeFolderAndPath, condensePaths, friendlyName",
  "exportFormat": "eml",
  "cloudAttachmentVersion": "all",
  "documentVersion": "recent100"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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')