HTTP durum kodları (Azure AI Search)
Bu sayfada, Azure AI Arama API'sini kullanırken sık sık döndürülen HTTP durum kodları açıklanmaktadır.
Ortak HTTP durum kodları
| Kod | Description |
|---|---|
| 200 Tamam | GET, PUT veya POST'ta başarı. Başarılı bir yanıt için döndürüldü. Dizin oluşturma sırasında, bu kod tüm öğelerin durabilir bir şekilde depolandığını ve dizine alınacağını gösterir. Dizin oluşturma arka planda çalışır ve dizin oluşturma işlemi tamamlandıktan birkaç saniye sonra yeni belgeleri sorgulanabilir ve aranabilir hale getirir. |
| 201 Oluşturuldu | PUT veya POST'ta başarı. Nesne başarıyla oluşturuldu veya güncelleştirildi. |
| 204 Kabul Edildi | PUT veya POST'ta başarı. Dizin veya belgeler başarıyla karşıya yüklendi. |
| 207 Çoklu Durum | PUT veya POST için kısmi başarı. Bazı belgeler başarılı oldu, ancak en az biri başarısız oldu. |
| 400 Hatalı İstek | İstek URI'sinde, üst bilgilerinde veya gövdesinde bir hata olduğunda döndürülür. Yanıt gövdesi, sorunun ne olduğunu açıklayan bir hata iletisi içerir. |
| 403 Yasak | Geçersiz bir api anahtarı geçirdiğinizde döndürülür. |
| 404 Bulunamadı | Sunucuda bir kaynak olmadığında döndürülür. Bir dizini yönetiyor veya sorguluysanız söz dizimini denetleyin ve dizin adının doğru belirtildiğini doğrulayın. |
| 405 Yöntemi Desteklenmiyor | İstek tanınan ancak desteklenmeyen bir yöntem belirttiğinde döndürülür. Bir dizini sorgularsanız, bu isteğin formülasyonu uç noktayı, dizin koleksiyonunu ve dizinini, docs koleksiyonunu ve arama yöntemini (örneğin, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30) içerir. |
| 409 Çakışma | Yazma işlemleri çakıştığında döndürülür. Bu hata kaynak güncelleştirmeleri için veya iki işlem aynı belgeyi aynı anda güncelleştirmeyi denediğinde dizin oluşturma sırasında döndürülür. Azure AI Search, kaynak güncelleştirmeleri için eşzamanlılık yönetimi sağlar. Daha fazla bilgi için bkz. Azure AI Search'te eşzamanlılığı yönetme. |
| 412 Önkoşul Başarısız Oldu | bir If-Match veya If-None-Match üst bilgisinin koşulu false olarak değerlendirildiğinde döndürülür. Dizin tanımları, dizin oluşturucular veya veri kaynakları için HTTP istekleri gönderirken iyimser eşzamanlılık denetiminin kullanılmasıyla ilişkilendirildi. |
| 429 Çok Fazla İstek Var | Dizin oluşturmaya çalışırken bu hata oluşursa, fiyatlandırma katmanınız için izin verilen en fazla dizin sayısına zaten sahip olduğunuz anlamına gelir. Azure AI Search'te depolanan dizinlerin sayısı, Azure portal arama hizmeti panosunda görünür. Dizinleri ada göre görüntülemek için Dizin kutucuğunu seçin. Alternatif olarak, Dizinleri Listele işlemini kullanarak ada göre dizinlerin listesini de alabilirsiniz. Ayrıntılar için bkz. Dizinleri Listeleme . Bu hata belgeyi karşıya yükleme sırasında oluşursa, dizin başına belge sayısı kotanızı aştığınızı gösterir. Daha yüksek kapasite sınırları için yeni bir dizin oluşturmanız veya yükseltmeniz gerekir. |
| 499 İstemci Kapalı İsteği | Bu hata hiçbir zaman yanıtta döndürülmüyor, ancak bunu arama trafik analizi ve Azure İzleyici tarafından kaydedilen günlük girişlerinde görebilirsiniz. Hizmet tarafından yanıt döndürülmeden önce istemcinin bağlantıyı kapattığını gösterir. Azure AI Search, hizmet tarafı kodu tarafından istenmemiş bir iptal algıladığında veya istemcinin artık mevcut olmadığını algıladığında 499 hatası günlüğe kaydedilir. |
| 502 Hatalı Ağ Geçidi | Bağlantıda HTTPS yerine HTTP girdiğinizde bu hata oluşur. |
| 503 Hizmet Kullanılamıyor | Bu hata, sistemin aşırı yüklü olduğu ve isteğinizin şu anda işlenemediği anlamına gelir. Önemli: Bu durumda, istemci kodunuzun geri dönmesini ve yeniden denemeden önce beklemesini kesinlikle öneririz. Böylece kurtulması için sisteme biraz zaman tanınmış ve gelecekteki isteklerin başarılı olma şansı artırılmış olur. İsteklerinizi hızla yeniden denemeniz bu durumu yalnızca uzatır. Azaltma ve bu koşulu önleme hakkında daha fazla bilgi için bkz. Performansı analiz etme. |
| 504: Ağ Geçidi Zaman Aşımı | Azure AI Search, HTTPS bağlantı noktası 443'te dinler. Arama hizmeti URL'niz HTTPS yerine HTTP içeriyorsa, 504 durum kodu döndürülür. |