Dodawanie lub usuwanie tagu dla wielu maszyn

Artykuł
05/03/2024

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

Dodaje lub usuwa tag dla określonego zestawu maszyn.

Ograniczenia

Możesz publikować wpisy na maszynach ostatnio wyświetlanych zgodnie ze skonfigurowanym okresem przechowywania.
Ograniczenia szybkości dla tego interfejsu API to 100 wywołań na minutę i 1500 wywołań na godzinę.
Możemy dodać lub usunąć tag dla maksymalnie 500 maszyn na wywołanie interfejsu API.

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 Używanie usługi Defender dla interfejsów API punktu końcowego.

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.
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.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

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
Value	Ciąg	Nazwa tagu. Wymagane.
Akcja	Enum	Dodaj lub usuń. Dozwolone wartości to: "Dodaj" lub "Usuń". Wymagane.
Identyfikatory MachineId	Lista (ciąg)	Lista identyfikatorów maszyn do zaktualizowania. Wymagane.

Odpowiedzi

W przypadku powodzenia ta metoda zwraca kod odpowiedzi 200 — OK i zaktualizowane maszyny w treści odpowiedzi.

Przykładowe żądanie

Oto przykład żądania, które dodaje tag do wielu maszyn.

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

{
  "Value" : "Tag",
  "Action": "Add",
  "MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
  "2a398439b4975924e87a65943972bc702469b329",
  "a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}

Aby usunąć tagi maszyny, ustaw opcję Akcja na "Usuń" zamiast "Dodaj" w treści żądania.