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

ويحتوي هذا القسم على قائمة غير شاملة بالأخطاء الشائعة المعروفة وأسبابها والحلول الممكنة. كما يحتوي على استجابات ناجحة، والتي غالبا ما تشير إلى وجود مشكلة في الطلب (مثل عنوان مفقود) أو سلوك غير متوقع.

خطأ في بناء جملة الاستعلام

400 استجابة:

    {
        "error": {
            "message": "The request had some invalid properties",
            "code": "BadArgumentError",
            "innererror": {
                "code": "SyntaxError",
                "message": "Syntax Error"
            }
        }
    }

تم تكوين سلسلة الاستعلام بشكل غير صحيح. تحقق من وجود مسافات زائدة أو أخطاء في علامات ترقيم أو أخطاء إملائية.

لم يتم توفير مصادقة

استجابة 401:

    {
        "error": {
            "code": "AuthenticationFailed",
            "message": "Authentication failed. The 'Authorization' header is missing."
        }
    }

قم بتضمين نموذج مصادقة مع طلبك، مثل العنوان "Authorization: Bearer \<token\>".

رمز المصادقة المميز غير صالح

استجابة 403:

    {
        "error": {
            "code": "InvalidAuthenticationToken",
            "message": "The access token is invalid."
        }
    }

الرمز المميز غير صحيح أو غير صالح. يمكن أن يحدث هذا الخطأ إذا قمت يدويا بنسخ ولصق الرمز المميز وإضافة أحرف أو قصها إلى الحمولة. تحقق من أن الرمز المميز هو تماما كما تم تلقيه من Microsoft Entra ID.

جمهور الرمز المميز غير صحيح

استجابة 403:

    {
        "error": {
            "code": "InvalidAuthenticationTokenAudience",
            "message": "The access token has been obtained from wrong audience or resource 'https://api.loganalytics.io'. It should exactly match (including forward slash) with one of the allowed audiences 'https://management.core.windows.net/','https://management.azure.com/'."
        }
    }

يحدث هذا الخطأ إذا حاولت استخدام بيانات اعتماد العميل تدفق OAuth2 للحصول على رمز مميز لواجهة برمجة التطبيقات ثم استخدم هذا الرمز المميز عبر نقطة نهاية Azure Resource Manager. استخدم أحد عناوين URL المشار إليها كمورد في طلب الرمز المميز إذا كنت تريد استخدام نقطة نهاية Azure Resource Manager. بدلاً من ذلك، يمكنك استخدام نقطة نهاية واجهة برمجة التطبيقات المباشرة مع تدفق OAuth2 مختلف للمصادقة.

بيانات اعتماد العميل لتوجيه واجهة برمجة التطبيقات

استجابة 403:

    {
        "error": {
            "message": "The provided credentials have insufficient access to perform the requested operation",
            "code": "InsufficientAccessError",
            "innererror": {
                "code": "UnauthorizedClient",
                "message": "The service principal does not have sufficient permissions to access this resource: 997631f8-3a55-4bb2-81b2-c0972b222260"
            }
        }
    }

يمكن أن يحدث هذا الخطأ إذا حاولت استخدام بيانات اعتماد العميل عبر نقطة نهاية واجهة برمجة التطبيقات المباشرة. إذا كنت تستخدم نقطة نهاية واجهة برمجة التطبيقات المباشرة، فاستخدم تدفق OAuth2 مختلفا للتخويل. إذا كان يجب استخدام بيانات اعتماد العميل، فاستخدم نقطة نهاية Azure Resource Manager API.

الأذونات الغير كافية

استجابة 403:

    {
        "error": {
            "message": "The provided credentials have insufficient access to perform the requested operation",
            "code": "InsufficientAccessError"
        }
    }

الرمز المميز الذي قدمته للتخويل ينتمي إلى مستخدم ليس لديه حق وصول كاف إلى هذا الامتياز. تحقق من صحة GUID لمساحة العمل وطلب الرمز المميز الخاص بك. إذا لزم الأمر، امنح امتيازات IAM في مساحة العمل الخاصة بك إلى تطبيق Microsoft Entra الذي أنشأته كمساهم.

رمز التخويل غير الصالح

استجابة 403:

    {
        "error": "invalid_grant",
        "error_description": "AADSTS70002: Error validating credentials. AADSTS70008: The provided authorization code or refresh token is expired. Send a new interactive authorization request for this user and resource.",
        "error_codes": [
            70002,
            70008
        ]
    }

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

لم يتم العثور على المسار

استجابة 404:

    {
        "error": {
            "message": "The requested path does not exist",
            "code": "PathNotFoundError"
        }
    }

مسار الاستعلام المطلوب غير موجود. تحقق من إملاء عنوان URL لنقطة النهاية التي تقوم بالضغط عليها ومن أنك تستخدم فعل HTTP معتمدا.

JSON أو نوع المحتوى مفقود

استجابة 200: نص فارغ

إذا أرسلت طلب POST مفقودا إما نص JSON أو "Content-Type: application/json" العنوان، فإننا نرجع استجابة فارغة 200.

لا توجد بيانات في مساحة العمل

استجابة 204: نص فارغ

إذا لم تكن مساحة العمل تحتوي على بيانات، فإننا نرجع 204 بلا محتوى.