Udostępnij za pośrednictwem

Ustawianie interfejsu API wartości urządzenia

  • Artykuł

Dotyczy:

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 Ochrona punktu końcowego w usłudze Microsoft Defender 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

Opis interfejsu API

Ustaw wartość urządzenia określonej maszyny.
Aby uzyskać więcej informacji, zobacz przypisywanie wartości urządzeń .

Ograniczenia

  1. Możesz publikować na urządzeniach ostatnio widzianych zgodnie ze skonfigurowanym okresem przechowywania.
  2. 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 interfejsów API Ochrona punktu końcowego w usłudze Microsoft Defender

Typ uprawnień Uprawnienie Nazwa wyświetlana uprawnień
Aplikacja Machine.ReadWrite.All "Odczytywanie i zapisywanie wszystkich 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: "Zarządzanie ustawieniem zabezpieczeń". Aby uzyskać więcej informacji (zobacz Twórca i zarządzanie rolami, aby uzyskać więcej informacji)
  • Użytkownik musi mieć dostęp do maszyny na podstawie ustawień grupy maszyn (zobacz Twórca i zarządzanie grupami maszyn, aby uzyskać więcej informacji)

Żądanie HTTP

POST https://api.security.microsoft.com/api/machines/{machineId}/setDeviceValue

Nagłówki żądań

Name (Nazwa) Wpisać Opis
Autoryzacji Ciąg Element nośny {token}. Wymagane.
Typ zawartości Ciąg application/json. Wymagane.

Treść żądania

W treści żądania podaj obiekt JSON z następującymi parametrami:

Parametr Wpisać Opis
DeviceValue Enum Wartość urządzenia. Dozwolone wartości to: "Normalny", "Niski" i "Wysoki". Wymagane.

Odpowiedzi

W przypadku powodzenia ta metoda zwraca kod odpowiedzi 200 — OK i zaktualizowaną maszynę w treści odpowiedzi.

Przykład

Żądanie

Oto przykład żądania, które dodaje tag maszyny.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/setDeviceValue

{
  "DeviceValue" : "High"
}

Porada

Chcesz dowiedzieć się więcej? Engage ze społecznością microsoft security w naszej społeczności technicznej: Ochrona punktu końcowego w usłudze Microsoft Defender Tech Community.