ediscoveryReviewSet: export

名前空間: microsoft.graph.security

重要

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

reviewSet からのエクスポートを開始します。 詳細については、「 電子情報開示 (Premium) のレビュー セットからドキュメントをエクスポートする」を参照してください。

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

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

アクセス許可

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

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

重要

職場または学校アカウントを使用してアクセスを委任するには、サインインしたユーザーには、次のいずれかのオプションを使用してサポートされている Microsoft Purview ロール が割り当てられる必要があります。

  • 電子情報開示マネージャー。 メンバーが作成した電子情報開示ケースのカストディアンとデータ ソースを管理できるようにします。 ただし、電子情報開示マネージャーが管理できるのは、自分が作成したケースのカストディアンのみです。 これは、カストディアンを各自のケースで管理するための最低特権オプションです。
  • 電子情報開示管理者。 電子情報開示マネージャーのすべてのアクセス許可に加えて、organization内のすべての電子情報開示ケースのカストディアンとデータ ソースを管理する機能を提供します。

カストディアン ロールは、電子情報開示ケースのカストディアンに関連付けられているデータ ソース (メールボックス、SharePoint サイト、Teams) を管理するためのアクセスを提供します。 この役割は、電子情報開示マネージャー役割グループのメンバーのみが使用できます。

電子情報開示のアクセス許可と役割の詳細については、「 電子情報開示でアクセス許可を割り当てる」を参照してください。

HTTP 要求

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets/{ediscoveryReviewSetId}/export

要求ヘッダー

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

要求本文

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

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

パラメーター 型 説明
description String エクスポートの説明。
exportOptions microsoft.graph.security.exportOptions エクスポートの形式を制御するビット単位のオプション。 使用可能な値: originalFiles、text、pdfReplacement、fileInfo、tags、unknownFutureValue、splitSource、includeFolderAndPath、friendlyName、condensePaths。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から splitSource、includeFolderAndPath、friendlyName、condensePaths の値を取得します。 fileInfo メンバーは非推奨となり、データの返しを停止しました。 概要ファイルと読み込みファイルは常に含まれます。 originalFilesが選択されていない場合は、tags メンバーのみが考慮されます。
exportStructure microsoft.graph.security.exportFileStructure エクスポートのファイル構造とパッケージを制御するビット単位のオプション。 指定できる値は、 none、 directory (非推奨)、 pst、 unknownFutureValue、 msg です。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次のメンバーを取得します: msg。 directory メンバーは非推奨です。 下位互換性を確保するためにベータ版のままです。 その後は、 pst または msg を使用します。
outputName 文字列 エクスポートの名前。 必須です。
azureBlobContainer (非推奨) 文字列 独自の Azure ストレージ アカウントにエクスポートする場合、値はコンテナー URL になります。 azureBlobContainer プロパティは非推奨となり、データの返しを停止しました。
azureBlobToken (非推奨) 文字列 独自の Azure ストレージ アカウントにエクスポートする場合、コンテナー URL の SAS トークン。 azureBlobToken プロパティは非推奨であり、データの返しを停止しました。

応答

エクスポートが正常に開始された場合、このアクションは 202 Accepted 応答コードを返します。 応答には、エクスポートを処理するために作成されたエクスポート操作の場所を含む Location ヘッダーも含まれています。

例

要求

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

POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/reviewSets/273f11a1-17aa-419c-981d-ff10d33e420f/export
Content-Type: application/json

{
    "outputName": "Export via API",
    "description": "Export for the Contoso investigation",
    "exportOptions": "originalFiles, tags, splitSource, includeFolderAndPath, friendlyName, condensePaths",
    "exportStructure": "msg"
}

応答

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

HTTP/1.1 202 Accepted