Gép frissítése

Cikk
03/01/2025

É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
ina.api.security.microsoft.com

API-leírás

Frissítések meglévő gép tulajdonságai.

Frissíthető tulajdonságok: machineTags és deviceValue.

Korlátozások

Frissítheti az API-ban elérhető gépeket.
A frissítési gép csak címkéket fűz a címkegyűjteményhez. Ha léteznek címkék, a törzsben szerepelniük kell a címkegyűjteményben.
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	"Gépi információk olvasása és írása az összes géphez"
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: "Riasztások vizsgálata". További információ: Szerepkörök létrehozása és kezelése.
A felhasználónak hozzáféréssel kell rendelkeznie a riasztáshoz társított eszközhöz az eszközcsoport beállításai alapján. További információ: Eszközcsoportok létrehozása és kezelése.

Az eszközcsoport létrehozása a Végponthoz készült Defender 1. és 2. csomagjában támogatott.

HTTP-kérés

PATCH /api/machines/{machineId}

Kérelemfejlécek

Name (Név)	Típus	Leírás
Felhatalmazás	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 adja meg a frissíteni kívánt mezők értékeit.

A kérés törzsében nem szereplő meglévő tulajdonságok megőrzik a korábbi értékeiket, vagy újraszámítják őket más tulajdonságértékek változásai alapján.

A legjobb teljesítmény érdekében ne adjon meg olyan meglévő értékeket, amelyek nem változtak.

Tulajdonság	Típus	Leírás
machineTags	Sztringgyűjtemény	Gépcímkék készlete.
deviceValue	Nullázható enumerálás	Az eszköz értéke. A lehetséges értékek a következők: "Normál", "Alacsony" és "Magas".

Válasz

Ha sikeres, ez a metódus 200 OK értéket ad vissza, a válasz törzsében pedig a gépentitást a frissített tulajdonságokkal.

Ha a törzsben lévő gépcímkék gyűjteménye nem tartalmaz meglévő gépcímkéket, az összes címkét lecseréli a kérelem törzsében megadott címkékre.

Ha a megadott azonosítóval rendelkező gép nem található – 404 Nem található.

Példa

Kérés

Íme egy példa a kérésre.

PATCH https://api.securitycenter.microsoft.com/api/machines/{machineId}

{
    "deviceValue": "Normal",
    "machineTags": [
                     "Demo Device",
                     "Generic User Machine - Attack Source",
                     "Windows 10" "Windows11",
                     "Windows Insider - Fast"
    ]
}