Erstellen von ediscoveryReviewSetQuery

Namespace: microsoft.graph.security

Erstellen Sie ein neues ediscoveryReviewSetQuery-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 delegierten Zugriff über Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer über eine der folgenden Optionen eine unterstützte Microsoft Purview-Rolle zugewiesen werden:

  • eDiscovery-Manager: Ermöglicht Mitgliedern den Zugriff auf Überprüfungssätze in eDiscovery-Fällen, die sie erstellen und in denen sie Mitglieder sind. Dies ist die Option mit den geringsten Berechtigungen für den Zugriff auf Überprüfungssätze in ihren eigenen Fällen.
  • eDiscovery-Administrator. Bietet alle Berechtigungen des eDiscovery-Managers sowie die Möglichkeit, auf Überprüfungssätze in allen eDiscovery-Fällen im organization zuzugreifen.
  • Reviewer: Bietet schreibgeschützten Zugriff auf Überprüfungssätze in eDiscovery-Fällen, in denen der Benutzer Mitglied ist. Prüfer können Dokumente anzeigen und markieren, aber keine anderen Fallverwaltungsaufgaben ausführen.

Die Rolle Überprüfen ermöglicht Benutzern den Zugriff auf Prüfsätze in eDiscovery-Fällen, in denen sie Mitglieder sind. Benutzer können Dokumente in Überprüfungssätzen anzeigen und markieren, aber keine Suchergebnisse in der Vorschau 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/{ediscoveryReviewSetId}/queries

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 ediscoveryReviewSetQuery-Objekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie eine ediscoveryReviewSetQuery erstellen.

Eigenschaft Typ Beschreibung
displayName Zeichenfolge Der Name der Abfrage. Erforderlich.
contentQuery Zeichenfolge Die KQL-Abfrage für den Überprüfungssatz. Weitere Informationen finden Sie unter Abfragen und Filtern von Inhalten in einem Überprüfungssatz.

Antwort

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

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/queries
Content-Type: application/json

{
    "displayName": "My Query 1",
    "contentQuery": "(Author=\"edison\")"
}

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/v1.0/$metadata#security/cases/ediscoveryCases('58399dff-cebe-478f-b1af-d3227f1fd645')/reviewSets('273f11a1-17aa-419c-981d-ff10d33e420f')/queries/$entity",
    "description": null,
    "lastModifiedDateTime": "2022-05-29T23:39:51.3307953Z",
    "contentQuery": "((Author=\"edison\"))",
    "id": "fcb86cd1-50e0-427c-840e-ba6f087364e5",
    "displayName": "My Query 1",
    "createdDateTime": "2022-05-29T23:39:51.3307953Z",
    "createdBy": {
        "application": null,
        "user": {
            "id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
            "displayName": null,
            "userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
        }
    },
    "lastModifiedBy": {
        "application": null,
        "user": {
            "id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
            "displayName": null,
            "userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
        }
    }
}