إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
وصف واجهة برمجة التطبيقات
استرداد مجموعة من التنبيهات المتعلقة بعنوان IP معين.
القيود
قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 مكالمة في الساعة.
الأذونات
عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:
- يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل:
View Data. لمزيد من المعلومات، راجع إنشاء الأدوار وإدارتها لمزيد من المعلومات. - تتضمن الاستجابة فقط التنبيهات المقترنة بالأجهزة التي يمكن للمستخدم الوصول إليها، استنادا إلى إعدادات مجموعة الأجهزة (راجع إنشاء مجموعات الأجهزة وإدارتها لمزيد من المعلومات)
أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع استخدام واجهات برمجة تطبيقات Defender لنقطة النهاية.
| نوع الإذن | إذن | اسم عرض الإذن |
|---|---|---|
| Application | Alert.Read.All | Read all alerts |
| Application | Alert.ReadWrite.All | Read and write all alerts |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Alert.Read | Read alerts |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Alert.ReadWrite | Read and write alerts |
طلب HTTP
GET /api/ips/{ip}/alerts
عناوين الطلبات
| الاسم | نوع | الوصف |
|---|---|---|
| إذن | سلسلة | الحامل {token}. مطلوب. |
نص الطلب
أجوف
استجابه
إذا كان ناجحا و IP موجودا - 200 موافق مع قائمة كيانات التنبيه في النص الأساسي. إذا كان عنوان IP غير معروف ولكنه صالح، فإنه يرجع مجموعة فارغة. إذا كان عنوان IP غير صالح، فإنه يرجع HTTP 400.
مثل
طلب
فيما يلي مثال على الطلب.
GET https://api.security.microsoft.com/api/ips/10.209.67.177/alerts