获取扫描代理 ID

项目
05/03/2024

适用于：

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

想要体验Microsoft Defender 漏洞管理？了解如何注册免费试用版。

重要

本文中的某些信息与预发行的产品有关，该产品在商业发布之前可能有重大修改。 Microsoft 对此处所提供的信息不作任何明示或默示的保证。

注意

如果你是美国政府客户，请使用美国政府客户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 说明

按 ID 检索指定代理的详细信息。

限制

此 API 的速率限制是每分钟 100 个调用和每小时 1500 个调用。

权限

要调用此 API，需要以下权限之一。若要了解详细信息（包括如何选择权限），请参阅使用Microsoft Defender for Endpoint API。

权限类型	权限	权限显示名称
应用程序	Machine.Read.All	读取所有扫描信息。
委派（工作或学校帐户）	Machine.Read.All	读取所有扫描信息。

注意

使用用户凭据获取令牌时：

若要查看数据，用户至少需要具有以下角色权限：“ViewData”或“TvmViewData” (有关详细信息，请参阅Create和管理角色)

HTTP 请求

GET /api/DeviceAuthenticatedScanAgents

请求标头

名称	类型	说明
Authorization	String	持有者 {token}。必需。

请求正文

Empty

响应

如果成功，此方法返回 200 - OK 响应代码以及指定代理的详细信息。

示例请求

下面是请求的示例。

GET https://api.security.microsoft.com/api/DeviceAuthenticatedScanAgents/7f3d76a6976818553e996875dc91f55df6b26625

响应示例

{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#DeviceAuthenticatedScanAgents/$entity",
    "value": [
    {
    "id": "47df41a0c-asad-4fd6d3-bbea-a93dbc0bfcaa_4edd75b2407a5b64d704b4e53d74f15",
    "machineId": "4ejh675b240118fbehiuiy5b64d704b4e53d15",
    "lastSeen": "2022-05-08T12:18:41.538203Z",
    "computerDnsName": "TEST_DOMAIN",
    "AssignedApplicationId": "9E0FA0EB-0A51-4357-9C87-C21BFBE07571",
    "ScannerSoftwareVersion": "7.1.1",
    "LastCommandExecutionTimestamp": "2022-05-08T12:18:41.538203Z",
    "mdeClientVersion": "10.8295.22621.1195"
    },
   ]
}

提示

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

Share via