مشاركة عبر

إضافة علامة لجهاز أو إزالتها

  • مقالة

ينطبق على:

هل تريد تجربة 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

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

إضافة علامة لجهاز معين أو إزالتها.

ملاحظة

إذا كنت تبحث عن كيفية وضع علامة مجمعة على الأجهزة عبر واجهة برمجة التطبيقات، فراجع إضافة علامات أجهزة متعددة أو إزالتها.

القيود

  1. يمكنك النشر على الأجهزة التي شوهدت آخر مرة وفقا لفترة الاستبقاء التي تم تكوينها.

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

الأذونات

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

نوع الإذن اذن اسم عرض الإذن
Application Machine.ReadWrite.All 'قراءة جميع معلومات الجهاز وكتابتها'
مفوض (حساب العمل أو المؤسسة التعليمية) Machine.ReadWrite "قراءة وكتابة معلومات الجهاز"

ملاحظة

عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:

طلب HTTP

POST https://api.securitycenter.microsoft.com/api/machines/{id}/tags

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

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

نص الطلب

في نص الطلب، قم بتوفير كائن JSON بالمعلمات التالية:

المعلمه نوع الوصف
قيمه سلسلة اسم العلامة. مطلوب.
العمل التعداد إضافة أو إزالة. القيم المسموح بها هي: "إضافة" أو "إزالة". مطلوب.

استجابه

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

طلب مثال

فيما يلي مثال على طلب يضيف علامة جهاز.

POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags

{
  "Value" : "test Tag 2",
  "Action": "Add"
}

لإزالة علامة الجهاز، قم بتعيين الإجراء إلى "إزالة" بدلا من "إضافة" في نص الطلب.

تلميح

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