Megosztás a következőn keresztül:


Gépműveleti API megszakítása

Érintett szolgáltatás:

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 az USA kormányzati ügyfeleinek készült Végponthoz készült Microsoft Defenderben felsorolt URI-kat.

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

  1. 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? Vegye fel a kapcsolatot a Microsoft Security közösségével a technikai közösségünkben: Microsoft Defender for Endpoint Tech Community.