Eszközérték API beállítása

Cikk
05/03/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 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

Állítsa be egy adott gép eszközértékét.
További információ: Eszközértékek hozzárendelése .

Korlátozások

A konfigurált megőrzési időszaknak megfelelően közzéteheti az utoljára látható eszközöket.
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ó, többek között az engedélyek kiválasztása: Végponthoz készült Microsoft 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ókért (további információért lásd: szerepkörök Létrehozás é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: Létrehozás és a gépcsoportok kezelése).

HTTP-kérés

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

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
DeviceValue	Enum	Eszközérték. Az engedélyezett értékek a következők: "Normál", "Alacsony" és "Magas". 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élda

Kérés

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

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

{
  "DeviceValue" : "High"
}