次の方法で共有

ediscoverySearch: exportReport

  • [アーティクル]

名前空間: 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 アカウント) サポートされていません。 サポートされていません。
アプリケーション eDiscovery.Read.All eDiscovery.ReadWrite.All

HTTP 要求

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

要求ヘッダー

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

要求本文

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

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

パラメーター 型 説明
additionalOptions microsoft.graph.security.additionalOptions エクスポートの追加オプション。 使用可能な値: none、teamsAndYammerConversations、cloudAttachments、allDocumentVersions、subfolderContents、listAttachments、unknownFutureValue。 必須です。
説明 String エクスポート レポートの説明。
displayName String エクスポート レポートの表示名。
exportCriteria microsoft.graph.security.exportCriteria エクスポートする見積もりレポートの部分。 使用可能な値: searchHits、partiallyIndexed、unknownFutureValue。 必須です。
exportLocation microsoft.graph.security.exportLocation 部分的にインデックスが作成された項目の場所スコープ。 部分的にインデックスが付いた項目は、検索ヒットがあるレスポンシブな場所、またはすべての対象となる場所にのみ含めることができます。 使用可能な値: responsiveLocations、nonresponsiveLocations、unknownFutureValue。

応答

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

例

例 1: 検索ヒットのみのアイテムのレポートをエクスポートし、部分的にインデックス付きアイテムを除き、追加のオプションを使用しない

次の例は、検索ヒットのみのアイテムのレポートをエクスポートする方法を示しています。一部のインデックス付きアイテムは除き、追加のオプションは選択されていません。

要求

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

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

応答

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

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

例 2: 検索ヒットと部分的にインデックスが付いたアイテムのレポートをすべての対象の場所にエクスポートする(追加オプションなし)

次の例は、検索ヒットと部分的にインデックスが付いたアイテムのレポートをすべてのターゲットの場所にエクスポートする方法を示しています。その他のオプションは選択されていません。

要求

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

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

応答

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

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

例 3: 検索ヒットを含むアイテムのレポートをエクスポートし、検索ヒットがある場所に部分的にインデックスを付けたアイテムをエクスポートします。その他のオプションはありません

次の例は、検索ヒットを含むアイテムのレポートをエクスポートし、検索ヒットがある場所に部分的にインデックスが付いたアイテムをエクスポートする方法を示しています。その他のオプションは選択されていません。

要求

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

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

応答

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

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

例 4: すべての追加オプションが選択された対象のすべての場所で、部分的にインデックスが作成されたアイテムのレポートをエクスポートする

次の例では、すべての追加オプションが選択された対象のすべての場所で、部分的にインデックスが作成されたアイテムのレポートをエクスポートする方法を示します。

要求

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

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

応答

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

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

例 5: 検索ヒットとクラウド添付ファイルを含む場所に部分的にインデックスが付いたアイテムのレポートをエクスポートする

次の例では、検索ヒットとクラウド添付ファイルを含む場所に部分的にインデックスが作成されたアイテムのレポートをエクスポートする方法を示します。

要求

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

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

応答

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

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