Gép címkéinek hozzáadása vagy eltávolítása

  • Cikk

É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 a Végponthoz készült Microsoft Defender-ben felsorolt URI-kat az USA kormányzati ügyfelei számára.

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

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

  1. A gépeken a konfigurált megőrzési időszaknak megfelelően közzéteheti a bejegyzést.

  2. 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ás é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ót a Létrehozás és a gépcsoportok kezelése című témakörben talál).

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
Engedélyezési Karakterlánc Tulajdonos : {token}. Kötelező megadni.
Tartalomtípus Karakterlánc 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 Enum 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? Engage a Microsoft biztonsági közösségével a technikai közösségünkben: Végponthoz készült Microsoft Defender Tech Community.