الحصول على واجهة برمجة تطبيقات machineAction

مقالة
05/03/2024

ينطبق على:

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

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

استرداد إجراء جهاز معين بواسطة معرفه.

القيود

قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.

الأذونات

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

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

ملاحظة

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

يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: "عرض البيانات" (لمزيد من المعلومات، راجع الإنشاء الأدوار وإدارتها)

طلب HTTP

GET https://api.securitycenter.microsoft.com/api/machineactions/{id}

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

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

نص الطلب

فارغه

استجابه

إذا نجحت، فترجع هذه الطريقة 200، رمز استجابة موافق مع كيان إجراء الجهاز . إذا لم يتم العثور على كيان إجراء الجهاز بالمعرف المحدد - 404 غير موجود.

المثال

طلب مثال

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

GET https://api.securitycenter.microsoft.com/api/machineactions/2e9da30d-27f6-4208-81f2-9cd3d67893ba

مثال على الاستجابة

فيما يلي مثال على الاستجابة.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
    "id": "5382f7ea-7557-4ab7-9782-d50480024a4e",
    "type": "Isolate",
    "scope": "Selective",
    "requestor": "Analyst@TestPrd.onmicrosoft.com",
    "requestorComment": "test for docs",
    "status": "Succeeded",
    "machineId": "7b1f4967d9728e5aa3c06a9e617a22a4a5a17378",
    "computerDnsName": "desktop-test",
    "creationDateTimeUtc": "2019-01-02T14:39:38.2262283Z",
    "lastUpdateDateTimeUtc": "2019-01-02T14:40:44.6596267Z",
    "relatedFileInfo": null
}