電子情報開示検索: purgeData
名前空間: microsoft.graph.security
Exchange メールボックスアイテムを削除するか、 電子情報開示検索に含まれるメッセージをMicrosoft Teamsします。
手記: この要求では、場所ごとに最大 100 個のアイテムのみが消去されます。
次のカテゴリの Teams コンテンツを収集して消去できます。
- Teams 1:1 チャット - 2 人のユーザー間の Teams の会話で共有されるメッセージ、投稿、添付ファイルをチャットします。 Teams 1:1 チャットは 、会話とも呼ばれます。
- Teams グループ チャット - 3 人以上のユーザー間で Teams の会話で共有されるチャット メッセージ、投稿、添付ファイル。 1:N チャットまたはグループ会話とも呼ばれます。
- Teams チャネル - 標準の Teams チャネルで共有されているチャット メッセージ、投稿、返信、添付ファイル。
- プライベート チャネル - プライベート Teams チャネル で共有されているメッセージ投稿、返信、添付ファイル。
- 共有チャネル - 共有 Teams チャネル で共有されているメッセージ投稿、返信、添付ファイル。
Teams メッセージの消去の詳細については、次を参照してください。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | eDiscovery.ReadWrite.All | 注意事項なし。 |
委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
アプリケーション | サポートされていません。 | サポートされていません。 |
HTTP 要求
POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/purgeData
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
要求本文で、パラメーターの JSON 表現を指定します。
次の表に、このアクションで使用できるパラメーターを示します。
パラメーター | 型 | 説明 |
---|---|---|
purgeAreas | microsoft.graph.security.purgeAreas | 消去アクションのスコープ内の場所を定義するオプション。 可能な値は mailboxes 、teamsMessages 、unknownFutureValue です。 |
purgeType | microsoft.graph.security.purgeType | アクションが論理的な削除かハード削除かを制御するオプション。 可能な値は recoverable 、unknownFutureValue 、permanentlyDelete です。 |
応答
成功した場合、このアクションは 202 Accepted
応答コードを返します。
消去データ操作が正常に開始された場合、このアクションは応答コードを 202 Accepted
返します。 応答にはヘッダーも含まれています。このヘッダーには Location
、消去をコミットするために作成された データの消去操作 の場所が含まれています。 データの消去操作の状態をチェックするには、場所 URL に対して GET 要求を行います。
例
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/searches/c61a5860-d634-4d14-aea7-d82b6f4eb7af/purgeData
{
"purgeType": "recoverable",
"purgeAreas": "teamsMessages"
}
応答
次の例は応答を示しています。
HTTP/1.1 202 Accepted