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
Anwendung eDiscovery.Read.All eDiscovery.ReadWrite.All

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. Mögliche Werte sind: none, teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments, unknownFutureValue. Erforderlich.
description String Die Beschreibung des Exportberichts.
displayName String Der Anzeigename des Exportberichts.
exportCriteria microsoft.graph.security.exportCriteria Der Teil des zu exportierenden Schätzungsberichts. Die möglichen Werte sind: searchHits, partiallyIndexed, unknownFutureValue. Erforderlich.
exportLocation microsoft.graph.security.exportLocation Speicherortbereich für teilweise indizierte Elemente. 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.

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": "teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments"
}

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.

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

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')