Erstellen von reviewSets

Namespace: microsoft.graph.security

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.

Erstellen Sie ein neues eDiscoveryReviewSet-Objekt .

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.Read.All eDiscovery.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application eDiscovery.Read.All eDiscovery.ReadWrite.All

Wichtig

Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Purview-Rolle über eine der folgenden Optionen zugewiesen werden:

  • eDiscovery-Manager: Ermöglicht Mitgliedern den Zugriff auf Prüfdateisätze in eDiscovery-Fällen, die sie erstellen und in denen sie Mitglied sind. Dies ist die am wenigsten privilegierte Option für den Zugriff auf Prüfdateisätze in ihren eigenen Fällen.
  • eDiscovery-Administrator. Bietet alle Berechtigungen des eDiscovery-Managers sowie die Möglichkeit des Zugriffs auf Prüfsätze in allen eDiscovery-Fällen in der organization.
  • Reviewer: Bietet schreibgeschützten Zugriff auf Prüfdateisätze in eDiscovery-Fällen, in denen der Benutzer Mitglied ist. Prüfer können Dokumente anzeigen und markieren, aber keine anderen Aufgaben der Fallverwaltung ausführen.

Die Review-Rolle ermöglicht Benutzern den Zugriff auf Retrace-Sätze in eDiscovery-Fällen, denen sie angehören. Benutzer können Dokumente in Prüfkeitssätzen anzeigen und markieren, aber keine Vorschau von Suchergebnissen anzeigen oder andere Such- oder Fallverwaltungsaufgaben ausführen.

Weitere Informationen zu eDiscovery-Berechtigungen und -Rollen finden Sie unter Zuweisen von Berechtigungen in eDiscovery.

HTTP-Anforderung

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des ediscoveryReviewSet-Objekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie ein ediscoveryReviewSet erstellen.

Eigenschaft Typ Beschreibung
description Zeichenfolge Die Beschreibung des Bewertungssets.
displayName Zeichenfolge Der Name des Prüfdateisets. Erforderlich.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein microsoft.graph.security.ediscoveryReviewSet-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/reviewSets
Content-Type: application/json

{
    "displayName": "My review set 2"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/reviewSets/$entity",
    "displayName": "My review set 2",
    "id": "887306f5-1eb4-4409-b18c-ba47f4e3fa9b",
    "createdDateTime": "2022-05-23T16:33:13.5126494Z",
    "createdBy": {
        "application": null,
        "user": {
            "id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
            "displayName": null,
            "userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
        }
    }
}