Yaygın Microsoft Defender XDR REST API hata kodları
Ş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 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. |
{
"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"
}
}
Ö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.
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.
- Microsoft Graph güvenlik API'sini kullanma - Microsoft Graph | Microsoft Learn
- api'lere genel bakış Microsoft Defender XDR
- Desteklenen Microsoft Defender XDR API'leri
- Microsoft Defender XDR API'lerine erişme
- API sınırları ve lisanslama hakkında bilgi edinin
İ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.