مشاركة عبر

إلغاء واجهة برمجة تطبيقات إجراء الجهاز

  • مقالة

ينطبق على:

هام

تتعلق بعض المعلومات الواردة في هذه المقالة بالناتج الذي تم إصداره مسبقًا والذي قد يتم تعديله بشكل كبير قبل إصداره تجاريًا. لا تقدم Microsoft أي ضمانات، يتم التعبير عنها أو تضمينها، فيما يتعلق بالمعلومات المقدمة هنا.

هل تريد تجربة Defender لنقطة النهاية؟ التسجيل للحصول على إصدار تجريبي مجاني.

ملاحظة

إذا كنت أحد عملاء حكومة الولايات المتحدة، فالرجاء استخدام معرفات URI المدرجة في Microsoft Defender لنقطة النهاية لعملاء حكومة الولايات المتحدة.

تلميح

للحصول على أداء أفضل، يمكنك استخدام الخادم الأقرب إلى موقعك الجغرافي:

  • 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

وصف واجهة برمجة التطبيقات

قم بإلغاء إجراء جهاز تم تشغيله بالفعل ولم يكن في الحالة النهائية بعد (مكتمل، ملغى، فشل).

القيود

  1. قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.

الأذونات

أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع بدء الاستخدام.

نوع الإذن إذن اسم عرض الإذن
Application Machine.CollectForensics
الجهاز.عزل
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantine
Machine.LiveResponse		 جمع الأدلة الجنائية
جهاز عزل
تقييد تنفيذ التعليمات البرمجية
جهاز الفحص
جهاز إيقاف التجهيز
إيقاف وعزل
تشغيل الاستجابة المباشرة على جهاز معين
مفوض (حساب العمل أو المؤسسة التعليمية) Machine.CollectForensics
الجهاز.عزل
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantineMachine.LiveResponse		 جمع الأدلة الجنائية
جهاز عزل
تقييد تنفيذ التعليمات البرمجية
جهاز الفحص
جهاز إيقاف التجهيز
إيقاف وعزل
تشغيل الاستجابة المباشرة على جهاز معين

طلب HTTP

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

عناوين الطلبات

الاسم نوع الوصف
إذن سلسلة الحامل {token}. مطلوب.
نوع المحتوى خيط application/json. مطلوب.

نص الطلب

البارامتر نوع الوصف
التعليق سلسلة التعليق لإقرانه بإجراء الإلغاء.

استجابه

إذا نجحت، فترجع هذه الطريقة 200، رمز استجابة موافق مع كيان إجراء الجهاز. إذا لم يتم العثور على كيان إجراء الجهاز ذي المعرف المحدد - 404 غير موجود.

مثل

طلب

فيما يلي مثال على الطلب.

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

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

مقالة ذات صلة

تلميح

هل تريد معرفة المزيد؟ Engage مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender لنقطة النهاية Tech Community.