Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
HTTP hata yanıtları iki kategoriye ayrılır:
- İstemci hatası (400 kod düzeyi) – istemci geçersiz bir istek gönderdi veya istek tanımlara uygun değil.
- Sunucu hatası (500 düzeyi) – sunucu geçici olarak isteği yerine getiremedi veya bir sunucu hatası oluştu. HTTP isteğini göndermeyi yeniden deneyin.
Aşağıdaki tabloda listelenen hata kodları, Uç Nokta için Microsoft Defender API'lerden herhangi birinde bir işlem tarafından döndürülebilir.
- Hata koduna ek olarak, her hata yanıtı sorunu çözmeye yardımcı olabilecek bir hata iletisi içerir.
- İleti, değiştirilebilen bir serbest metindir.
- Sayfanın en altında yanıt örneklerini bulabilirsiniz.
| 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) | {geçersiz karma} karma değeri geçersiz. |
| InvalidDomainName | BadRequest (400) | Etki alanı adı {geçersiz etki alanı} geçersiz. |
| InvalidIpAddress | BadRequest (400) | {geçersiz IP} IP adresi geçersiz. |
| InvalidUrl | BadRequest (400) | {geçersiz URL} URL'si geçersiz. |
| MaximumBatchSizeExceeded | BadRequest (400) | Maksimum toplu iş boyutu aşıldı. Alındı: {toplu iş boyutu alındı}, izin verildi: {batch size allowed}. |
| MissingRequiredParameter | BadRequest (400) | {the missing parameter} parametresi eksik. |
| OsPlatformNotSupported | BadRequest (400) | İşletim Sistemi Platformu {istemci işletim sistemi platformu}, bu eylem için desteklenmiyor. |
| ClientVersionNotSupported | BadRequest (400) | {İstenen eylem}, istemci sürümü {desteklenen istemci sürümü} ve üzerinde desteklenir. |
| Yetkisiz | Yetkisiz (401) | Yetkisiz (geçersiz veya süresi dolmuş yetkilendirme üst bilgisi). |
| Yasak | Yasak (403) | Yasak (geçerli belirteç ama eylem için yeterli izin yok). |
| 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} kaynağı bulunamadı. |
| TooManyRequests | Çok Fazla İstek (429) | Yanıt, istek sayısına veya CPU'ya göre kota sınırına ulaşmayı temsil eder. |
| InternalServerError | İç Sunucu Hatası (500) | (Hata iletisi yok, işlemi yeniden deneyin.) |
Azaltma
Belirli bir zaman çerçevesindeki HTTP isteklerinin sayısı API başına izin verilen çağrı sayısını aştığında HTTP istemcisi 'Çok Fazla İstek Hatası (429)' alabilir.
HTTP istemcisi, daha fazla HTTPS isteğinin yeniden gönderilmesini geciktirmeli ve ardından bunları hız sınırlamalarına uygun bir şekilde göndermelidir. Yanıt üst bilgisinde yeni bir istek yapmadan önce ne kadar süre (saniye) beklendiğini belirten bir Retry-After
429 yanıtını yoksaymak veya HTTP isteklerini daha kısa bir zaman diliminde yeniden göndermeye çalışmak, 429 hata kodunun döndürülmesi sağlar.
Gövde parametreleri büyük/küçük harfe duyarlıdır
Gönderilen gövde parametreleri şu anda büyük/küçük harfe duyarlıdır.
InvalidRequestBody veya MissingRequiredParameter hatalarıyla karşılaşıyorsanız, bunun nedeni yanlış parametre büyük veya küçük harf olabilir.
API belgeleri sayfasını gözden geçirin ve gönderilen parametrelerin ilgili örnekle eşleşip eşleşmediğini denetleyin.
Bağıntı isteği kimliği
Her hata yanıtı, izleme için benzersiz bir kimlik parametresi içerir.
Bu parametrenin özellik adı "target" olur.
Bir hata hakkında bizimle iletişim kurarken, bu kimliğin eklenmesi sorunun kök nedenini bulmanıza yardımcı olur.
Ö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"
}
}
İpucu
Daha fazla bilgi edinmek mi istiyorsunuz? Teknoloji Topluluğumuzdaki Microsoft Güvenlik topluluğuyla Engage: Uç Nokta için Microsoft Defender Teknoloji Topluluğu.