Freigeben über

ediscoverySearch: exportResult

  • Artikel

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 von Ergebnissen aus einer geschätzten ediscoverySearch.Export results from an estimated 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}/exportResult
POST /security/cases/ediscoveryCases('{ediscoveryCaseId}')/searches('{ediscoverySearchId}')/exportResult

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 Exportergebnisses.
displayName String Der Anzeigename des Exportergebnisses.
exportCriteria microsoft.graph.security.exportCriteria Der Teil der zu exportierenden Schätzergebnisse. Die möglichen Werte sind: searchHits, partiallyIndexed, unknownFutureValue. Erforderlich.
exportFormat microsoft.graph.security.exportFormat Das gewünschte Format der exportierten E-Mails. Mögliche Werte sind: pst, msg, eml, 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 von Ergebnissen nur mit Suchtreffern, ausgenommen teilweise indizierte Elemente ohne zusätzliche Optionen, als PST-Dateien für jedes Postfach

Das folgende Beispiel zeigt, wie Ergebnisse nur mit Suchtreffern exportiert werden, ausgenommen teilweise indizierte Elemente, ohne dass zusätzliche Optionen ausgewählt sind, als PST-Dateien für jedes Postfach.

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/exportResult
Content-Type: application/json

{
  "displayName": "Export 1 - simple PST",
  "exportCriteria": "searchHits",
  "additionalOptions": "none",
  "exportFormat": "pst"
}

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('01826ce3-43a3-4235-a121-81d05926efae')

Beispiel 2: Exportieren Sie Ergebnisse mit Suchtreffern und teilweise indizierten Elementen an allen Speicherorten ohne zusätzliche Optionen als PST-Dateien für jedes Postfach.

Das folgende Beispiel zeigt, wie Ergebnisse mit Suchtreffern und teilweise indizierten Elementen an allen Speicherorten ohne zusätzliche Optionen als PST-Dateien für jedes Postfach exportiert werden.

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/exportResult
Content-Type: application/json

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

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('c74d3039-5c79-4093-8e45-2abb94e32ba9')

Beispiel 3: Exportieren von Ergebnissen mit Suchtreffern und teilweise indizierten Elementen an Speicherorten mit Suchtreffern ohne zusätzliche Optionen, wie .msg Dateien für jede Nachricht

Das folgende Beispiel zeigt, wie Ergebnisse mit Suchtreffern und teilweise indizierten Elementen an Speicherorten mit Suchtreffern ohne zusätzliche Optionen exportiert werden, als .msg Dateien für jede Nachricht.

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/exportResult
Content-Type: application/json

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

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('4bf812e0-44ad-4856-a302-b4ea79725573')

Beispiel 4: Exportieren von Ergebnissen mit teilweise indizierten Elementen an allen Zielspeicherorten mit allen zusätzlichen Optionen als .eml Dateien für jede Nachricht

Das folgende Beispiel zeigt, wie Sie Ergebnisse mit teilweise indizierten Elementen an allen Zielspeicherorten exportieren, wobei alle zusätzlichen Optionen als .eml Dateien für jede Nachricht 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/exportResult
Content-Type: application/json

{
  "displayName": "Export 4",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations, nonresponsiveLocations",
  "additionalOptions": "teamsAndYammerConversations, cloudAttachments, allDocumentVersions, subfolderContents, listAttachments",
  "exportFormat": "eml"
}

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('05b5c707-ed0d-4f5c-bbfd-e4941137baf1')

Beispiel 5: Exportieren von Ergebnissen mit teilweise indizierten Elementen an Suchtrefferspeicherorten mit Cloudanlagen als .eml Dateien für jede Nachricht

Das folgende Beispiel zeigt, wie Ergebnisse mit teilweise indizierten Elementen an Suchtrefferspeicherorten mit Cloudanlagen als .eml Dateien für jede Nachricht exportiert werden.

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/exportResult
Content-Type: application/json

{
  "displayName": "Export 5",
  "exportCriteria": "partiallyIndexed",
  "exportLocation": "responsiveLocations",
  "additionalOptions": "cloudAttachments",
  "exportFormat": "eml"
}

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('d488f23e-f3cb-4a1c-9b9f-88ac4342f534')