Freigeben über


ediscoverySearch: exportReport

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.

Exportieren sie einen Elementbericht aus einer geschätzten ediscoverySearch. Weitere Informationen finden Sie unter Verwalten einer Sammlungsschätzung.

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

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

  • eDiscovery-Manager: Mit dieser Rolle können Mitglieder eDiscovery-Fälle erstellen und verwalten, die sie erstellen, einschließlich der Erstellung von Verwahrern, Haltebereichen, Suchvorgängen und anderen Aufgaben zur Fallverwaltung. eDiscovery-Manager können jedoch nur die von ihnen erstellten Fälle erstellen und verwalten. Dies ist die Option mit den geringsten Berechtigungen für die Verwaltung ihrer eigenen Fälle.
  • eDiscovery-Administrator. Diese Rolle bietet alle Berechtigungen des eDiscovery-Managers sowie die Möglichkeit, auf alle eDiscovery-Fälle im organization zuzugreifen und diese zu verwalten, eDiscovery-Einstellungen zu konfigurieren und alle Fälle zu verwalten, nachdem Sie sich selbst als Mitglied hinzugefügt haben.

Zusätzliche Rollen, die Schreibzugriff auf eDiscovery-Features bieten:

  • Complianceadministrator. Diese Rolle umfasst die Berechtigungen "Fallverwaltung", "Compliancesuche" und "Hold".
  • Organisationsverwaltung. Diese Rolle umfasst die Berechtigungen "Fallverwaltung", "Compliancesuche", "Halten" und "Suchen und Bereinigen".

Die Rollen eDiscovery-Manager und eDiscovery-Administrator sind Teil der Microsoft Purview-Rollengruppen und bieten zugriff auf eDiscovery-Features über die rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC).

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

HTTP-Anforderung

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/exportReport
POST /security/cases/ediscoveryCases('{ediscoveryCaseId}')/searches('{ediscoverySearchId}')/exportReport

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 der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, die Sie mit dieser Aktion verwenden können.

Parameter Typ Beschreibung
Additionaloptions microsoft.graph.security.additionalOptions Die zusätzlichen Optionen für den Export. Unterstützt eine Teilmenge der Werte für additionalOptions. Mögliche Werte sind: none, teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments, unknownFutureValue, htmlTranscripts, advancedIndexing, allItemsInFolder. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verwertbaren Enumeration abzurufen: htmlTranscripts, advancedIndexing, allItemsInFolder. Der advancedIndexing Wert ist nur verfügbar, wenn exportCriteria enthält partiallyIndexed. Erforderlich.
cloudAttachmentVersion microsoft.graph.security.cloudAttachmentVersion Die Versionen von Cloudanlagen, die in Nachrichten eingeschlossen werden sollen. Mögliche Werte sind: latest, recent10, recent100, all, unknownFutureValue. Der Standardwert ist latest.
description Zeichenfolge Die Beschreibung des Exportberichts.
documentVersion microsoft.graph.security.documentVersion Die Versionen von Dateien in SharePoint, die eingeschlossen werden sollen. Mögliche Werte sind: latest, recent10, recent100, all, unknownFutureValue. Der Standardwert ist latest.
displayName Zeichenfolge Der Anzeigename des Exportberichts.
exportCriteria microsoft.graph.security.exportCriteria Bitweise Optionen, die den Teil des zu exportierenden Schätzungsberichts angeben. Die möglichen Werte sind: searchHits, partiallyIndexed, unknownFutureValue. Erforderlich.
exportLocation microsoft.graph.security.exportLocation Bitweise Optionen, die den Speicherortbereich für teilweise indizierte Elemente angeben. Sie können nur teilweise indizierte Elemente an reaktionsfähigen Speicherorten mit Suchtreffern oder an allen Zielorten einschließen. Die möglichen Werte sind: responsiveLocations, nonresponsiveLocations, unknownFutureValue. Der nonresponsiveLocations Wert ist nur verfügbar, wenn exportCriteria enthält partiallyIndexed.

Antwort

Wenn der Export erfolgreich gestartet wurde, gibt diese Aktion einen 202 Accepted Antwortcode zurück. Die Antwort enthält auch einen Location Header, der den Speicherort der microsoft.graph.security.ediscoverySearchExportOperation enthält, die zum Verarbeiten des Exports erstellt wurde. Um die status des Exportvorgangs zu überprüfen, senden Sie eine GET-Anforderung an die Standort-URL.

Beispiele

Beispiel 1: Exportieren eines Berichts von Elementen mit nur Suchtreffern, ohne teilweise indizierte Elemente, ohne zusätzliche Optionen

Das folgende Beispiel zeigt, wie Sie einen Bericht von Elementen exportieren, die nur Suchtreffer enthalten, ohne dass teilweise indizierte Elemente ohne zusätzliche Optionen ausgewählt sind.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportReport
Content-Type: application/json

{
  "displayName": "Export 1",
  "exportCriteria": "searchHits",
  "additionalOptions": "none"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('f57fc79d-bea8-42ac-b0be-217302d5683c')

Beispiel 2: Exportieren eines Berichts von Elementen mit Suchtreffern und teilweise indizierten Elementen an allen Zielspeicherorten ohne zusätzliche Optionen

Das folgende Beispiel zeigt, wie Sie einen Bericht mit Elementen mit Suchtreffern und teilweise indizierten Elementen an allen Zielspeicherorten ohne zusätzliche Optionen exportieren.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportReport
Content-Type: application/json

{
  "displayName": "Export 2",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "none"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('cbcb4807-e76e-4ef0-bd5b-e2177c13f07e')

Beispiel 3: Exportieren eines Berichts von Elementen mit Suchtreffern und teilweise indizierten Elementen an Speicherorten mit Suchtreffern ohne zusätzliche Optionen

Das folgende Beispiel zeigt, wie Sie einen Bericht von Elementen mit Suchtreffern und teilweise indizierten Elementen an Speicherorten mit Suchtreffern ohne zusätzliche Optionen exportieren.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportReport
Content-Type: application/json

{
  "displayName": "Export 3",
  "exportCriteria": "searchHits, partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "none"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('c56f66de-b780-4efc-aa0c-4ef3271ad6b4')

Beispiel 4: Exportieren eines Berichts von teilweise indizierten Elementen an allen Zielspeicherorten mit allen zusätzlichen Optionen

Das folgende Beispiel zeigt, wie Sie einen Bericht mit teilweise indizierten Elementen an allen Zielspeicherorten exportieren, wobei alle zusätzlichen Optionen ausgewählt sind.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportReport
Content-Type: application/json

{
  "displayName": "Export 4",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "advancedIndexing, subfolderContents, allItemsInFolder, listAttachments, teamsAndYammerConversations, htmlTranscripts, cloudAttachments"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('572d44e2-5e77-4443-a2ed-cd036bdc0304')

Beispiel 5: Exportieren eines Berichts von teilweise indizierten Elementen an Speicherorten mit Suchtreffern und Cloudanlagen

Das folgende Beispiel zeigt, wie Sie einen Bericht mit teilweise indizierten Elementen an Speicherorten mit Suchtreffern und Cloudanlagen exportieren, einschließlich der Anzahl der Dokument- und Cloudanlagenversionen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/dbc06feb-a6a5-46a2-8e4e-534353b071e4/searches/6c2ab774-2d2a-46b9-a601-3130f518757b/exportReport
Content-Type: application/json

{
  "displayName": "Export 5",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "cloudAttachments",
  "cloudAttachmentVersion": "all",
  "doucmentVersion": "recent100"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted
Content-Length: 0
Location: https://graph.microsoft.com/beta/security/cases/ediscoverycases('dbc06feb-a6a5-46a2-8e4e-534353b071e4')/operations('788159f9-f860-43f2-8fc5-0fc17df0e696')