Freigeben über


ediscoverySearch: purgeData

Namespace: microsoft.graph.security

Löschen Sie Exchange-Postfachelemente oder Microsoft Teams-Nachrichten, die in einer eDiscovery-Suche enthalten sind.

Anmerkung: Diese Anforderung löscht maximal 100 Elemente pro Standort.

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

  • Teams 1:1-Chats : Chatnachrichten, Beiträge und Anlagen, die in einer Teams-Unterhaltung zwischen zwei Personen geteilt wurden. 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 geteilt wurden. Auch als 1:N-Chats oder Gruppenunterhaltungen bezeichnet.
  • Teams-Kanäle : Chatnachrichten, Beiträge, Antworten und Anlagen, die in einem Standardmäßigen Teams-Kanal geteilt werden.
  • Private Kanäle : Nachrichtenbeiträge, Antworten und Anlagen, die in einem privaten Teams-Kanal freigegeben sind.
  • Freigegebene Kanäle : Nachrichtenbeiträge, Antworten und Anlagen, die in einem freigegebenen Teams-Kanal freigegeben wurden.

Weitere Informationen zum Bereinigen 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
Anwendung eDiscovery.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

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

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

Die folgende Tabelle zeigt die Parameter, die Sie mit dieser Aktion verwenden können.

Parameter Typ Beschreibung
purgeAreas microsoft.graph.security.purgeAreas Option zum Definieren der Speicherorte, die sich im Bereich der Bereinigungsaktion befinden sollen. Mögliche Werte sind: mailboxes, teamsMessages und unknownFutureValue.
purgeType microsoft.graph.security.purgeType Optionen, die steuern, ob die Aktion vorläufiges oder endgültiges Löschen ist. Mögliche Werte sind: recoverable, unknownFutureValue und permanentlyDelete.

Antwort

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

Wenn der Vorgang zum Bereinigen von Daten erfolgreich gestartet wurde, gibt diese Aktion einen 202 Accepted Antwortcode zurück. Die Antwort enthält auch einen Location -Header, der den Speicherort des Vorgangs Bereinigen von Daten enthält, der zum Committen der Bereinigung erstellt wurde. Um die status des Datenlöschvorgangs zu überprüfen, senden Sie eine GET-Anforderung an die Standort-URL.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted