获取计算机登录用户 API
适用于:
希望体验 Microsoft Defender for Endpoint? 注册免费试用版。
注意
如果你是美国政府客户,请使用 适用于美国政府客户的 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
- ina.api.security.microsoft.com
API 说明
检索特定设备上已登录用户的集合。
限制
- 可以根据配置的保留期查询上次更新的警报。
- 此 API 的速率限制是每分钟 100 个调用和每小时 1500 个调用。
权限
要调用此 API,需要以下权限之一。 若要了解详细信息(包括如何选择权限),请参阅 使用 Microsoft Defender for Endpoint API
权限类型 | 权限 | 权限显示名称 |
---|---|---|
Application | User.Read.All | “读取用户配置文件” |
委派(工作或学校帐户) | User.Read.All | “读取用户配置文件” |
注意
使用用户凭据获取令牌时:
Defender for Endpoint 计划 1 和计划 2 支持创建设备组。
HTTP 请求
GET /api/machines/{id}/logonusers
请求标头
名称 | 类型 | 说明 |
---|---|---|
Authorization | String | 持有者 {token}。 必需。 |
请求正文
Empty
响应
如果成功且存在设备 - 200 正常,正文中包含 用户 实体列表。 如果未找到设备 - 404 未找到。
示例
请求
下面是请求的示例。
GET https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/logonusers
响应
以下是响应示例。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Users",
"value": [
{
"id": "contoso\\user1",
"accountName": "user1",
"accountDomain": "contoso",
"firstSeen": "2019-12-18T08:02:54Z",
"lastSeen": "2020-01-06T08:01:48Z",
"logonTypes": "Interactive",
"isDomainAdmin": true,
"isOnlyNetworkUser": false
},
...
]
}
提示
想要了解更多信息? 在技术社区中与 Microsoft 安全社区互动: Microsoft Defender for Endpoint 技术社区。