مشاركة عبر

تنسيق طلب Azure Monitor Log Analytics API

  • مقالة

توجد نقطتا نهاية يمكنك من خلالهما التواصل مع Log Analytics API:

  • عنوان URL مباشر لواجهة برمجة التطبيقات: https://api.loganalytics.azure.com
  • من خلال Azure Resource Manager‏ (ARM).

في حين أن عناوين URL مختلفة، فإن معلمات الاستعلام هي نفسها لكل نقطة نهاية. تتطلب نقطتا النهاية التخويل من خلال معرف Microsoft Entra.

تدعم API الطرق POST وGET.

تنسيق API العام

تنسيق API العام هو:

    https://api.loganalytics.azure.com/{api-version}/workspaces/{workspaceId}/query?[parameters]

الموقع:

  • نسخة-api: نسخة API. الإصدار الحالي هو «v1»
  • workspaceId: معرف مساحة العمل الخاص بك
  • parameters: البيانات المطلوبة لهذا الاستعلام

GET /query

عندما يكون تنفيذ أسلوب HTTP هو GET، يتم تضمين المعلمات في سلسلة الاستعلام.

على سبيل المثال، لحساب أحداث AzureActivity حسب الفئة، قم بإجراء هذا الاستدعاء:

    GET https://api.loganalytics.azure.com/v1/workspaces/{workspace-id}/query?query=AzureActivity%20|%20summarize%20count()%20by%20Category
    Authorization: Bearer <access token>

POST /query

عندما يكون تنفيذ أسلوب HTTP هو POST:

  • يتعين أن يكون النص الأساسي JSON صالحًا.
  • يتعين أن يشتمل الطلب على العنوان: Content-Type: application/json
  • يتم تضمين المعلمات كخصائص في نص JSON.
  • إذا تم تضمين معلمة الفترة الزمنية في كل من سلسلة الاستعلام و نص JSON، فإن الفترة الزمنية ستكون تقاطع القيمتين.

على سبيل المثال، لحساب أحداث AzureActivity حسب الفئة، قم بإجراء هذا الاستدعاء:

    POST https://api.loganalytics.azure.com/v1/workspaces/{workspace-id}/query
    
    Authorization: Bearer <access token>
    Content-Type: application/json
    
    {
      "query": "AzureActivity | summarize count() by Category"
    }