Перечисление оповещений

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

Получение списка объектов alert.

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

Разрешения

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

HTTP-запрос

GET /security/alerts
GET /security/alerts?$top=1
GET /security/alerts?$filter={property} eq '{property-value}'
GET /security/alerts?$filter={property} eq '{property-value}'&$top=5
GET /security/alerts?$filter={property} eq '{property-value}' and {property} eq '{property-value}'

Необязательные параметры запросов

Этот метод поддерживает указанные ниже параметры запросов OData для настройки отклика.

• $count
• $orderby
• $select
• $skip
• $top – Возвращает объединенные лучшие результаты от каждого поставщика API безопасности.
• $filter

В таблице ниже перечислены ключевые слова $filter по именам поставщиков. Несмотря на то, что некоторые из этих продуктов поменяли название в ходе ребрендинга, API еще не обновлен. Ключевые слова фильтра будут продолжать использовать устаревшие названия до дальнейшего уведомления. Подробности см. в журнале изменений.

Примечание: Некоторые поставщики могут не поддерживать $filter ключевые слова.

Чтобы вернуть альтернативный набор свойств, используйте параметр запроса OData $select , чтобы указать набор свойств оповещений , которые требуется. Например, чтобы вернуть свойства assignedTo, category и severity , добавьте в запрос следующее: $select=assignedTo,category,severity.

Примечание. Параметр запроса OData $top имеет ограничение в 1000 оповещений. В первый запрос GET рекомендуется включить только параметр $top, но не параметр $skip. Для разбивки на страницы можно использовать параметр @odata.nextLink. Если требуется применить параметр $skip, он имеет ограничение в 500 оповещений. Например, /security/alerts?$top=10&$skip=500 вернет код отклика 200 OK, но /security/alerts?$top=10&$skip=501 вернет код отклика 400 Bad Request. Дополнительные сведения см. в статье Ответы с ошибками Microsoft Graph Security API.

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

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

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

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и коллекцию объектов alert в тексте отклика. Если от поставщика возвращается код состояния, отличный от 2xx или 404, или истекло время ожидания поставщика, откликом будет код состояния 206 Partial Content с ответом поставщика в заголовке предупреждения. Дополнительные сведения см. в статье Ответы с ошибками Microsoft Graph Security API.

Пример

Запрос

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

GET https://graph.microsoft.com/v1.0/security/alerts

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

// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.Alerts.GetAsync();

mgc security alerts list

// 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://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
alerts, err := graphClient.Security().Alerts().Get(context.Background(), nil)

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

AlertCollectionResponse result = graphClient.security().alerts().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let alerts = await client.api('/security/alerts')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


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


$result = $graphServiceClient->security()->alerts()->get()->wait();

Import-Module Microsoft.Graph.Security

Get-MgSecurityAlert

# 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://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.security.alerts.get()

Отклик

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

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

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

{
  "value": [
    {
      "activityGroupName": "activityGroupName-value",
      "assignedTo": "assignedTo-value",
      "azureSubscriptionId": "azureSubscriptionId-value",
      "azureTenantId": "azureTenantId-value",
      "category": "category-value",
      "closedDateTime": "datetime-value"
    }
  ]
}