Kullanıcıyla ilgili uyarılar API'lerini alma

API açıklaması

Belirli bir kullanıcı kimliğiyle ilgili bir uyarı koleksiyonunu alır.

Sınırlamalar

Bu API için hız sınırlamaları dakikada 100 çağrı ve saatte 1.500 çağrıdır.

İzinler

Kullanıcı kimlik bilgilerini kullanarak belirteç alırken:

• Kullanıcının en az şu rol iznine sahip olması gerekir: 'Verileri Görüntüle.' Daha fazla bilgi için bkz. Rolleri oluşturma ve yönetme.
• Yanıt yalnızca cihaz grubu ayarlarına göre kullanıcının erişimi olan cihazlarla ilişkili uyarıları içerir. Daha fazla bilgi için bkz. Cihaz gruplarını oluşturma ve yönetme.

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir. İzinlerin nasıl seçileceği de dahil olmak üzere daha fazla bilgi edinmek için bkz. Uç Nokta için Microsoft Defender API'leri kullanma

İzin türü	İzin	İzin görünen adı
Uygulama	Alert.Read.All	'Tüm uyarıları oku'
Uygulama	Alert.ReadWrite.All	'Tüm uyarıları okuma ve yazma'
Temsilci (iş veya okul hesabı)	Alert.Read	'Uyarıları okuma'
Temsilci (iş veya okul hesabı)	Alert.ReadWrite	'Uyarıları okuma ve yazma'

HTTP isteği

GET /api/users/{id}/alerts

Kimlik tam UPN değil, yalnızca kullanıcı adıdır. (örneğin, /api/users/user1/alerts kullanımına yönelik uyarıları almak için user1@contoso.com )

İstek üst bilgileri

Name	Tür	Açıklama
Yetkilendirme	Dize	Taşıyıcı {token}. Gerekli.

İstek gövdesi

Boş

Yanıt

Başarılı ve kullanıcı varsa - 200 Tamam. Kullanıcı yoksa - Boş bir kümeyle 200 Tamam.

Örnek

Istek

burada isteğin bir örneği verilmiş.

GET https://api.security.microsoft.com/api/users/user1/alerts