ediscoverySearch: purgeData
Espacio de nombres: microsoft.graph.security
Elimine los mensajes de Microsoft Teams contenidos en una búsqueda de exhibición de documentos electrónicos.
Nota: Esta solicitud purga solo los datos de Teams. No purga otros tipos de datos, como elementos de buzón de correo.
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.
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 | No admitida. | No admitida. |
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.
La siguiente tabla muestra los parámetros que se pueden usar con esta acción.
Parámetro | Tipo | Descripción |
---|---|---|
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 , permanentlydeleted y unknownFutureValue . |
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 y unknownFutureValue . |
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 contendrá un Location
encabezado, que contiene la ubicación de la operación purgar 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
{
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de