API Annuler l’action de l’ordinateur

  • Article

S’applique à :

Importante

Certaines informations contenues dans cet article concernent le produit en préversion, qui peut être considérablement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, explicite ou implicite, concernant les informations fournies ici.

Vous voulez découvrir Microsoft Defender pour point de terminaison ? Inscrivez-vous pour bénéficier d’un essai gratuit.

Remarque

Si vous êtes un client du gouvernement des États-Unis, utilisez les URI répertoriés dans Microsoft Defender pour point de terminaison pour les clients du gouvernement des États-Unis.

Conseil

Pour de meilleures performances, vous pouvez utiliser le serveur plus près de votre emplacement géographique :

  • 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

Description de l’API

Annuler une action de machine déjà lancée qui n’est pas encore dans l’état final (terminée, annulée, échec).

Limitations

  1. Les limitations de débit pour cette API sont de 100 appels par minute et de 1 500 appels par heure.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour en savoir plus, notamment sur le choix des autorisations, consultez Prise en main.

Type d’autorisation Autorisation Nom complet de l’autorisation
Application Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantine
Machine.LiveResponse		 Collecter des informations d’investigation
Isoler l’ordinateur
Restreindre l'exécution de code
Analyser l’ordinateur
Annuler l’intégration de l’ordinateur
Arrêter et mettre en quarantaine
Exécuter la réponse en direct sur un ordinateur spécifique
Déléguée (compte professionnel ou scolaire) Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantineMachine.LiveResponse		 Collecter des informations d’investigation
Isoler l’ordinateur
Restreindre l'exécution de code
Analyser l’ordinateur
Annuler l’intégration de l’ordinateur
Arrêter et mettre en quarantaine
Exécuter la réponse en direct sur un ordinateur spécifique

Requête HTTP

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

En-têtes de demande

Nom Type Description
Autorisation Chaîne Porteur {token}. Obligatoire.
Content-Type string application/json. Obligatoire.

Corps de la demande

Paramètre Type Description
Commentaire Chaîne Commentaire à associer à l’action d’annulation.

Réponse

Si elle réussit, cette méthode retourne le code de réponse 200, OK avec une entité Machine Action. Si l’entité d’action machine avec l’ID spécifié est introuvable, 404 Est introuvable.

Exemple

Demande

Voici un exemple de demande.

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

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

Article connexe

Conseil

Voulez-vous en savoir plus ? Engage avec la communauté Microsoft Security dans notre communauté technique : Microsoft Defender pour point de terminaison Tech Community.