Compartir a través de


ediscoverySearch: exportReport

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.

Exportar un informe de elemento desde 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 eDiscovery.Read.All eDiscovery.ReadWrite.All

Solicitud HTTP

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

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. Admite un subconjunto de los valores de additionalOptions. Los valores posibles son: none, teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments, unknownFutureValue, htmlTranscripts, advancedIndexing y allItemsInFolder. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: htmlTranscripts, advancedIndexing, allItemsInFolder. 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 informe de 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.
displayName Cadena Nombre para mostrar del informe de exportación.
exportCriteria microsoft.graph.security.exportCriteria Opciones bit a bit que especifican la parte del informe de estimación que se va a exportar. Los valores posibles son: searchHits, partiallyIndexed, unknownFutureValue. Obligatorio.
exportLocation microsoft.graph.security.exportLocation Opciones bit a bit que especifican el ámbito de ubicación de los 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 un informe de elementos con solo aciertos de búsqueda, excepto elementos parcialmente indexados, sin opciones adicionales

En el ejemplo siguiente se muestra cómo exportar un informe de elementos solo con visitas de búsqueda, excepto elementos parcialmente indexados, sin opciones adicionales seleccionadas.

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/exportReport
Content-Type: application/json

{
  "displayName": "Export 1",
  "exportCriteria": "searchHits",
  "additionalOptions": "none"
}

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('f57fc79d-bea8-42ac-b0be-217302d5683c')

Ejemplo 2: Exportación de un informe de elementos con aciertos de búsqueda y elementos parcialmente indexados en todas las ubicaciones de destino, sin opciones adicionales

En el ejemplo siguiente se muestra cómo exportar un informe de elementos con aciertos de búsqueda y elementos parcialmente indexados en todas las ubicaciones de destino, sin opciones adicionales seleccionadas.

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/exportReport
Content-Type: application/json

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

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('cbcb4807-e76e-4ef0-bd5b-e2177c13f07e')

Ejemplo 3: Exportación de un informe de elementos con aciertos de búsqueda y elementos parcialmente indexados en ubicaciones con aciertos de búsqueda, sin opciones adicionales

En el ejemplo siguiente se muestra cómo exportar un informe de elementos con aciertos de búsqueda y elementos parcialmente indexados en ubicaciones con aciertos de búsqueda, sin opciones adicionales seleccionadas.

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/exportReport
Content-Type: application/json

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

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('c56f66de-b780-4efc-aa0c-4ef3271ad6b4')

Ejemplo 4: Exportación de un informe de elementos parcialmente indexados en todas las ubicaciones de destino con todas las opciones adicionales seleccionadas

En el ejemplo siguiente se muestra cómo exportar un informe de elementos indizados parcialmente en todas las ubicaciones de destino con todas las opciones adicionales seleccionadas.

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/exportReport
Content-Type: application/json

{
  "displayName": "Export 4",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "advancedIndexing, subfolderContents, allItemsInFolder, listAttachments, teamsAndYammerConversations, htmlTranscripts, cloudAttachments"
}

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('572d44e2-5e77-4443-a2ed-cd036bdc0304')

Ejemplo 5: Exportación de un informe de elementos parcialmente indexados en ubicaciones con accesos de búsqueda y datos adjuntos en la nube

En el ejemplo siguiente se muestra cómo exportar un informe de elementos parcialmente indexados en ubicaciones con accesos de búsqueda y datos adjuntos en la nube, incluido el número de versiones de documentos y datos adjuntos en la nube.

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/exportReport
Content-Type: application/json

{
  "displayName": "Export 5",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "cloudAttachments",
  "cloudAttachmentVersion": "all",
  "doucmentVersion": "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('788159f9-f860-43f2-8fc5-0fc17df0e696')