Получение инцидента

Пространство имен: microsoft.graph.security

Получение свойств и связей объекта инцидента .

Атаки обычно наносятся на различные типы сущностей, таких как устройства, пользователи и почтовые ящики, в результате чего возникает несколько объектов оповещений . Microsoft 365 Defender сопоставляет оповещения с теми же методами атаки или тем же злоумышленником с инцидентом.

Этот API доступен в следующих национальных облачных развертываниях.

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

HTTP-запрос

GET /security/incidents/{incidentId}

Заголовки запросов

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект инцидента в теле отклика.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/security/incidents/29

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.Incidents["{incident-id}"].GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
incidents, err := graphClient.Security().Incidents().ByIncidentId("incident-id").Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.models.security.Incident result = graphClient.security().incidents().byIncidentId("{incident-id}").get();

const options = {
	authProvider,
};

const client = Client.init(options);

let incident = await client.api('/security/incidents/29')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->security()->incidents()->byIncidentId('incident-id')->get()->wait();

Import-Module Microsoft.Graph.Security

Get-MgSecurityIncident -IncidentId $incidentId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.security.incidents.by_incident_id('incident-id').get()

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#security/incidents/$entity",
    "id": "29",
    "tenantId": "cfcdbe43-297b-4c6b-ac7e-8d7f6befb514",
    "status": "active",
    "incidentWebUrl": "https://security.microsoft.com/incident2/29/overview?tid=cfcdbe43-297b-4c6b-ac7e-8d7f6befb514",
    "redirectIncidentId": null,
    "displayName": "Multi-stage incident involving Execution & Command and control on one endpoint",
    "createdDateTime": "2026-01-22T12:09:23.1433333Z",
    "lastUpdateDateTime": "2026-02-25T16:29:33.1Z",
    "assignedTo": "admin@contoso.com",
    "classification": "truePositive",
    "determination": "multiStagedAttack",
    "severity": "high",
    "customTags": [
        "Demo"
    ],
    "systemTags": [],
    "description": "Microsoft observed Raspberry Robin worm activity spreading through infected USB devices on multiple endpoints in your environment.",
    "lastModifiedBy": "API-App:admin@contoso.com",
    "resolvingComment": null,
    "summary": "Defender Experts has identified malicious activity. This incident has been raised for your awareness and should be investigated as usual.",
    "priorityScore": 100,
    "comments": []
}