Crear reviewSets

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.

Cree un nuevo objeto ediscoveryReviewSet .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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

Importante

Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol compatible de Microsoft Purview a través de una de las siguientes opciones:

  • Administrador de la exhibición de documentos electrónicos. Permite que los miembros accedan a los conjuntos de revisión en los casos de eDiscovery que crean y de los que son miembros. Esta es la opción con privilegios mínimos para acceder a los conjuntos de revisión en sus propios casos.
  • Administrador de eDiscovery. Proporciona todos los permisos de eDiscovery Manager, además de la capacidad de acceder a los conjuntos de revisión en todos los casos de eDiscovery de la organización.
  • Revisor. Proporciona acceso de solo lectura para revisar conjuntos en casos de eDiscovery en los que el usuario es miembro. Los revisores pueden ver y etiquetar documentos, pero no pueden realizar otras tareas de administración de casos.

El rol Revisar permite a los usuarios acceder a conjuntos de revisión en los casos de eDiscovery de los que son miembros. Los usuarios pueden ver y etiquetar documentos en conjuntos de revisión, pero no pueden obtener una vista previa de los resultados de búsqueda ni realizar otras tareas de búsqueda o administración de casos.

Para obtener más información acerca de los permisos y roles de eDiscovery, consulte Asignar permisos en eDiscovery.

Solicitud HTTP

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets

Encabezados de solicitud

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

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto ediscoveryReviewSet .

Puede especificar las siguientes propiedades al crear un ediscoveryReviewSet.

Propiedad Tipo Descripción
description Cadena La descripción del conjunto de revisión.
displayName Cadena El nombre del conjunto de revisión. Obligatorio.

Respuesta

Si se realiza correctamente, este método devuelve un código de 201 Created respuesta y un objeto microsoft.graph.security.ediscoveryReviewSet en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/reviewSets
Content-Type: application/json

{
    "displayName": "My review set 2"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/reviewSets/$entity",
    "displayName": "My review set 2",
    "id": "887306f5-1eb4-4409-b18c-ba47f4e3fa9b",
    "createdDateTime": "2022-05-23T16:33:13.5126494Z",
    "createdBy": {
        "application": null,
        "user": {
            "id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
            "displayName": null,
            "userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
        }
    }
}