Partager via


ediscoverySearch : purgeData

Espace de noms : microsoft.graph.security

Supprimez les éléments de boîte aux lettres Exchange ou les messages Microsoft Teams contenus dans une recherche eDiscovery.

Vous pouvez collecter et vider les catégories suivantes de contenu Teams :

  • Conversations Teams 1:1 : messages de conversation, publications et pièces jointes partagés dans une conversation Teams entre deux personnes. Les conversations Teams 1:1 sont également appelées conversations.
  • Conversations de groupe Teams : messages de conversation, publications et pièces jointes partagés dans une conversation Teams entre trois personnes ou plus. Également appelées conversations 1 :N ou conversations de groupe.
  • Canaux Teams : messages de conversation, publications, réponses et pièces jointes partagés dans un canal Teams standard.
  • Canaux privés : messages, réponses et pièces jointes partagés dans un canal Teams privé.
  • Canaux partagés : messages, réponses et pièces jointes partagés dans un canal Teams partagé.

Note: Cette requête vide un maximum de 100 éléments par emplacement uniquement. Lorsque purgeType a la valeur recoverable ou permanentlyDelete et que purgeAreas a la valeur teamsMessages, les messages Teams sont supprimés définitivement.

Pour plus d’informations sur la purge des messages Teams, consultez :

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) eDiscovery.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application eDiscovery.ReadWrite.All Non disponible.

Requête HTTP

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/purgeData

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant présente les paramètres que vous pouvez utiliser avec cette action.

Paramètre Type Description
purgeAreas microsoft.graph.security.purgeAreas Option permettant de définir les emplacements dans l’étendue de l’action de vidage. Les valeurs possibles sont mailboxes, teamsMessages et unknownFutureValue.
purgeType microsoft.graph.security.purgeType Options qui contrôlent si l’action est une suppression réversible ou une suppression définitive. Les valeurs possibles sont recoverable, unknownFutureValue et permanentlyDelete.

Réponse

Si elle réussit, cette action renvoie un code de réponse 202 Accepted.

Si l’opération de vidage des données a démarré avec succès, cette action retourne un 202 Accepted code de réponse. La réponse contient également un Location en-tête, qui contient l’emplacement de l’opération de vidage des données qui a été créée pour valider le vidage. Pour case activée la status de l’opération de vidage des données, effectuez une requête GET à l’URL d’emplacement.

Exemples

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accepted