Dela via

Avbryt API:et för datoråtgärd

  • Artikel

Gäller för:

Viktigt

Viss information i den här artikeln gäller en förhyrd produkt som kan ändras avsevärt innan den släpps kommersiellt. Microsoft lämnar inga garantier, uttryckta eller underförstådda, med avseende på den information som tillhandahålls här.

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Obs!

Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.

Tips

För bättre prestanda kan du använda servern närmare din geoplats:

  • 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-beskrivning

Avbryt en datoråtgärd som redan har startats och som ännu inte är i slutligt tillstånd (slutförd, avbruten, misslyckad).

Begränsningar

  1. Hastighetsbegränsningar för det här API:et är 100 anrop per minut och 1 500 anrop per timme.

Behörigheter

En av följande behörigheter krävs för att anropa det här API:et. Mer information, inklusive hur du väljer behörigheter, finns i Kom igång.

Behörighetstyp Behörighet Visningsnamn för behörighet
Program Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantine
Machine.LiveResponse		 Samla in kriminaltekniska data
Isolera maskin
Begränsa kodkörning
Genomsök dator
Avregistrera maskin
Stoppa och placera i karantän
Köra livesvar på en specifik dator
Delegerat (arbets- eller skolkonto) Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantineMachine.LiveResponse		 Samla in kriminaltekniska data
Isolera maskin
Begränsa kodkörning
Genomsök dator
Avregistrera maskin
Stoppa och placera i karantän
Köra livesvar på en specifik dator

HTTP-begäran

POST https://api.securitycenter.microsoft.com/api/machineactions/<machineactionid>/cancel

Frågerubriker

Namn Typ Beskrivning
Tillstånd Sträng Ägaren {token}. Obligatoriskt.
Content-Type sträng application/json. Obligatoriskt.

Frågebrödtext

Parameter Typ Beskrivning
Kommentar Sträng Kommentar som ska associeras med annulleringsåtgärden.

Svar

Om det lyckas returnerar den här metoden 200, OK-svarskod med en machine action-entitet. Om entiteten machine action med det angivna ID:t inte hittades – 404 Hittades inte.

Exempel

Begäran

Här är ett exempel på begäran.

POST
https://api.securitycenter.microsoft.com/api/machineactions/988cc94e-7a8f-4b28-ab65-54970c5d5018/cancel

{
    "Comment": "Machine action was canceled by automation"
}

Relaterad artikel

Tips

Vill du veta mer? Interagera med Microsoft Security-communityn i vår Tech Community: Microsoft Defender för Endpoint Tech Community.