Címke hozzáadása vagy eltávolítása több géphez

Cikk
08/14/2024

Érintett szolgáltatás:

Szeretné megismerni a Végponthoz készült Microsoft Defendert? Regisztráció az ingyenes próbaverzióra

Megjegyzés:

Ha Ön az USA kormányzati szerveinek ügyfele, használja az USA kormányzati ügyfeleinek készült Végponthoz készült Microsoft Defenderben felsorolt URI-kat.

Tipp

A jobb teljesítmény érdekében a földrajzi helyhez közelebbi kiszolgálót használhat:

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

API-leírás

Hozzáad vagy eltávolít egy címkét a megadott gépcsoporthoz.

Korlátozások

A gépeken a konfigurált megőrzési időszaknak megfelelően közzéteheti a bejegyzést.
Az API sebességkorlátozásai percenként 100 hívás, óránként 1500 hívás.
API-hívásonként legfeljebb 500 gép címkéjét adhatja hozzá vagy távolíthatja el.

Engedélyek

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, beleértve az engedélyek kiválasztását is: Végponthoz készült Defender API-k használata.

Engedély típusa	Engedély	Engedély megjelenítendő neve
Alkalmazás	Machine.ReadWrite.All	"Minden gépi információ olvasása és írása"
Delegált (munkahelyi vagy iskolai fiók)	Machine.ReadWrite	"Gépi információk olvasása és írása"

Megjegyzés:

Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:

A felhasználónak legalább a következő szerepköri engedéllyel kell rendelkeznie: "Biztonsági beállítás kezelése". További információ: Szerepkörök létrehozása és kezelése.
A felhasználónak hozzáféréssel kell rendelkeznie a géphez a gépcsoport beállításai alapján (további információért lásd: Gépcsoportok létrehozása és kezelése ).

HTTP-kérés

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

Kérelemfejlécek

Name (Név)	Típus	Leírás
Felhatalmazás	Karakterlánc	Tulajdonos : {token}. Kötelező megadni.
Tartalomtípus	sztring	application/json. Kötelező megadni.

Kérelem törzse

A kérelem törzsében adjon meg egy JSON-objektumot a következő paraméterekkel:

Paraméter	Típus	Leírás
Érték	Karakterlánc	A címke neve. Kötelező megadni.
Művelet	Enumerálás	Hozzáadás vagy eltávolítás. Az engedélyezett értékek a következők: "Hozzáadás" vagy "Eltávolítás". Kötelező megadni.
Gépazonosítók	Lista (sztring)	A frissíteni kívánt gépazonosítók listája. Szükséges.

Válasz

Ha sikerült, ez a metódus a 200 – Ok válaszkódot és a frissített gépeket adja vissza a válasz törzsében.

Példakérés

Íme egy példa egy olyan kérésre, amely címkét ad hozzá több géphez.

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

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

A gépcímkék eltávolításához állítsa a műveletet "Eltávolítás" értékre a kérés törzsében található "Hozzáadás" helyett.