Compartir a través de

ediscoverySearch: exportResult

  • Artículo

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.

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 No admitida. No admitida.

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 se pueden 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, allDocumentVersions, subfolderContents, listAttachments y unknownFutureValue. Obligatorio.
description Cadena Descripción del resultado de la exportación.
displayName Cadena Nombre para mostrar del resultado de la exportación.
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 y unknownFutureValue Obligatorio.
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.

Respuesta

Si la exportación se ha iniciado 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: Exportar resultados solo con aciertos de búsqueda, excepto elementos parcialmente indexados, sin opciones adicionales, como archivos .pst para cada buzón

En el ejemplo siguiente se muestra cómo exportar resultados solo con aciertos de búsqueda, excepto elementos parcialmente indexados, sin opciones adicionales seleccionadas, como archivos .pst para cada buzón.

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": "none",
  "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: Exportar resultados con resultados de búsqueda y elementos parcialmente indexados en todas las ubicaciones, sin opciones adicionales, como archivos .pst para cada buzón.

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

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": "none",
  "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 en 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 en 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 en 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 parcialmente indexados en 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": "teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments",
  "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 parcialmente indexados en ubicaciones de aciertos de búsqueda, con datos adjuntos en la nube, como archivos .eml para cada mensaje

En el ejemplo siguiente se muestra cómo exportar resultados con elementos parcialmente indexados en ubicaciones de aciertos de búsqueda, con datos adjuntos en la nube, 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 5",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "cloudAttachments",
  "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('d488f23e-f3cb-4a1c-9b9f-88ac4342f534')