Alert resource type

Important

Welcome to Microsoft Defender for Endpoint, the new name for Microsoft Defender Advanced Threat Protection. Read more about this and other updates here. We'll be updating names in products and in the docs in the near future.

Applies to: Defender for Endpoint

Methods

Method Return Type Description
Get alert Alert Get a single alert object.
List alerts Alert collection List alert collection.
Update alert Alert Update specific alert.
Create alert Alert Create an alert based on event data obtained from Advanced Hunting.
List related domains Domain collection List URLs associated with the alert.
List related files File collection List the file entities that are associated with the alert.
List related IPs IP collection List IPs that are associated with the alert.
Get related machines Machine The machine that is associated with the alert.
Get related users User The user that is associated with the alert.

Properties

Property Type Description
id String Alert ID.
title String Alert title.
description String Alert description.
alertCreationTime Nullable DateTimeOffset The date and time (in UTC) the alert was created.
lastEventTime Nullable DateTimeOffset The last occurrence of the event that triggered the alert on the same device.
firstEventTime Nullable DateTimeOffset The first occurrence of the event that triggered the alert on that device.
lastUpdateTime Nullable DateTimeOffset The date and time (in UTC) the alert was last updated.
resolvedTime Nullable DateTimeOffset The date and time in which the status of the alert was changed to 'Resolved'.
incidentId Nullable Long The Incident ID of the Alert.
investigationId Nullable Long The Investigation ID related to the Alert.
investigationState Nullable Enum The current state of the Investigation. Possible values are: 'Unknown', 'Terminated', 'SuccessfullyRemediated', 'Benign', 'Failed', 'PartiallyRemediated', 'Running', 'PendingApproval', 'PendingResource', 'PartiallyInvestigated', 'TerminatedByUser', 'TerminatedBySystem', 'Queued', 'InnerFailure', 'PreexistingAlert', 'UnsupportedOs', 'UnsupportedAlertType', 'SuppressedAlert'.
assignedTo String Owner of the alert.
severity Enum Severity of the alert. Possible values are: 'UnSpecified', 'Informational', 'Low', 'Medium' and 'High'.
status Enum Specifies the current status of the alert. Possible values are: 'Unknown', 'New', 'InProgress' and 'Resolved'.
classification Nullable Enum Specification of the alert. Possible values are: 'Unknown', 'FalsePositive', 'TruePositive'.
determination Nullable Enum Specifies the determination of the alert. Possible values are: 'NotAvailable', 'Apt', 'Malware', 'SecurityPersonnel', 'SecurityTesting', 'UnwantedSoftware', 'Other'.
category String Category of the alert.
detectionSource String Detection source.
threatFamilyName String Threat family.
machineId String ID of a machine entity that is associated with the alert.
computerDnsName String machine fully qualified name.
aadTenantId String The Azure Active Directory ID.
comments List of Alert comments Alert Comment is an object that contains: comment string, createdBy string and createTime date time.

Response example for getting single alert:

GET https://api.securitycenter.windows.com/api/alerts/da637084217856368682_-292920499
{
    "id": "da637084217856368682_-292920499",
    "incidentId": 66860,
    "investigationId": 4416234,
    "investigationState": "Running",
    "assignedTo": "secop@contoso.com",
    "severity": "Low",
    "status": "New",
    "classification": "TruePositive",
    "determination": null,
    "detectionSource": "WindowsDefenderAtp",
    "category": "CommandAndControl",
    "threatFamilyName": null,
    "title": "Network connection to a risky host",
    "description": "A network connection was made to a risky host which has exhibited malicious activity.",
    "alertCreationTime": "2019-11-03T23:49:45.3823185Z",
    "firstEventTime": "2019-11-03T23:47:16.2288822Z",
    "lastEventTime": "2019-11-03T23:47:51.2966758Z",
    "lastUpdateTime": "2019-11-03T23:55:52.6Z",
    "resolvedTime": null,
    "machineId": "986e5df8b73dacd43c8917d17e523e76b13c75cd",
    "comments": [
        {
            "comment": "test comment for docs",
            "createdBy": "secop@contoso.com",
            "createdTime": "2019-11-05T14:08:37.8404534Z"
        }
    ]
}