Gépműveleti API megszakítása
Érintett szolgáltatás:
- Végponthoz készült Microsoft Defender
- Végponthoz készült Microsoft Defender 1. csomag
- Végponthoz készült Microsoft Defender 2. csomag
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.
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
Egy még nem végleges állapotban lévő, már elindított gépi művelet megszakítása (befejezve, megszakítva, sikertelen).
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ókért, beleértve az engedélyek kiválasztását is, olvassa el az Első lépések című témakört.
Engedély típusa | Engedély | Engedély megjelenítendő neve |
---|---|---|
Alkalmazás | Machine.CollectForensics Machine.Isolate Machine.RestrictExecution Machine.Scan Machine.Offboard Machine.StopAndQuarantine Machine.LiveResponse |
Kriminalisztikai adatok gyűjtése Gép elkülönítése Kódvégrehajtás korlátozása Pásztázó gép Gép kivezetése Leállítás és karantén Élő válasz futtatása egy adott gépen |
Delegált (munkahelyi vagy iskolai fiók) | Machine.CollectForensics Machine.Isolate Machine.RestrictExecution Machine.Scan Machine.Offboard Machine.StopAndQuarantineMachine.LiveResponse |
Kriminalisztikai adatok gyűjtése Gép elkülönítése Kódvégrehajtás korlátozása Pásztázó gép Gép kivezetése Leállítás és karantén Élő válasz futtatása egy adott gépen |
HTTP-kérés
POST https://api.securitycenter.microsoft.com/api/machineactions/<machineactionid>/cancel
Kérelemfejlécek
Name (Név) | Típus | Leírás |
---|---|---|
Felhatalmazás | Karakterlánc | Tulajdonos : {token}. Szükséges. |
Tartalomtípus | sztring | application/json. Szükséges. |
Kérelem törzse
Paraméter | Típus | Leírás |
---|---|---|
Megjegyzés | Karakterlánc | Megjegyzés a lemondási művelethez való társításához. |
Válasz
Ha sikerült, ez a metódus 200, OK válaszkódot ad vissza egy Machine Action entitással. Ha a megadott azonosítóval rendelkező gépműveleti entitás nem található – 404 Nem található.
Példa
Kérés
Íme egy példa a kérésre.
POST
https://api.securitycenter.microsoft.com/api/machineactions/988cc94e-7a8f-4b28-ab65-54970c5d5018/cancel
{
"Comment": "Machine action was canceled by automation"
}
Kapcsolódó cikk
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.