Aracılığıyla paylaş

Makine eylem API'lerini iptal etme

  • Makale

Şunlar için geçerlidir:

Ö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.

Uç Nokta için Microsoft Defender'ı deneyimlemek ister misiniz? Ücretsiz deneme için kaydolun.

Not

ABD Kamu müşterisiyseniz lütfen US Government müşterileri için Uç Nokta için Microsoft Defender'de listelenen URI'leri kullanın.

İpucu

Daha iyi performans için coğrafi konumunuza daha yakın olan sunucuyu kullanabilirsiniz:

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

  1. 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.securitycenter.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.securitycenter.microsoft.com/api/machineactions/988cc94e-7a8f-4b28-ab65-54970c5d5018/cancel

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

İlgili makale

İpucu

Daha fazla bilgi edinmek mi istiyorsunuz? Teknoloji Topluluğumuzdaki Microsoft Güvenlik topluluğuyla Engage: Uç Nokta için Microsoft Defender Teknoloji Topluluğu.