مشاركة عبر

تحديث الجهاز

  • مقالة

ينطبق على:

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

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

التحديثات خصائص الجهاز الحالي.

الخصائص القابلة للتحديث هي: machineTags و deviceValue.

القيود

  1. يمكنك تحديث الأجهزة المتوفرة في واجهة برمجة التطبيقات.
  2. يقوم تحديث الجهاز فقط بإلحاق العلامات بمجموعة العلامات. إذا كانت العلامات موجودة، فيجب تضمينها في مجموعة العلامات في النص الأساسي.
  3. قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.

الأذونات

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

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

ملاحظة

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

يتم دعم إنشاء مجموعة الأجهزة في خطة Defender لنقطة النهاية 1 والخطة 2.

طلب HTTP

PATCH /api/machines/{machineId}

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

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

نص الطلب

في نص الطلب، قم بتوفير قيم الحقول ذات الصلة التي يجب تحديثها.

ستحافظ الخصائص الموجودة غير المضمنة في نص الطلب على قيمها السابقة أو ستتم إعادة حسابها استنادا إلى التغييرات التي تم إجراؤها على قيم الخصائص الأخرى.

للحصول على أفضل أداء، يجب عدم تضمين القيم الموجودة التي لم تتغير.

الخاصيه نوع الوصف
علامات الجهاز مجموعة سلاسل مجموعة من علامات الجهاز .
قيمة الجهاز قائمة تعداد قابلة للقيمة الخالية قيمة الجهاز. القيم المحتملة هي: "عادي" و"منخفض" و"مرتفع".

استجابه

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

إذا كانت مجموعة علامات الجهاز في النص الأساسي لا تحتوي على علامات الجهاز الموجودة - يستبدل جميع العلامات بالعلامات المتوفرة في نص الطلب.

إذا لم يتم العثور على الجهاز ذي المعرف المحدد - 404 غير موجود.

المثال

طلب

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

PATCH https://api.securitycenter.microsoft.com/api/machines/{machineId}

{
    "deviceValue": "Normal",
    "machineTags": [
                     "Demo Device",
                     "Generic User Machine - Attack Source",
                     "Windows 10" "Windows11",
                     "Windows Insider - Fast"
    ]
}

تلميح

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