Gép címkéinek hozzáadása vagy eltávolítása
É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
Egy adott eszköz címkéjét adja hozzá vagy távolítja el.
Megjegyzés:
Ha azt szeretné, hogy az API-val tömegesen címkézze fel a gépeket, tekintse meg a több gépcímke hozzáadását vagy eltávolítását ismertető cikket.
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 és óránként 1500 hívás.
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ót a Szerepkörök létrehozása és kezelése című témakörben talál.
- 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/{id}/tags
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. |
Válasz
Ha sikerült, ez a metódus a 200 – OK válaszkódot és a frissített gépet adja vissza a válasz törzsében.
Példakérés
Íme egy példa egy olyan kérésre, amely gépcímkét ad hozzá.
POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}
A gépcímke eltávolításához állítsa a Művelet értékét "Eltávolítás" értékre a kérés törzsében található "Hozzáadás" helyett.
Tipp
Szeretne többet megtudni? Vegye fel a kapcsolatot a Microsoft Security közösségével a technikai közösségünkben: Microsoft Defender for Endpoint Tech Community.