sourceCollection: purgeData

Namespace: microsoft.graph.ediscovery

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Achtung

Die eDiscovery-APIs im Unternamespace "microsoft.graph.eDiscovery" sind veraltet. Verwenden Sie die neuen eDiscovery-APIs unter dem Unternamespace "microsoft.graph.security".

Löschen Sie Microsoft Teams-Nachrichten, die in einer sourceCollection enthalten sind, endgültig.

Hinweis: Diese Anforderung löscht nur Teams-Daten. Andere Arten von Daten, wie z. B. Postfachelemente, werden nicht gelöscht.

Sie können die folgenden Kategorien von Teams-Inhalten sammeln und löschen:

  • Teams 1:1-Chats: Chat-Nachrichten, -Beiträge und -Anlagen, die in einer Teams-Unterhaltung zwischen zwei Personen geteilt werden. Teams 1:1-Chats werden auch als Unterhaltungen bezeichnet.
  • Teams-Gruppenchats: Chatnachrichten, Beiträge und Anlagen, die in einer Teams-Unterhaltung zwischen drei oder mehr Personen freigegeben werden, Chat. Sie werden auch als 1:N-Chats oder Gruppenunterhaltungen bezeichnet.
  • Teams-Kanäle: Chatnachrichten, Beiträge, Antworten und Anhänge, die in einem standardmäßigen Teams-Kanal freigegeben werden, Chat.
  • Private Kanäle – In einem privaten Teams-Kanal geteilte Nachrichtenbeiträge, Antworten und Anlagen.
  • Freigegebene Kanäle – In einem freigegebenen Teams-Kanal geteilte Nachrichtenbeiträge, Antworten und Anlagen.

Weitere Informationen zum Löschen von Teams-Nachrichten finden Sie unter:

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) eDiscovery.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application eDiscovery.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

POST /compliance/ediscovery/cases/{caseId}/sourceCollections/{sourceCollectionId}/purgeData

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben.

Wenn der Datenlöschvorgang erfolgreich gestartet wird, gibt diese Aktion einen 202 Accepted Antwortcode zurück. Die Antwort enthält auch einen Location Header, der den Speicherort des Datenlöschvorgangs enthält, der zum Ausführen des Löschvorgangs erstellt wurde. Um den Status des Datenlöschvorgangs zu überprüfen, stellen Sie eine GET-Anforderung an die Standort-URL. Wenn die Anforderung erfolgreich abgeschlossen wurde, ändert sich der Status in succeeded.

Beispiele

Anforderung

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

Antwort

HTTP/1.1 202 Accepted