You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-domain-related-machines.md
+22-18Lines changed: 22 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ ms.topic: reference
15
15
ms.subservice: reference
16
16
ms.custom: api
17
17
search.appverid: met150
18
-
ms.date: 12/18/2020
18
+
ms.date: 11/03/2024
19
19
---
20
20
21
21
# Get domain-related machines API
@@ -38,27 +38,26 @@ ms.date: 12/18/2020
38
38
Retrieves a collection of [Machines](machine.md) that have communicated to or from a given domain address.
39
39
40
40
## Limitations
41
-
42
-
1. You can query on devices last updated according to your configured retention period.
43
-
2. Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
41
+
42
+
- You can query on devices last updated according to your configured retention period.
43
+
- Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
44
+
- Responses are limited to 500 devices in results.
44
45
45
46
## Permissions
46
47
47
48
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Use Microsoft Defender for Endpoint APIs](apis-intro.md)
48
49
49
-
Permission type|Permission|Permission display name
50
-
:---|:---|:---
51
-
Application|Machine.Read.All|'Read all machine profiles'
52
-
Application|Machine.ReadWrite.All|'Read and write all machine information'
53
-
Delegated (work or school account)|Machine.Read|'Read machine information'
54
-
Delegated (work or school account)|Machine.ReadWrite|'Read and write machine information'
|Application|`Machine.Read.All`|`Read all machine profiles`|
53
+
|Application|`Machine.ReadWrite.All`|`Read and write all machine information`|
54
+
|Delegated (work or school account)|`Machine.Read`|`Read machine information`|
55
+
|Delegated (work or school account)|`Machine.ReadWrite`|`Read and write machine information`|
55
56
56
57
> [!NOTE]
57
58
> When obtaining a token using user credentials:
58
-
>
59
-
> - The user needs to have at least the following role permission: 'View Data' (For more information, see [Create and manage roles](../user-roles.md)
60
-
> - Response will include only devices that the user can access, based on device group settings (For more information, see [Create and manage device groups](../machine-groups.md)
61
-
>
59
+
> - The user must have at least the following role permission: `View Data`. For more information, see [Create and manage roles](../user-roles.md).
60
+
> - Responses include only devices that the user can access, based on device group settings. For more information, see [Create and manage device groups](../machine-groups.md).
62
61
> Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
63
62
64
63
## HTTP request
@@ -69,17 +68,21 @@ GET /api/domains/{domain}/machines
0 commit comments