Eszközök keresése címke API szerint

Cikk
02/20/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

Gépek keresése címke szerint.

startswith A lekérdezés támogatott.

Korlátozások

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.Read.All	"Az összes gépprofil olvasása"
Alkalmazás	Machine.ReadWrite.All	"Minden gépi információ olvasása és írása"
Delegált (munkahelyi vagy iskolai fiók)	Machine.Read	"Gépi információk olvasá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 válasz csak azokat az eszközöket tartalmazza, amelyekhez a felhasználó hozzáféréssel rendelkezik az eszközcsoport beállításai alapján (további információ: Eszközcsoportok létrehozása és kezelése)
A felhasználónak legalább a következő szerepköri engedéllyel kell rendelkeznie: "Adatok megtekintése" (további információ: Szerepkörök létrehozása és kezelése)
A válasz csak azokat az eszközöket tartalmazza, amelyekhez a felhasználó hozzáféréssel rendelkezik 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

GET /api/machines/findbytag?tag={tag}&useStartsWithFilter={true/false}

Kérelemfejlécek

Name (Név)	Típus	Leírás
Felhatalmazás	Karakterlánc	Tulajdonos : {token}. Kötelező megadni.

URI-paraméterek kérése

Name (Név)	Típus	Leírás
címke	Karakterlánc	A címke neve. Kötelező megadni.
useStartsWithFilter	Logikai	Ha true (igaz) értékre van állítva, a keresés megkeresi az összes olyan eszközt, amelynek címkeneve a lekérdezésben szereplő adott címkével kezdődik. Az alapértelmezett érték a false (hamis). Nem kötelező.

Kérelem törzse

Üres

Válasz

Ha sikerült – 200 OK a válasz törzsében lévő gépek listájával.

Példa

Kérés

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

GET https://api.securitycenter.microsoft.com/api/machines/findbytag?tag=testTag&useStartsWithFilter=true