Api voor machineactie annuleren

  • Artikel

Van toepassing op:

Belangrijk

Sommige informatie in dit artikel heeft betrekking op een vooraf uitgebracht product dat aanzienlijk kan worden gewijzigd voordat het commercieel wordt uitgebracht. Microsoft geeft geen garanties, expliciet of impliciet, met betrekking tot de informatie die hier wordt verstrekt.

Wilt u Microsoft Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.

Opmerking

Als u een klant van de Amerikaanse overheid bent, gebruikt u de URI's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.

Tip

Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken:

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

Annuleer een al gestarte computeractie die nog niet in de definitieve status is (voltooid, geannuleerd, mislukt).

Beperkingen

  1. Frequentiebeperkingen voor deze API zijn 100 aanroepen per minuut en 1500 aanroepen per uur.

Machtigingen

Een van de volgende machtigingen is vereist om deze API aan te roepen. Zie Aan de slag voor meer informatie, waaronder het kiezen van machtigingen.

Machtigingstype Machtiging Weergavenaam van machtiging
Toepassing Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantine
Machine.LiveResponse		 Forensische gegevens verzamelen
Computer isoleren
Uitvoering van code beperken
Scanmachine
Computer offboarden
Stoppen en in quarantaine plaatsen
Live-antwoord uitvoeren op een specifieke computer
Gedelegeerd (werk- of schoolaccount) Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantineMachine.LiveResponse		 Forensische gegevens verzamelen
Computer isoleren
Uitvoering van code beperken
Scanmachine
Computer offboarden
Stoppen en in quarantaine plaatsen
Live-antwoord uitvoeren op een specifieke computer

HTTP-aanvraag

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

Aanvraagheaders

Naam Type Beschrijving
Vergunning Tekenreeks Bearer {token}. Vereist.
Content-Type reeks application/json. Vereist.

Aanvraagtekst

Parameter Type Beschrijving
Opmerking Tekenreeks Opmerking om te koppelen aan de annuleringsactie.

Antwoord

Als dit lukt, retourneert deze methode 200, OK-antwoordcode met een machineactie-entiteit. Als de entiteit machineactie met de opgegeven id niet is gevonden: 404 Niet gevonden.

Voorbeeld

Verzoek

Hier volgt een voorbeeld van de aanvraag.

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

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

Gerelateerd artikel

Tip

Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender voor Eindpunt Tech Community.