Skip to content

Commit ed97e9b

Browse files
authored
Merge pull request #2829 from MicrosoftDocs/mde-trial
link fixes
2 parents 1d913d7 + bf0bf13 commit ed97e9b

38 files changed

+57
-61
lines changed

defender-endpoint/api/Get-scan-history-by-definition.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Get scan history by definition
3-
description: Learn how to use the get scan history by definition api
3+
description: Learn how to use the get scan history by definition API
44
ms.service: defender-endpoint
55
ms.author: deniseb
66
author: denisebmsft
@@ -29,7 +29,7 @@ ms.date: 12/15/2022
2929
- [Microsoft Defender Vulnerability Management](/defender-vulnerability-management)
3030
- [Microsoft Defender XDR](/defender-xdr)
3131

32-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
32+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3333
3434
> Want to experience Microsoft Defender Vulnerability Management? Find out how to [sign up for a free trial](/defender-vulnerability-management/get-defender-vulnerability-management).
3535
@@ -52,7 +52,7 @@ For an example of OData operation usage, see [example $top request](#example-top
5252

5353
## Limitations
5454

55-
1. Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
55+
1. Rate limitations for this API are 100 calls per minute and 1,500 calls per hour.
5656

5757
## Permissions
5858

@@ -63,10 +63,7 @@ One of the following permissions is required to call this API. To learn more, in
6363
|Application|Machine.Read.All| Read all scan information.|
6464
|Delegated (work or school account)|Machine.Read.All|Read all scan information.|
6565

66-
> [!NOTE]
67-
> When obtaining a token using user credentials:
68-
> - To view data the user needs to have at least the following role permission: 'ViewData' or 'TvmViewData' (See [Create and manage roles](../user-roles.md) for more information)
69-
>
66+
When obtaining a token using user credentials, to view data, the user needs to have at least the following role permission: `ViewData` or `TvmViewData` (See [Create and manage roles](../user-roles.md)).
7067

7168
## HTTP request
7269

defender-endpoint/api/Get-scan-history-by-session.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ ms.date: 12/15/2022
2929
- [Microsoft Defender Vulnerability Management](/defender-vulnerability-management)
3030
- [Microsoft Defender XDR](/defender-xdr)
3131

32-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
32+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3333
3434
> Want to experience Microsoft Defender Vulnerability Management? Learn more about how you can sign up to the [Microsoft Defender Vulnerability Management public preview trial](/defender-vulnerability-management/get-defender-vulnerability-management).
3535

defender-endpoint/api/get-machine-related-alerts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ ms.date: 12/18/2020
2626
- [Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
2727
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2828

29-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3030
3131
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
3232

defender-endpoint/api/get-machineaction-object.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ ms.date: 12/18/2020
2626
- [Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
2727
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2828

29-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3030
3131
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
3232

defender-endpoint/api/get-machineactions-collection.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ ms.date: 12/18/2020
2727
- [Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
2828
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2929

30-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
30+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3131
3232
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
3333

defender-endpoint/api/get-machines-by-software.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ ms.date: 12/18/2020
2727
- [Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
2828
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2929

30-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
30+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3131
3232
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
3333

defender-endpoint/api/get-machines.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,15 @@ ms.date: 04/17/2024
2626
- [Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
2727
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2828

29-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3030
3131
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
3232

3333
[!include[Improve request performance](../../includes/improve-request-performance.md)]
3434

3535
## API description
3636

37-
Retrieves a collection of [Machines](machine.md) that have communicated with Microsoft Defender for Endpoint cloud.
37+
Retrieves a collection of [Machines](machine.md) that have communicated with Microsoft Defender for Endpoint.
3838

3939
Supports [OData V4 queries](https://www.odata.org/documentation/).
4040

@@ -47,7 +47,7 @@ See examples at [OData queries with Defender for Endpoint](exposed-apis-odata-sa
4747

4848
- You can get devices last seen according to your configured retention period.
4949
- Maximum page size is 10,000.
50-
- Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
50+
- Rate limitations for this API are 100 calls per minute and 1,500 calls per hour.
5151

5252
## Permissions
5353

@@ -58,13 +58,11 @@ Application|Machine.ReadWrite.All|'Read and write all machine information'
5858
Delegated (work or school account)|Machine.Read|'Read machine information'
5959
Delegated (work or school account)|Machine.ReadWrite|'Read and write machine information'
6060

61-
> [!NOTE]
62-
> When obtaining a token using user credentials:
63-
>
64-
> - The user needs to have at least the following role permission: 'View Data' (For more information, see [Create and manage roles](../user-roles.md))
65-
> - Response will include only devices, that the user have access to, based on device group settings (For more information, see [Create and manage device groups](../machine-groups.md))
66-
>
67-
> Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
61+
When obtaining a token using user credentials, the user needs to have at least the following role permission: `View Data` (see [Create and manage roles](../user-roles.md)).
62+
63+
Responses include only devices that the user has access to, based on device group settings (See [Create and manage device groups](../machine-groups.md)).
64+
65+
Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
6866

6967
## HTTP request
7068

@@ -84,7 +82,7 @@ Empty
8482

8583
## Response
8684

87-
If successful and machines exists - 200 OK with list of [machine](machine.md) entities in the body. If no recent machines - 404 Not Found.
85+
If successful, and the machines exist, you see `200 OK` with list of [machine](machine.md) entities in the body. If there are no recent machines, you see `404 Not Found`.
8886

8987
## Example
9088

defender-endpoint/api/get-missing-kbs-machine.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ ms.date: 12/18/2020
2828
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2929
- [Microsoft Defender Vulnerability Management](/defender-vulnerability-management)
3030

31-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
31+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3232
3333
> Want to experience Microsoft Defender Vulnerability Management? Learn more about how you can sign up to the [Microsoft Defender Vulnerability Management public preview trial](/defender-vulnerability-management/get-defender-vulnerability-management).
3434

defender-endpoint/api/get-missing-kbs-software.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ ms.date: 12/18/2020
2727
- [Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
2828
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2929

30-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
30+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3131
3232
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
3333

defender-endpoint/api/get-package-sas-uri.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ ms.date: 04/17/2024
2626
- [Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
2727
- [Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
2828

29-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
3030
3131
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
3232

0 commit comments

Comments
 (0)