Az összes vizsgálati ügynök lekérése
Érintett szolgáltatás:
- Végponthoz készült Microsoft Defender
- Microsoft Defender biztonságirés-kezelése
- Microsoft Defender XDR
Szeretné megismerni a Végponthoz készült Microsoft Defendert? Regisztráció az ingyenes próbaverzióra
Szeretne Microsoft Defender biztonságirés-kezelés tapasztalni? Megtudhatja, hogyan regisztrálhat az ingyenes próbaverzióra.
Fontos
A cikkben található információk egy része egy előzetesen kiadott termékre vonatkozik, amely a kereskedelmi forgalomba kerülés előtt lényegesen módosulhat. A Microsoft nem vállal kifejezett vagy hallgatólagos szavatosságot az itt megadott információkra vonatkozóan.
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
Lekéri az összes vizsgálati ügynök listáját.
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 | Olvassa el az összes vizsgálati információt. |
Delegált (munkahelyi vagy iskolai fiók) | Machine.Read.All | Olvassa el az összes vizsgálati információt. |
Megjegyzés:
Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:
- Az adatok megtekintéséhez a felhasználónak legalább a következő szerepköri engedéllyel kell rendelkeznie: "ViewData" vagy "TvmViewData" (további információért lásd: Létrehozás és szerepkörök kezelése)
HTTP-kérés
GET /api/DeviceAuthenticatedScanAgents
Kérelemfejlécek
Name (Név) | Típus | Leírás |
---|---|---|
Engedélyezési | Karakterlánc | Tulajdonos : {token}. Kötelező megadni. |
Kérelem törzse
Üres
Válasz
Ha sikerült, ez a metódus 200 – OK válaszkódot ad vissza a hitelesített vizsgálati ügynökök listájával.
Példa
Példa kérésre
Íme egy példa a kérésre.
https://api-us.securitycenter.microsoft.com/api/DeviceAuthenticatedScanAgents
Példa válaszra
Íme egy példa a válaszra.
{
"@odata.context": "https://api-us.securitycenter.microsoft.com/api/$metadata#DeviceAuthenticatedScanAgents",
"value": [
{
"id": "47df41a0c-asad-4fd6d3-bbea-a93dbc0bfcaa_4edd75b2407a5b64d704b4e53d74f15",
"machineId": "4ejh675b240118fbehiuiy5b64d704b4e53d15",
"lastSeen": "2022-05-08T12:18:41.538203Z",
"computerDnsName": "TEST_DOMAIN",
"AssignedApplicationId": "9E0FA0EB-0A51-4357-9C87-C21BFBE07571",
"ScannerSoftwareVersion": "7.1.1",
"LastCommandExecutionTimestamp": "2022-05-08T12:18:41.538203Z",
"mdeClientVersion": "10.8295.22621.1195"
},
{
"id": "47d41a0c-1dfd-46d3-bbea-a93dbc0bfcaa_eb663a27ae9d032f61bc268oiu4c4b90f77",
"machineId": "eb663a27ae9d032sdf9dfd79eedf14c4b90f77",
"lastSeen": "2022-12-19T20:29:04.8242449Z",
"computerDnsName": "TEST_DOMAIN2",
"AssignedApplicationId": "9E0FA0EB-0A51-4357-9C87-C21BFBE07571",
"ScannerSoftwareVersion": "7.1.1",
"LastCommandExecutionTimestamp": "2022-12-19T20:29:04.8242449Z",
"mdeClientVersion": "10.8295.22621.1010"
},
]
}
Tipp
Szeretne többet megtudni? Engage a Microsoft biztonsági közösségével a technikai közösségünkben: Végponthoz készült Microsoft Defender Tech Community.
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: