Partager via

ediscoverySearch : purgeData

  • Article

Espace de noms : microsoft.graph.security

Supprimez les messages Microsoft Teams contenus dans une recherche eDiscovery.

Note: Cette requête vide uniquement les données Teams. Il ne vide pas les autres types de données tels que les éléments de boîte aux lettres.

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é.

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 Non prise en charge. Non prise en charge.

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 indique les paramètres utilisables avec cette action.

Paramètre Type Description
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, permanentlydeleted, unknownFutureValue.
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.

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

{

}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accepted