Makine eylem API'lerini iptal etme

  • Şunlara uygulanır: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Önemli

Bu makaledeki bazı bilgiler önceden yayımlanmış bir ürünle ilgilidir ve ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilmiş olabilir. Microsoft, burada sağlanan bilgilerle ilgili olarak açık veya zımni hiçbir garanti vermez.

API açıklaması

Henüz son durumunda olmayan (tamamlandı, iptal edildi, başarısız) zaten başlatılan bir makine eylemini iptal edin.

Sınırlamalar

Bu API için hız sınırlamaları dakikada 100 çağrı ve saatte 1500 çağrıdır.

İzinler

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir. İzinlerin nasıl seçileceği de dahil olmak üzere daha fazla bilgi edinmek için bkz. Kullanmaya başlama.

İzin türü İzin İzin görünen adı
Uygulama Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantine
Machine.LiveResponse		 Adli tıp toplama
Makineyi izole et
Kod yürütmeyi kısıtlama
Tarama makinesi
Offboard makine
Durdur ve karantinaya al
Belirli bir makinede canlı yanıt çalıştırma
Temsilci (iş veya okul hesabı) Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantineMachine.LiveResponse		 Adli tıp toplama
Makineyi izole et
Kod yürütmeyi kısıtlama
Tarama makinesi
Offboard makine
Durdur ve karantinaya al
Belirli bir makinede canlı yanıt çalıştırma

HTTP isteği

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

İstek üst bilgileri

Name Tür Açıklama
Yetkilendirme Dize Taşıyıcı {token}. Gerekli.
İçerik Türü dize application/json. Gerekli.

İstek gövdesi

Parametre Tür Açıklama
Açıklama ekleme Dize İptal eylemiyle ilişkilendirilecek açıklama.

Yanıt

Başarılı olursa, bu yöntem Makine Eylemi varlığıyla 200 tamam yanıt kodu döndürür. Belirtilen kimlikle makine eylemi varlığı bulunamadıysa - 404 Bulunamadı.

Örnek

Istek

burada isteğin bir örneği verilmiş.

POST
https://api.security.microsoft.com/api/machineactions/aaaabbbb-0000-cccc-1111-dddd2222eeee/cancel

{
    "Comment": "Machine action was canceled by automation"
}
  • Last updated on