إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
وصف واجهة برمجة التطبيقات
إضافة علامة لجهاز معين أو إزالتها.
القيود
يمكنك النشر على الأجهزة التي شوهدت آخر مرة وفقا لفترة الاستبقاء التي تم تكوينها.
قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.
الأذونات
عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:
- يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: "إدارة إعداد الأمان". لمزيد من المعلومات، راجع: إنشاء الأدوار وإدارتها.
- يحتاج المستخدم إلى الوصول إلى الجهاز، استنادا إلى إعدادات مجموعة الجهاز. لمزيد من المعلومات، راجع: إنشاء مجموعات الأجهزة وإدارتها.
أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع استخدام واجهات برمجة تطبيقات Defender لنقطة النهاية.
| نوع الإذن | اذن | اسم عرض الإذن |
|---|---|---|
| Application | Machine.ReadWrite.All | 'قراءة جميع معلومات الجهاز وكتابتها' |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Machine.ReadWrite | "قراءة وكتابة معلومات الجهاز" |
طلب HTTP
POST https://api.security.microsoft.com/api/machines/{id}/tags
عناوين الطلبات
| الاسم | نوع | الوصف |
|---|---|---|
| التخويل | سلسلة | الحامل {token}. مطلوب. |
| نوع المحتوى | سلسله | application/json. مطلوب. |
نص الطلب
لإزالة علامة الجهاز، قم بتعيين الإجراء إلى "إزالة" بدلا من "إضافة" في نص الطلب.
في نص الطلب، قم بتوفير كائن JSON بالمعلمات التالية:
| المعلمه | نوع | الوصف |
|---|---|---|
| قيمه | سلسلة | اسم العلامة. مطلوب. |
| العمل | التعداد | إضافة أو إزالة. القيم المسموح بها هي: "إضافة" أو "إزالة". مطلوب. |
استجابه
إذا نجحت، فترجع هذه الطريقة 200 - رمز استجابة موافق والجهاز المحدث في نص الاستجابة.
طلب مثال
فيما يلي مثال على طلب يضيف علامة جهاز.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}