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

Érintett szolgáltatás:

• Végponthoz készült Microsoft Defender 1. csomag
• Végponthoz készült Microsoft Defender 2. csomag
• Microsoft Defender XDR

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

Á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

1. A konfigurált megőrzési időszaknak megfelelően közzéteheti az utoljára látható eszközöket.
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: 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ókért lásd: 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.security.microsoft.com/api/machines/{machineId}/setDeviceValue

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
DeviceValue	Enumerálás	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"
}

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.