次の方法で共有


ediscoverySearch: exportResult

名前空間: microsoft.graph.security

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

推定 電子情報開示検索から結果をエクスポートします。 詳細については、「 コレクションの見積もりを管理する」を参照してください。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) eDiscovery.Read.All eDiscovery.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション サポートされていません。 サポートされていません。

HTTP 要求

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

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、パラメーターの JSON 表現を指定します。

次の表に、このアクションで使用できるパラメーターの一覧を示します。

パラメーター 種類 説明
additionalOptions microsoft.graph.security.additionalOptions エクスポートの追加オプション。 使用可能な値: noneteamsAndYammerConversationscloudAttachmentsallDocumentVersionssubfolderContentslistAttachmentsunknownFutureValue。 必須です。
説明 String エクスポート結果の説明。
displayName String エクスポート結果の表示名。
exportCriteria microsoft.graph.security.exportCriteria エクスポートする見積もり結果の部分。 使用可能な値: searchHitspartiallyIndexedunknownFutureValue。 必須です。
exportFormat microsoft.graph.security.exportFormat エクスポートされたメールの目的の形式。 使用可能な値: pstmsgemlunknownFutureValue。 必須です。
exportLocation microsoft.graph.security.exportLocation 部分的にインデックスが作成された項目の場所スコープ。 部分的にインデックスが付いた項目は、検索ヒットがあるレスポンシブな場所、またはすべての対象となる場所にのみ含めることができます。 使用可能な値: responsiveLocationsnonresponsiveLocationsunknownFutureValue

応答

エクスポートが正常に開始された場合、このアクションは応答コードを 202 Accepted 返します。 応答には、エクスポートを Location 処理するために作成された microsoft.graph.security.ediscoverySearchExportOperation の場所を含むヘッダーも含まれています。 エクスポート操作の状態をチェックするには、場所 URL に対して GET 要求を行います。

例 1: 検索ヒットのみを含む結果をエクスポートし、部分的にインデックス付きアイテムを除き、追加のオプションを使用せずに、各メールボックスの .pst ファイルとしてエクスポートする

次の例は、検索ヒットのみを含む結果をエクスポートする方法を示しています。一部のインデックス付きアイテムを除き、追加のオプションが選択されていない状態で、メールボックスごとに .pst ファイルとしてエクスポートします。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

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

例 2: 検索ヒットと部分的にインデックス付きアイテムを含む結果をすべての場所にエクスポートし、追加のオプションを使用せずに、各メールボックスの .pst ファイルとしてエクスポートします。

次の例では、検索ヒットと部分的にインデックス付きアイテムを含む結果をすべての場所にエクスポートし、追加のオプションを選択せずに、各メールボックスの .pst ファイルとしてエクスポートする方法を示します。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

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

例 3: 各メッセージの.msg ファイルとして、検索ヒットを含む場所に検索ヒットと部分的にインデックス付きアイテムを含む結果をエクスポートする

次の例は、検索ヒットを含む結果をエクスポートし、検索ヒットがある場所に部分的にインデックス付きアイテムをエクスポートする方法を示しています。各メッセージの.msg ファイルとして、追加のオプションは選択されていません。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

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

例 4: 各メッセージの.eml ファイルとして、すべての対象となる場所に部分的にインデックスが付いた項目を含む結果をエクスポートします。

次の例では、対象となるすべての場所で部分的にインデックスが付いた項目を含む結果をエクスポートし、すべての追加オプションを選択して、各メッセージの.eml ファイルとしてエクスポートする方法を示します。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

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

例 5: 検索ヒットの場所に部分的にインデックスが付いた項目を含む結果をエクスポートし、クラウドの添付ファイルを使用して、各メッセージの.emlファイルとしてエクスポートする

次の例は、検索ヒットの場所に部分的にインデックスが付いた項目を含む結果を、クラウドの添付ファイルと共に、各メッセージの.emlファイルとしてエクスポートする方法を示しています。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

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