Znajdowanie urządzeń według wewnętrznego interfejsu API IP
Dotyczy:
- Ochrona punktu końcowego w usłudze Microsoft Defender (plan 1)
- Ochrona punktu końcowego w usłudze Microsoft Defender (plan 2)
Chcesz poznać usługę ochrony punktu końcowego w usłudze Microsoft Defender? Utwórz konto, aby skorzystać z bezpłatnej wersji próbnej.
Uwaga
Jeśli jesteś klientem rządowym USA, użyj identyfikatorów URI wymienionych w usłudze Microsoft Defender for Endpoint dla klientów rządowych USA.
Porada
Aby uzyskać lepszą wydajność, możesz użyć serwera bliżej lokalizacji geograficznej:
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
Opis interfejsu API
Znajdź maszyny widoczne z żądanym wewnętrznym adresem IP w zakresie czasu wynoszącym 15 minut przed i po danej sygnaturze czasowej.
Ograniczenia
- Dana sygnatura czasowa musi być w ciągu ostatnich 30 dni.
- Ograniczenia szybkości dla tego interfejsu API to 100 wywołań na minutę i 1500 wywołań na godzinę.
Uprawnienia
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 usługi Microsoft Defender dla interfejsów API punktu końcowego
| Typ uprawnień | Uprawnienie | Nazwa wyświetlana uprawnień |
|---|---|---|
| Aplikacja | Machine.Read.All | "Odczyt wszystkich profilów maszyny" |
| Aplikacja | Machine.ReadWrite.All | "Odczytywanie i zapisywanie wszystkich informacji o maszynie" |
| Delegowane (konto służbowe) | Machine.Read | "Odczytywanie informacji o maszynie" |
| Delegowane (konto służbowe) | Machine.ReadWrite | "Odczytywanie i zapisywanie informacji o maszynie" |
Uwaga
Podczas uzyskiwania tokenu przy użyciu poświadczeń użytkownika:
- Odpowiedź będzie obejmować tylko urządzenia, 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)
- Użytkownik musi mieć co najmniej następujące uprawnienia roli: "Wyświetl dane" (Aby uzyskać więcej informacji, zobacz Tworzenie ról i zarządzanie nimi)
- Odpowiedź będzie obejmować tylko urządzenia, 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)
Tworzenie grupy urządzeń jest obsługiwane w usłudze Defender for Endpoint Plan 1 i Plan 2.
Żądanie HTTP
GET /api/machines/findbyip(ip='{IP}',timestamp={TimeStamp})
Nagłówki żądań
| Name (Nazwa) | Wpisać | Opis |
|---|---|---|
| Autoryzacja | Ciąg | Element nośny {token}. Wymagane. |
Treść żądania
Pusty
Odpowiedź
Jeśli się powiedzie — 200 OK z listą maszyn w treści odpowiedzi. Jeśli sygnatura czasowa nie jest w ciągu ostatnich 30 dni — 400 Nieprawidłowe żądanie.
Przykład
Prosić
Oto przykład żądania.
GET https://api.securitycenter.microsoft.com/api/machines/findbyip(ip='10.248.240.38',timestamp=2019-09-22T08:44:05Z)
Porada
Chcesz dowiedzieć się więcej? Skontaktuj się ze społecznością zabezpieczeń firmy Microsoft w naszej społeczności technicznej: Microsoft Defender for Endpoint Tech Community.