支持的 Microsoft Defender for Endpoint API

  • 项目

适用于：

重要

高级搜寻功能不包括在 Defender for Business 中。

希望体验 Microsoft Defender for Endpoint？ 注册免费试用版。

终结点 URI 和版本控制

终结点 URI

服务基 URI 为： https://api.security.microsoft.com

基于查询的 OData 具有“/api”前缀。 例如，若要获取警报，可将 GET 请求发送到 https://api.security.microsoft.com/api/alerts

版本控制

API 支持版本控制。

当前版本为 V1.0。 若要使用特定版本，请使用以下格式： https://api.security.microsoft.com/api/{Version}。 例如：https://api.security.microsoft.com/api/v1.0/alerts

如果未指定任何版本 (例如 https://api.security.microsoft.com/api/alerts) 将获取最新版本。

注意

如果你是美国政府客户，请使用美国政府客户Microsoft Defender for Endpoint中列出的 URI。

提示

为了提高性能，可以使用离地理位置更近的服务器：

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com

详细了解可以运行 API 调用的各个受支持实体，以及 HTTP 请求值、请求标头和预期响应等详细信息。

本节内容

主题 说明
高级搜寻 方法 从 API 运行查询。
警报 方法和属性 运行 API 调用，例如 - 获取警报、创建警报、更新警报等。
导出每个设备的 评估 方法和属性 运行 API 调用以按设备收集漏洞评估，例如：- 导出安全配置评估、导出软件清单评估、导出软件漏洞评估和增量导出软件漏洞评估。
自动调查 方法和属性 运行 API 调用，例如 - 获取调查集合。
导出设备运行状况方法和属性 运行 API 调用，例如 - GET /api/public/avdeviceshealth。
域相关警报 运行 API 调用，例如 - 获取域相关设备、域统计信息等。
文件 方法和属性 运行 API 调用，例如 - 获取文件信息、文件相关警报、文件相关设备和文件统计信息。
指示器 方法和属性 运行 API 调用，例如 - 获取指标、创建指示器和删除指示器。
与 IP 相关的警报 运行 API 调用，例如 - 获取与 IP 相关的警报和获取 IP 统计信息。
计算机 方法和属性 运行 API 调用，例如 - 获取设备、按 ID 获取设备、有关登录用户的信息、编辑标记等。
计算机操作 方法和属性 运行 API 调用，例如 - 隔离、运行防病毒扫描等。
建议 方法和属性 运行 API 调用，例如 - 按 ID 获取建议。
修正活动 方法和属性 运行 API 调用，例如 - 获取所有修正任务、获取公开的设备修正任务以及按 ID 获取一个修正任务。
评分 方法和属性 运行 API 调用，例如 - 获取曝光分数或获取设备安全功能分数。
软件 方法和属性 运行 API 调用，例如 - 按软件列出漏洞。
用户 方法和属性 运行 API 调用，例如 - 获取与用户相关的警报和与用户相关的设备。
漏洞 方法和属性 运行 API 调用，例如 - 按漏洞列出设备。

另请参阅

提示

想要了解更多信息？ Engage技术社区中的 Microsoft 安全社区：Microsoft Defender for Endpoint技术社区。