Uzyskiwanie interfejsu API maszyn związanych z plikami

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

Pobiera kolekcję maszyn związanych z danym skrótem pliku.

Ograniczenia

1. Ograniczenia szybkości dla tego interfejsu API to 100 wywołań na minutę i 1500 wywołań na godzinę.
2. Obsługiwana jest tylko funkcja skrótu SHA-1 (nie MD5 lub SHA-256).

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:

• 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/files/{id}/machines

Nagłówki żądań

Name (Nazwa)	Wpisać	Opis
Autoryzacja	Ciąg	Element nośny {token}. Wymagane.

Treść żądania

Pusty

Odpowiedź

Jeśli plik się powiedzie i istnieje — 200 OK z listą jednostek maszyny w treści. Jeśli plik nie istnieje — 200 OK z pustym zestawem.

Przykład

Prosić

Oto przykład żądania.

GET https://api.securitycenter.microsoft.com/api/files/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/machines

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.