mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-16 07:17:24 +00:00
s
This commit is contained in:
parent
a19416f915
commit
f35962ddce
@ -14,13 +14,12 @@ ms.date: 12/08/2017
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Get machine by ID API
|
# Get machine by ID API
|
||||||
**Applies to:**
|
|
||||||
|
|
||||||
- Windows Defender Advanced Threat Protection (Windows Defender ATP)
|
|
||||||
|
|
||||||
|
|
||||||
[!include[Prerelease information](prerelease.md)]
|
[!include[Prerelease information](prerelease.md)]
|
||||||
|
|
||||||
|
**Applies to:**
|
||||||
|
|
||||||
|
- Windows Defender Advanced Threat Protection (Windows Defender ATP)
|
||||||
Retrieves a machine entity by ID.
|
Retrieves a machine entity by ID.
|
||||||
|
|
||||||
## Permissions
|
## Permissions
|
||||||
@ -78,13 +77,13 @@ Content-type: application/json
|
|||||||
"id": "1e5bc9d7e413ddd7902c2932e418702b84d0cc07",
|
"id": "1e5bc9d7e413ddd7902c2932e418702b84d0cc07",
|
||||||
"computerDnsName": "mymachine1.contoso.com",
|
"computerDnsName": "mymachine1.contoso.com",
|
||||||
"firstSeen": "2018-08-02T14:55:03.7791856Z",
|
"firstSeen": "2018-08-02T14:55:03.7791856Z",
|
||||||
|
"lastSeen": "2018-08-02T14:55:03.7791856Z",
|
||||||
"osPlatform": "Windows10",
|
"osPlatform": "Windows10",
|
||||||
"osVersion": null,
|
"osVersion": null,
|
||||||
"systemProductName": null,
|
"systemProductName": null,
|
||||||
"lastIpAddress": "172.17.230.209",
|
"lastIpAddress": "172.17.230.209",
|
||||||
"lastExternalIpAddress": "167.220.196.71",
|
"lastExternalIpAddress": "167.220.196.71",
|
||||||
"agentVersion": "10.5830.18209.1001",
|
"agentVersion": "10.5830.18209.1001",
|
||||||
"groupName": null,
|
|
||||||
"osBuild": 18209,
|
"osBuild": 18209,
|
||||||
"healthStatus": "Active",
|
"healthStatus": "Active",
|
||||||
"isAadJoined": true,
|
"isAadJoined": true,
|
||||||
|
@ -14,16 +14,16 @@ ms.date: 12/08/2017
|
|||||||
---
|
---
|
||||||
|
|
||||||
# List machines API
|
# List machines API
|
||||||
|
|
||||||
|
[!include[Prerelease information](prerelease.md)]
|
||||||
|
|
||||||
**Applies to:**
|
**Applies to:**
|
||||||
|
|
||||||
- Windows Defender Advanced Threat Protection (Windows Defender ATP)
|
- Windows Defender Advanced Threat Protection (Windows Defender ATP)
|
||||||
|
|
||||||
|
|
||||||
[!include[Prerelease information](prerelease.md)]
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Retrieves a collection of machines that have communicated with WDATP cloud on the last 30 days.
|
Retrieves a collection of machines that have communicated with WDATP cloud on the last 30 days.
|
||||||
|
Get Machines collection API supports [OData V4 queries](https://www.odata.org/documentation/).
|
||||||
|
The OData's Filter query is supported on: "Id", "ComputerDnsName", "LastSeen", "LastIpAddress", "HealthStatus", "OsPlatform", "RiskScore" and "RbacGroupId"
|
||||||
|
|
||||||
## Permissions
|
## Permissions
|
||||||
|
|
||||||
@ -36,7 +36,7 @@ Delegated (work or school account) | Machine.ReadWrite | 'Read and write machine
|
|||||||
|
|
||||||
## HTTP request
|
## HTTP request
|
||||||
```
|
```
|
||||||
GET /api/machines
|
GET https://api.securitycenter.windows.com/api/machines
|
||||||
```
|
```
|
||||||
|
|
||||||
## Request headers
|
## Request headers
|
||||||
@ -80,13 +80,13 @@ Content-type: application/json
|
|||||||
"id": "1e5bc9d7e413ddd7902c2932e418702b84d0cc07",
|
"id": "1e5bc9d7e413ddd7902c2932e418702b84d0cc07",
|
||||||
"computerDnsName": "mymachine1.contoso.com",
|
"computerDnsName": "mymachine1.contoso.com",
|
||||||
"firstSeen": "2018-08-02T14:55:03.7791856Z",
|
"firstSeen": "2018-08-02T14:55:03.7791856Z",
|
||||||
|
"lastSeen": "2018-08-02T14:55:03.7791856Z",
|
||||||
"osPlatform": "Windows10",
|
"osPlatform": "Windows10",
|
||||||
"osVersion": null,
|
"osVersion": null,
|
||||||
"systemProductName": null,
|
"systemProductName": null,
|
||||||
"lastIpAddress": "172.17.230.209",
|
"lastIpAddress": "172.17.230.209",
|
||||||
"lastExternalIpAddress": "167.220.196.71",
|
"lastExternalIpAddress": "167.220.196.71",
|
||||||
"agentVersion": "10.5830.18209.1001",
|
"agentVersion": "10.5830.18209.1001",
|
||||||
"groupName": null,
|
|
||||||
"osBuild": 18209,
|
"osBuild": 18209,
|
||||||
"healthStatus": "Active",
|
"healthStatus": "Active",
|
||||||
"isAadJoined": true,
|
"isAadJoined": true,
|
||||||
@ -99,13 +99,13 @@ Content-type: application/json
|
|||||||
"id": "7292e4b8cb74ff1cc3d8a495eb29dc8858b732f7",
|
"id": "7292e4b8cb74ff1cc3d8a495eb29dc8858b732f7",
|
||||||
"computerDnsName": "mymachine2.contoso.com",
|
"computerDnsName": "mymachine2.contoso.com",
|
||||||
"firstSeen": "2018-07-09T13:22:45.1250071Z",
|
"firstSeen": "2018-07-09T13:22:45.1250071Z",
|
||||||
|
"lastSeen": "2018-07-09T13:22:45.1250071Z",
|
||||||
"osPlatform": "Windows10",
|
"osPlatform": "Windows10",
|
||||||
"osVersion": null,
|
"osVersion": null,
|
||||||
"systemProductName": null,
|
"systemProductName": null,
|
||||||
"lastIpAddress": "192.168.12.225",
|
"lastIpAddress": "192.168.12.225",
|
||||||
"lastExternalIpAddress": "79.183.65.82",
|
"lastExternalIpAddress": "79.183.65.82",
|
||||||
"agentVersion": "10.5820.17724.1000",
|
"agentVersion": "10.5820.17724.1000",
|
||||||
"groupName": "WDATPClientTeam",
|
|
||||||
"osBuild": 17724,
|
"osBuild": 17724,
|
||||||
"healthStatus": "Inactive",
|
"healthStatus": "Inactive",
|
||||||
"isAadJoined": true,
|
"isAadJoined": true,
|
||||||
|
@ -30,14 +30,14 @@ Property | Type | Description
|
|||||||
id | String | [machine](machine-windows-defender-advanced-threat-protection-new.md) identity.
|
id | String | [machine](machine-windows-defender-advanced-threat-protection-new.md) identity.
|
||||||
computerDnsName | String | [machine](machine-windows-defender-advanced-threat-protection-new.md) fully qualified name.
|
computerDnsName | String | [machine](machine-windows-defender-advanced-threat-protection-new.md) fully qualified name.
|
||||||
firstSeen | DateTimeOffset | First date and time where the [machine](machine-windows-defender-advanced-threat-protection-new.md) was observed by WDATP.
|
firstSeen | DateTimeOffset | First date and time where the [machine](machine-windows-defender-advanced-threat-protection-new.md) was observed by WDATP.
|
||||||
|
lastSeen | DateTimeOffset | Last date and time where the [machine](machine-windows-defender-advanced-threat-protection-new.md) was observed by WDATP.
|
||||||
osPlatform | String | OS platform.
|
osPlatform | String | OS platform.
|
||||||
osVersion | String | OS Version.
|
osVersion | String | OS Version.
|
||||||
lastIpAddress | Ip | Last IP on local NIC on the [machine](machine-windows-defender-advanced-threat-protection-new.md).
|
lastIpAddress | Ip | Last IP on local NIC on the [machine](machine-windows-defender-advanced-threat-protection-new.md).
|
||||||
lastExternalIpAddress | Ip | Last IP through which the [machine](machine-windows-defender-advanced-threat-protection-new.md) accessed the internet.
|
lastExternalIpAddress | Ip | Last IP through which the [machine](machine-windows-defender-advanced-threat-protection-new.md) accessed the internet.
|
||||||
agentVersion | String | Version of WDATP agent.
|
agentVersion | String | Version of WDATP agent.
|
||||||
groupName | String | [machine](machine-windows-defender-advanced-threat-protection-new.md) group name (when defined).
|
|
||||||
osBuild | Int | OS build number.
|
osBuild | Int | OS build number.
|
||||||
healthStatus | String | [machine](machine-windows-defender-advanced-threat-protection-new.md) health status.
|
healthStatus | Enum | [machine](machine-windows-defender-advanced-threat-protection-new.md) health status. Possible values are: "Active", "Inactive", "ImpairedCommunication", "NoSensorData" and "NoSensorDataImpairedCommunication"
|
||||||
isAadJoined | Boolean | Is [machine](machine-windows-defender-advanced-threat-protection-new.md) AAD joined.
|
isAadJoined | Boolean | Is [machine](machine-windows-defender-advanced-threat-protection-new.md) AAD joined.
|
||||||
machineTags | String collection | Set of [machine](machine-windows-defender-advanced-threat-protection-new.md) tags.
|
machineTags | String collection | Set of [machine](machine-windows-defender-advanced-threat-protection-new.md) tags.
|
||||||
rbacGroupId | Int | Group ID.
|
rbacGroupId | Int | Group ID.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user