Creación de ediscoveryReviewSetQuery

Espacio de nombres: microsoft.graph.security

Cree un nuevo objeto ediscoveryReviewSetQuery .

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

Importante

Para el acceso delegado mediante cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Purview compatible mediante una de las siguientes opciones:

  • Administrador de la exhibición de documentos electrónicos. Permite a los miembros acceder a los conjuntos de revisión en los casos de exhibición de documentos electrónicos que crean y son miembros de . Esta es la opción con menos privilegios para acceder a los conjuntos de revisión en sus propios casos.
  • Administrador de eDiscovery. Proporciona todos los permisos del Administrador de exhibición de documentos electrónicos, 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 a los conjuntos de revisión dentro de los 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 los 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 la búsqueda ni realizar otras tareas de búsqueda o administración de casos.

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

Solicitud HTTP

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

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 del objeto ediscoveryReviewSetQuery .

Puede especificar las siguientes propiedades al crear un ediscoveryReviewSetQuery.

Propiedad Tipo Descripción
displayName Cadena El nombre de la consulta. Obligatorio.
contentQuery Cadena Consulta de KQL para el conjunto de revisión. Para obtener más información, consulte Consulta y filtrado de contenido en un conjunto de revisión.

Respuesta

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

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries
Content-Type: application/json

{
    "displayName": "My Query 1",
    "contentQuery": "(Author=\"edison\")"
}

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/v1.0/$metadata#security/cases/ediscoveryCases('58399dff-cebe-478f-b1af-d3227f1fd645')/reviewSets('273f11a1-17aa-419c-981d-ff10d33e420f')/queries/$entity",
    "description": null,
    "lastModifiedDateTime": "2022-05-29T23:39:51.3307953Z",
    "contentQuery": "((Author=\"edison\"))",
    "id": "fcb86cd1-50e0-427c-840e-ba6f087364e5",
    "displayName": "My Query 1",
    "createdDateTime": "2022-05-29T23:39:51.3307953Z",
    "createdBy": {
        "application": null,
        "user": {
            "id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
            "displayName": null,
            "userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
        }
    },
    "lastModifiedBy": {
        "application": null,
        "user": {
            "id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
            "displayName": null,
            "userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
        }
    }
}