Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Opis interfejsu API
Pobiera kolekcję alertów związanych z danym identyfikatorem użytkownika.
Ograniczenia
Ograniczenia szybkości dla tego interfejsu API to 100 wywołań na minutę i 1500 wywołań na godzinę.
Uprawnienia
Podczas uzyskiwania tokenu przy użyciu poświadczeń użytkownika:
- Użytkownik musi mieć co najmniej następujące uprawnienie roli: "Wyświetl dane". Aby uzyskać więcej informacji, zobacz: Tworzenie ról i zarządzanie nimi.
- Odpowiedź obejmuje tylko alerty skojarzone z urządzeniami, do których użytkownik ma dostęp na podstawie ustawień grupy urządzeń. Aby uzyskać więcej informacji, zobacz: Tworzenie grup urządzeń i zarządzanie nimi.
Do wywołania tego interfejsu API jest wymagane jedno z następujących uprawnień. Aby dowiedzieć się więcej, w tym jak wybrać uprawnienia, zobacz Korzystanie z interfejsów API Ochrona punktu końcowego w usłudze Microsoft Defender
| Typ uprawnień | Uprawnienie | Nazwa wyświetlana uprawnień |
|---|---|---|
| Aplikacja | Alert.Read.All | "Odczyt wszystkich alertów" |
| Aplikacja | Alert.ReadWrite.All | "Odczytywanie i zapisywanie wszystkich alertów" |
| Delegowane (konto służbowe) | Alert.Read | "Odczyt alertów" |
| Delegowane (konto służbowe) | Alert.ReadWrite | "Odczyt i zapis alertów" |
Żądanie HTTP
GET /api/users/{id}/alerts
Identyfikator nie jest pełną nazwą UPN, ale tylko nazwą użytkownika. (na przykład w celu pobrania alertów do user1@contoso.com użycia /api/users/user1/alerts)
Nagłówki żądań
| Name (Nazwa) | Wpisać | Opis |
|---|---|---|
| Autoryzacja | Ciąg | Element nośny {token}. Wymagane. |
Treść żądania
Pusty
Odpowiedź
Jeśli się powiedzie i użytkownik istnieje — 200 OK. Jeśli użytkownik nie istnieje — 200 OK z pustym zestawem.
Przykład
Prosić
Oto przykład żądania.
GET https://api.securitycenter.microsoft.com/api/users/user1/alerts