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

Alkalmazandó: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

API-leírás

Gépek keresése címke szerint.

startswith A lekérdezés támogatott.

Az API sebességkorlátozásai percenként 100 hívás, óránként 1500 hívás.

Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:

A válaszok csak azokat az eszközöket tartalmazzák, 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álaszok csak azokat az eszközöket tartalmazzák, 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 API meghívásához a következő engedély szükséges. 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"

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

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

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ő.

Üres

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

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

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

Hasznos volt ez az oldal?