تحديث الجهاز

ينطبق على:

• الخطة 1 من Microsoft Defender لنقطة النهاية
• Defender for Endpoint الخطة 2
• Microsoft Defender XDR
• Microsoft Defender for Business

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

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

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

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

القيود

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

الأذونات

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

طلب HTTP

PATCH /api/machines/{machineId}

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

نص الطلب

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

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

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

استجابه

إذا نجحت، ترجع هذه الطريقة 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"
    ]
}