sourceCollection : purgeData

Espace de noms : microsoft.graph.ediscovery

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Attention

Les API eDiscovery dans l’espace de noms secondaire microsoft.graph.eDiscovery sont obsolètes. Utilisez les nouvelles API eDiscovery sous l’espace de noms microsoft.graph.security.

Supprimez définitivement les messages Microsoft Teams contenus dans un sourceCollection.

Remarque : Cette demande purge uniquement les données Teams. Il ne purge pas les autres types de données tels que les éléments de boîte aux lettres.

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

  • Conversations Teams 1:1 : messages de chat, messages 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 chat, messages 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 chat, billets, réponses et pièces jointes partagés dans un canal Teams standard.
  • Canaux privés : messages publiés, réponses et pièces jointes partagés dans un canal privé Teams.
  • Canaux partagés : messages électroniques, réponses et pièces jointes partagés dans un canal Teams partagé.

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

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

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet

Autorisations

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

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
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 /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/purgeData

En-têtes de demande

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

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

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

Si l’opération de purge des données a démarré correctement, cette action renvoie 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 purge des données qui a été créée pour valider la purge. Pour case activée le status de l’opération de purge des données, envoyez une requête GET à l’URL d’emplacement. Une fois la demande terminée avec succès, le status passe à succeeded.

Exemples

Demande

POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/purgeData

Réponse

HTTP/1.1 202 Accepted