إضافة علامة لأجهزة متعددة أو إزالتها
ينطبق على:
هل تريد تجربة 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
وصف واجهة برمجة التطبيقات
إضافة علامة أو إزالتها لمجموعة محددة من الأجهزة.
القيود
- يمكنك النشر على الأجهزة التي شوهدت آخر مرة وفقا لفترة الاستبقاء التي تم تكوينها.
- قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 مكالمة في الساعة.
- يمكننا إضافة علامة أو إزالتها لما يصل إلى 500 جهاز لكل استدعاء API.
الأذونات
أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع استخدام واجهات برمجة تطبيقات Defender لنقطة النهاية.
| نوع الإذن | إذن | اسم عرض الإذن |
|---|---|---|
| Application | Machine.ReadWrite.All | 'قراءة جميع معلومات الجهاز وكتابتها' |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Machine.ReadWrite | "قراءة وكتابة معلومات الجهاز" |
ملاحظة
عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:
- يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: "إدارة إعداد الأمان". لمزيد من المعلومات، راجع إنشاء الأدوار وإدارتها.
- يحتاج المستخدم إلى الوصول إلى الجهاز، استنادا إلى إعدادات مجموعة الجهاز (راجع إنشاء مجموعات الأجهزة وإدارتها لمزيد من المعلومات).
طلب HTTP
POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines
عناوين الطلبات
| الاسم | نوع | الوصف |
|---|---|---|
| إذن | سلسلة | الحامل {token}. مطلوب. |
| نوع المحتوى | خيط | application/json. مطلوب. |
نص الطلب
في نص الطلب، قم بتوفير كائن JSON بالمعلمات التالية:
| البارامتر | نوع | الوصف |
|---|---|---|
| قيمة | سلسلة | اسم العلامة. مطلوب. |
| فعل | قائمة تعداد | إضافة أو إزالة. القيم المسموح بها هي: "إضافة" أو "إزالة". مطلوب. |
| معرفات الجهاز | قائمة (سلسلة) | قائمة معرفات الجهاز المراد تحديثها. مطلوب. |
استجابه
إذا نجحت، فترجع هذه الطريقة 200 - Ok رمز الاستجابة والأجهزة المحدثة في نص الاستجابة.
طلب مثال
فيما يلي مثال على طلب يضيف علامة إلى أجهزة متعددة.
POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines
{
"Value" : "Tag",
"Action": "Add",
"MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
"2a398439b4975924e87a65943972bc702469b329",
"a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}
لإزالة علامات الجهاز، قم بتعيين الإجراء إلى "إزالة" بدلا من "إضافة" في نص الطلب.
تلميح
هل تريد معرفة المزيد؟ التفاعل مع مجتمع أمان Microsoft في مجتمع التكنولوجيا لدينا: Microsoft Defender for Endpoint Tech Community.