analyzedEmail: 修復

名前空間: microsoft.graph.security

重要

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

エンド ユーザーのメールボックスから潜在的な脅威を削除します。

修復とは、脅威に対して規定のアクションを実行することを意味します。 この API は、迷惑メールに移動、削除済みアイテムへの移動、論理的な削除、物理的な削除、受信トレイへの移動などのメール消去アクションをトリガーできます。 この API により、SOAR 統合、プレイブック、自動化などのシナリオやユースケースが可能になります。 詳細については 、「メールの修復」、「アクションのトリガー」、および「アクションの追跡」を参照してください。 誤検知がある場合、管理者は受信トレイに移動アクションを実行できます。

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

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

アクセス許可

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

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

HTTP 要求

POST /security/collaboration/analyzedEmails/remediate

要求ヘッダー

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

要求本文

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

次の表に、このアクションを呼び出すときに必要なパラメーターを示します。

パラメーター 型 説明
displayName 文字列 アクション センターで参照として使用される修復の名前。
説明 String 修復の説明。
severity microsoft.graph.security.remediationSeverity 修復の重大度。 使用可能な値: low、medium、high、unknownFutureValue。
action microsoft.graph.security.remediationAction サポートされている移動操作と削除操作の種類。 使用可能な値: moveToJunk、moveToInbox、hardDelete、softDelete、moveToDeletedItems、unknownFutureValue、moveToQuarantine。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次のメンバーを取得します: moveToQuarantine。
remediateSendersCopy ブール型 内部または送信メールの場合に、送信者のメール コピーを修正するかどうかを示します。
analyzedEmails microsoft.graph.security.analyzedEmail コレクション 分析された電子メールの networkMessageId と recipientEmailAddress の値が含まれます。

応答

成功した場合、このアクションは 202 Accepted 応答コードと、追跡情報へのリンクを含む Location ヘッダーを返します。

メモ: アクションへの応答は https://security.microsoft.com/action-center/history で追跡できます。 詳細については、「 アクション センターを使用する」を参照してください。

例

要求

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

POST https://graph.microsoft.com/beta/security/collaboration/analyzedEmails/remediate
Content-Type: application/json

{
    "displayName": "Clean up Phish email",
    "description": "Delete email",
    "severity": "medium",
    "action": "softDelete",
    "remediateSendersCopy": "false",
    "analyzedEmails": [
      {
        "networkMessageId": "73ca4154-58d8-43d0-a890-08dc18c52e6d",
        "recipientEmailAddress": "hannah.jarvis@contoso.com"
      },
      {
        "networkMessageId": "73ca4154-58d8-43d0-a890-08dc18c52e6d",
        "recipientEmailAddress": "preston.morales@contoso.com"
      }
    ]
}

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 202 Accepted
Location: https://security.microsoft.com/action-center/history?filters={"bulkId":["{bulkId}"]}&tid={tid}
Content-Type: application/json;text/plain
Content-Length: 0
  • Last updated on