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
Elimine los elementos de buzón de Exchange o los mensajes de Microsoft Teams contenidos en una búsqueda de exhibición de documentos electrónicos.
Puede recopilar y purgar las siguientes categorías de contenido de Teams:
- Chats de Teams 1:1 : mensajes de chat, publicaciones y datos adjuntos compartidos en una conversación de Teams entre dos personas. Los chats de Teams 1:1 también se denominan conversaciones.
- Chats de grupo de Teams : mensajes de chat, publicaciones y datos adjuntos compartidos en una conversación de Teams entre tres o más personas. También se denomina chats 1:N o conversaciones grupales.
- Canales de Teams : mensajes de chat, publicaciones, respuestas y datos adjuntos compartidos en un canal estándar de Teams.
- Canales privados : mensajes, respuestas y datos adjuntos compartidos en un canal privado de Teams.
- Canales compartidos : publicaciones de mensajes, respuestas y datos adjuntos compartidos en un canal compartido de Teams.
Nota: Esta solicitud purga un máximo de 100 elementos solo por ubicación. Cuando purgeType se establece en
recoverableopermanentlyDeletey purgeAreas se establece enteamsMessages, los mensajes de Teams se eliminan permanentemente.
Para obtener más información sobre cómo purgar mensajes de Teams, consulte:
- Serie de soluciones de eDiscovery: escenario de desbordamiento de datos: búsqueda y purga
- Flujo de trabajo de eDiscovery (Premium) para contenido en Microsoft Teams
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.ReadWrite.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | eDiscovery.ReadWrite.All | No disponible. |
Importante
En escenarios delegados con 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:
- Administración de la organización. Este rol permite a los miembros realizar la eliminación masiva de datos que coinciden con los criterios de una búsqueda. Esta es la opción con menos privilegios para purgar datos.
El rol Buscar y purgar es necesario para eliminar permanentemente los mensajes de correo electrónico que coinciden con los criterios de búsqueda. Este rol solo está disponible para los miembros del grupo de roles Administración de la organización y debe usarse con extrema precaución, ya que no se pueden recuperar los datos eliminados.
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}/searches/{ediscoverySearchId}/purgeData
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.
En la tabla siguiente se muestran los parámetros que puede usar con esta acción.
| Parámetro | Tipo | Description |
|---|---|---|
| purgeAreas | microsoft.graph.security.purgeAreas | Opción para definir las ubicaciones que deben estar en el ámbito de la acción de purga. Los valores posibles son: mailboxes, teamsMessages, unknownFutureValue. |
| purgeType | microsoft.graph.security.purgeType | Opciones que controlan si la acción es eliminación temporal o eliminación rígida. Los valores posibles son: recoverable, unknownFutureValue, permanentlyDelete. |
Respuesta
Si se ejecuta correctamente, esta acción devuelve un código de respuesta 202 Accepted.
Si la operación de purga de datos se inicia correctamente, esta acción devuelve un código de 202 Accepted respuesta. La respuesta también contiene un Location encabezado, que contiene la ubicación de la operación de purga de datos que se creó para confirmar la purga. Para comprobar el estado de la operación de purga de datos, realice una solicitud GET a la dirección URL de ubicación.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/purgeData
{
"purgeType": "recoverable",
"purgeAreas": "teamsMessages"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted