Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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"
}
}
}