Azure İzleyici Log Analytics API hataları

Bu bölüm bilinen yaygın hataların, bunların nedenlerinin ve olası çözümlerin kapsamlı olmayan bir listesini içerir. Ayrıca, genellikle istekle ilgili bir sorunu (eksik üst bilgi gibi) veya başka bir beklenmeyen davranışı gösteren başarılı yanıtlar içerir.

Sorgu söz dizimi hatası

400 yanıtı:

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

Sorgu dizesi hatalı biçimlendirilmiş. Ek boşluklar, noktalama işaretleri veya yazım hataları olup olmadığını denetleyin.

Kimlik doğrulaması sağlanmadı

401 yanıtı:

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

İsteğinize üst bilgi "Authorization: Bearer \<token\>"gibi bir kimlik doğrulaması biçimi ekleyin.

Geçersiz kimlik doğrulama belirteci

403 yanıtı:

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

Belirteç yanlış biçimlendirilmiş veya başka bir şekilde geçersiz. Bu hata, belirteci el ile kopyalayıp yapıştırır ve yüke karakter ekler veya keserseniz oluşabilir. Belirtecin tam olarak Microsoft Entra Id'den alınan değer olduğunu doğrulayın.

Geçersiz belirteç izleyicisi

403 yanıtı:

    {
        "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/'."
        }
    }

Bu hata, API için bir belirteç almak üzere istemci kimlik bilgileri OAuth2 akışını kullanmaya çalışırsanız ve ardından Azure Resource Manager uç noktası aracılığıyla bu belirteci kullanırsanız oluşur. Azure Resource Manager uç noktasını kullanmak istiyorsanız belirteç isteğinizde kaynak olarak belirtilen URL'lerden birini kullanın. Alternatif olarak, yetkilendirme için farklı bir OAuth2 akışıyla doğrudan API uç noktasını kullanabilirsiniz.

API'yi yönlendirmek için istemci kimlik bilgileri

403 yanıtı:

    {
        "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"
            }
        }
    }

Doğrudan API uç noktası aracılığıyla istemci kimlik bilgilerini kullanmaya çalışırsanız bu hata oluşabilir. Doğrudan API uç noktasını kullanıyorsanız yetkilendirme için farklı bir OAuth2 akışı kullanın. İstemci kimlik bilgilerini kullanmanız gerekiyorsa Azure Resource Manager API uç noktasını kullanın.

Yetersiz izinler

403 yanıtı:

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

Yetkilendirme için sunduğunuz belirteç, bu ayrıcalık için yeterli erişime sahip olmayan bir kullanıcıya ait. Çalışma alanı GUID'nizin ve belirteç isteğinizin doğru olduğunu doğrulayın. Gerekirse, Katkıda Bulunan olarak oluşturduğunuz Microsoft Entra uygulamasına çalışma alanınızda IAM ayrıcalıkları verin.

Dekont

Microsoft Entra kimlik doğrulamasını kullandığınızda, Uygulama Analizler REST API'sinin yeni rol tabanlı erişim denetimi izinlerini tanıması 60 dakika kadar sürebilir. İzinler yayılırken REST API çağrıları 403 hata koduyla başarısız olabilir.

Hatalı yetkilendirme kodu

403 yanıtı:

    {
        "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
        ]
    }

Belirteç isteğinde gönderilen yetkilendirme kodu eski veya daha önce kullanılmış. Yeni bir kod almak için Microsoft Entra yetkilendirme uç noktası aracılığıyla yeniden yetkilendirilin.

Yol bulunamadı

404 yanıtı:

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

İstenen sorgu yolu yok. Bastığınız uç noktanın URL yazımını ve desteklenen bir HTTP fiilini kullandığınızı doğrulayın.

Eksik JSON veya İçerik Türü

200 yanıt: Boş gövde

JSON gövdesi veya "Content-Type: application/json" üst bilgisi eksik bir POST isteği gönderirseniz, boş bir 200 yanıtı döndürüriz.

Çalışma alanında veri yok

204 yanıtı: Boş gövde

Çalışma alanında veri yoksa 204 İçerik Yok değerini döndürüriz.