Aracılığıyla paylaş

Yaygın Microsoft Defender XDR REST API hata kodları

  • Makale

Şunlar için geçerlidir:

  • Microsoft Defender XDR

Not

MS Graph güvenlik API'lerini kullanarak yeni API'lerimizi deneyin. Daha fazla bilgi için bkz. Microsoft Graph güvenlik API'sini kullanma - Microsoft Graph | Microsoft Learn.

Önemli

Bazı bilgiler, ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilebilen önceden yayımlanmış ürünle ilgilidir. Microsoft, burada sağlanan bilgilerle ilgili olarak açık veya zımni hiçbir garanti vermez.

Hata kodları, Microsoft Defender XDR API'lerinden herhangi birinde bir işlem tarafından döndürülebilir. Her hata yanıtı, sorunun çözülmesine yardımcı olabilecek bir hata iletisi içerir. Tablo bölümündeki hata iletisi sütunu bazı örnek iletiler sağlar. Gerçek iletilerin içeriği, yanıtı tetikleyen faktörlere göre değişir. Değişken içeriği aşağıdaki tabloda açılı ayraçlarla (< >) gösterilir:

Hata kodları

Hata kodu HTTP durum kodu İleti
BadRequest BadRequest (400) Genel Hatalı İstek hata iletisi.
ODataError BadRequest (400) Geçersiz OData URI sorgusu <belirli bir hata belirtildi>.
InvalidInput BadRequest (400) Geçersiz giriş <geçersiz giriş>.
InvalidRequestBody BadRequest (400) Geçersiz istek gövdesi.
InvalidHashValue BadRequest (400) Karma değer <geçersiz karma> geçersiz.
InvalidDomainName BadRequest (400) Etki alanı adı <geçersiz etki alanı> geçersiz.
InvalidIpAddress BadRequest (400) GEÇERSIZ IP adresi <geçersiz> .
InvalidUrl BadRequest (400) Geçersiz URL'nin <geçersiz olduğu URL> .
MaximumBatchSizeExceeded BadRequest (400) Maksimum toplu iş boyutu aşıldı. Alındı: <toplu iş boyutu alındı>, izin verildi: {batch size allowed}.
MissingRequiredParameter BadRequest (400) Eksik <parametre> eksik parametresi.
OsPlatformNotSupported BadRequest (400) İşletim Sistemi Platformu <bu eylem için istemci işletim sistemi platformu> desteklenmez.
ClientVersionNotSupported BadRequest (400) <İstenen eylem> , istemci sürümü <tarafından desteklenen istemci sürümü ve sonraki sürümlerde> desteklenir.
Yetki -siz Yetkisiz (401) Yetki -siz

Bu hataya genellikle geçersiz veya süresi dolmuş yetkilendirme üst bilgisi neden olur.
Yasak Yasak (403) Yasak

Bu hata geçerli bir belirteçle oluşabilir ancak eylem için izin yetersiz olabilir.
DisabledFeature Yasak (403) Kiracı özelliği etkinleştirilmedi.
DisallowedOperation Yasak (403) <izin verilmeyen işlem ve nedeni>.
NotFound Bulunamadı (404) Genel Bulunamadı hata iletisi.
ResourceNotFound Bulunamadı (404) <İstenen kaynak> bulunamadı.
InternalServerError İç Sunucu Hatası (500) Hata iletisi yoksa işlemi yeniden deneyin. Çözümlenmezse Microsoft'a başvurun.

Örnekler

{
    "error": {
        "code": "ResourceNotFound",
        "message": "Machine 123123123 was not found",
        "target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
    }
}

{
    "error": {
        "code": "InvalidRequestBody",
        "message": "Request body is incorrect",
        "target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
    }
}

Gövde parametreleri

Önemli

Gövde parametreleri büyük/küçük harfe duyarlıdır.

InvalidRequestBody veya MissingRequiredParameter hatasıyla karşılaşırsanız, bunun nedeni yazım hatası olabilir. API belgelerini gözden geçirin ve gönderilen parametrelerin ilgili örnekle eşleşip eşleşmediğini denetleyin.

İzleme Kimliği

Her hata yanıtı, izleme için benzersiz bir kimlik parametresi içerir. Bu parametrenin özellik adı hedeftir. Bir hata hakkında Microsoft'a başvurursanız, izleme kimliğinizi eklemek Microsoft'un sorunun kök nedenini bulmasına yardımcı olur.

İpucu

Daha fazla bilgi edinmek mi istiyorsunuz? Teknoloji Topluluğumuzdaki Microsoft Güvenlik topluluğuyla etkileşime geçin: Microsoft Defender XDR Teknoloji Topluluğu.