Compartir a través de


ediscoveryReviewSet: addToReviewSet

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.

Inicie el proceso de agregar una colección de servicios de Microsoft 365 a un conjunto de revisión. Una vez creada la operación, puede obtener el estado de la operación recuperando el Location parámetro de los encabezados de respuesta. La ubicación proporciona una dirección URL que devuelve una operación Agregar para revisar el conjunto.

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}/reviewSets/{eDiscoveryReviewSetId}/addToReviewSet

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.

La siguiente tabla muestra los parámetros que se pueden usar con esta acción.

Parámetro Tipo Descripción
additionalDataOptions microsoft.graph.security.additionalDataOptions Opciones para agregar elementos al conjunto de revisión. Los valores posibles son: allVersions, linkedFiles, , unknownFutureValue, listAttachmentsadvancedIndexing, htmlTranscripts, messageConversationExpansion, , locationsWithoutHits. allItemsInFolder Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, , locationsWithoutHitsallItemsInFolder. Los locationsWithoutHits valores y advancedIndexing solo se tienen en cuenta si itemsToIncude está establecido en partiallyIndexed.
cloudAttachmentVersion microsoft.graph.security.cloudAttachmentVersion Especifica el número de versiones de datos adjuntos en la nube que se van a recopilar. Los valores posibles son: latest, recent10, recent100, all, unknownFutureValue. El valor predeterminado es latest.
documentVersion microsoft.graph.security.documentVersion Especifica el número de versiones del documento que se van a recopilar. Los valores posibles son: latest, recent10, recent100, all, unknownFutureValue. El valor predeterminado es latest.
itemsToInclude microsoft.graph.security.itemsToInclude Los elementos que se van a incluir en el conjunto de revisión. Los valores posibles son: searchHits, partiallyIndexed, unknownFutureValue.
buscar microsoft.graph.security.ediscoverySearch Identificador de la búsqueda de eDiscovery que desea agregar al conjunto de revisión.

Respuesta

Si se ejecuta correctamente, esta acción devuelve un código de respuesta 202 Accepted.

Ejemplos

Ejemplo 1: Agregar búsqueda con archivos vinculados y la versión más reciente de datos adjuntos en la nube

En el ejemplo siguiente se muestra cómo agregar búsqueda al conjunto de revisión e incluir la versión más reciente de los archivos compartidos como vínculos.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/63ef0fd7-0db2-45eb-a9d7-7d75c8239873/addToReviewSet
Content-Type: application/json

{
  "search": {
    "id": "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
  },
  "additionalDataOptions": "linkedFiles",
  "cloudAttachmentVersion": "latest"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 202 Accepted

Ejemplo 2: Agregar búsqueda con todas las opciones de datos y las versiones más recientes de la nube y del documento

En el ejemplo siguiente se muestra cómo agregar búsqueda al conjunto de revisión con todas las opciones seleccionadas para additionalDataOptions, las 10 versiones más recientes seleccionadas para los documentos y la versión más reciente seleccionada para los datos adjuntos en la nube.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/63ef0fd7-0db2-45eb-a9d7-7d75c8239873/addToReviewSet
Content-Type: application/json

{
  "search": {
    "id": "c17e91d6-6bc0-4ecb-b388-269ea3d4ffb7"
  },
  "additionalDataOptions": "linkedFiles, allVersions, advancedIndexing, listAttachments, htmlTranscripts, messageConversationExpansion, locationsWithoutHits, allItemsInFolder",
  "cloudAttachmentVersion": "latest",
  "documentVersion": "recent10"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 202 Accepted