تنسيق استجابة واجهة برمجةِ تطبيقات Azure Monitor Log Analytics

استجابة Azure Monitor Log Analytics API هي سلسلة JSON تحتوي على صفيف من كائنات الجدول.

tables الخاصية هي صفيف من الجداول التي تمثل نتيجة الاستعلام. يحتوي كل جدول على nameخصائص columnsو و rows :

• الخاصية name هي اسم الجدول.
• columns الخاصية هي صفيف من الكائنات التي تصف مخطط كل عمود.
• الخاصية rows هي صفيف من القيم. يُمثل كل عنصر في الصفيف صفًا في مجموعة النتائج.

في المثال التالي، يمكننا أن نرى أن النتيجة تحتوي على عمودين: Category و count_. يمثل العمود الأول، Category، قيمة Category العمود في AzureActivity الجدول. العمود الثاني، count_ هو عدد الأحداث في AzureActivity الجدول للفئة المحددة.

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    
    {
        "tables": [
            {
                "name": "PrimaryResult",
                "columns": [
                    {
                        "name": "Category",
                        "type": "string"
                    },
                    {
                        "name": "count_",
                        "type": "long"
                    }
                ],
                "rows": [
                    [
                        "Administrative",
                        20839
                    ],
                    [
                        "Recommendation",
                        122
                    ],
                    [
                        "Alert",
                        64
                    ],
                    [
                        "ServiceHealth",
                        11
                    ]
                ]
            }
        ]
    }

أخطاء واجهة برمجة التطبيقات Azure Monitor Log Analytics

إذا حدث خطأ فادح أثناء تنفيذ الاستعلام، يتم إرجاع رمز حالة الخطأ مع كائن خطأ OneAPI الذي يصف الخطأ.

إذا حدث خطأ غير فادح أثناء تنفيذ الاستعلام، فإن رمز حالة الاستجابة هو 200 OK. يحتوي على نتائج الاستعلام في الخاصية tables كما هو موضح. تحتوي الاستجابة أيضا على خاصية error ، وهي كائن خطأ OneAPI مع التعليمات البرمجية PartialError. تُدرج تفاصيل الخطأ في الخاصية details.

الخطوات التالية

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