mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-23 14:23:38 +00:00
2
This commit is contained in:
@ -16,13 +16,23 @@ ms.collection: M365-security-compliance
|
||||
ms.topic: article
|
||||
---
|
||||
|
||||
# Create alert from event API
|
||||
# Create alert API
|
||||
|
||||
**Applies to:** [Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)](https://go.microsoft.com/fwlink/p/?linkid=2069559)
|
||||
|
||||
- Want to experience Microsoft Defender ATP? [Sign up for a free trial.](https://www.microsoft.com/microsoft-365/windows/microsoft-defender-atp?ocid=docs-wdatp-exposedapis-abovefoldlink)
|
||||
|
||||
Create alert using event data, as obtained from [Advanced Hunting](run-advanced-query-api.md) for creating a new alert.
|
||||
## API description
|
||||
Creates new MDATP [Alert](alerts.md).
|
||||
<br>MDATP Event is a required parameter for the alert creation.
|
||||
<br>You can use an event found in Advanced Hunting API or Portal.
|
||||
<br>If there is an open alert on the same Machine with the same Title, the alerts will be merged to one.
|
||||
<br>An automatic investigation starts automatically on alerts created via the API.
|
||||
|
||||
|
||||
## Limitations
|
||||
1. Rate limitations of this API are 15 calls per minute.
|
||||
|
||||
|
||||
## Permissions
|
||||
|
||||
|
@ -23,7 +23,6 @@ ms.topic: article
|
||||
- Want to experience Microsoft Defender ATP? [Sign up for a free trial.](https://www.microsoft.com/microsoft-365/windows/microsoft-defender-atp?ocid=docs-wdatp-exposedapis-abovefoldlink)
|
||||
|
||||
## API description
|
||||
|
||||
Retrieves a collection of Alerts.
|
||||
<br>Supports [OData V4 queries](https://www.odata.org/documentation/).
|
||||
<br>The OData's ```$filter``` query is supported on: "alertCreationTime", "incidentId", "InvestigationId", "status", "severity" and "category".
|
||||
@ -32,8 +31,8 @@ Retrieves a collection of Alerts.
|
||||
|
||||
## Limitations
|
||||
1. You can get alerts last updated in the past 30 days.
|
||||
2. The maximum page size is 10,000.
|
||||
3. The rate limitations of this API is 100 calls per minute and 1500 calls per hour.
|
||||
2. Maximum page size is 10,000.
|
||||
3. Rate limitations of this API are 100 calls per minute and 1500 calls per hour.
|
||||
|
||||
|
||||
## Permissions
|
||||
|
Reference in New Issue
Block a user