HTTP durum kodları (Azure Bilişsel Arama)HTTP status codes (Azure Cognitive Search)

Bu sayfada, Azure Bilişsel Arama API 'SI kullanılırken sık döndürülen HTTP durum kodları açıklanmaktadır.This page describes the HTTP status codes that are frequently returned when using the Azure Cognitive Search API.

Ortak HTTP durum kodlarıCommon HTTP status codes

KodCode AçıklamaDescription
200 TAMAM200 OK GET, PUT veya POST işleminde başarılı oldu.Success on GET, PUT, or POST. Başarılı bir yanıt için döndürüldü.Returned for a successful response. Dizin oluşturma sırasında, bu kod tüm öğelerin durda saklandığını belirtir ve dizine oluşturulacak şekilde başlatılır.During indexing, this code indicates all items have been stored durably and will start to be indexed. Dizin oluşturma, arka planda çalışır ve dizin oluşturma işlemi tamamlandıktan sonra birkaç saniye içinde yeni belgeler sorgulanabilir ve aranabilir olur.Indexing runs in the background and makes new documents queryable and searchable a few seconds after the indexing operation completed.
201 oluşturuldu201 Created PUT veya POST işleminde başarı.Success on PUT or POST. Nesne başarıyla oluşturuldu veya güncelleştirildi.Object created or updated successfully.
204 kabul edildi204 Accepted PUT veya POST işleminde başarı.Success on PUT or POST. Dizin veya belgeler başarıyla karşıya yüklendi.Index or documents uploaded successfully.
207 çok durum207 Multi-Status PUT veya POST için kısmi başarı.Partial success for PUT or POST. Bazı belgeler başarılı oldu, ancak en az bir başarısız oldu.Some documents succeeded, but at least one failed.
400 Hatalı Istek400 Bad Request İstek URI 'SI, üst bilgiler veya gövdede bir hata olduğunda döndürüldü.Returned when there is an error in the request URI, headers, or body. Yanıt gövdesi, belirli bir sorunun ne olduğunu açıklayan bir hata iletisi içerir.The response body will contain an error message explaining what the specific problem is.
403 Yasak403 Forbidden Geçersiz bir API anahtarı geçirdiğinizde döndürüldü.Returned when you pass an invalid api-key.
404 Bulunamadı404 Not Found Sunucuda bir kaynak mevcut olmadığında döndürülür.Returned when a resource does not exist on the server. Bir dizini yönetiyorsunuz veya sorgulamakta, söz dizimini denetleyin ve Dizin adının doğru bir şekilde belirtildiğinden emin olun.If you are managing or querying an index, check the syntax and verify the index name is specified correctly.
409 çakışması409 Conflict Yazma işlemleri çakışması olduğunda döndürülür.Returned when write operations conflict. Bu hata, kaynak güncelleştirmeleri için veya iki işlem aynı belgeyi aynı anda güncelleştirmeye çalıştığında dizin oluşturma sırasında döndürülür.This error is returned for resource updates, or during indexing when two processes try to update the same document simultaneously. Azure Bilişsel Arama, kaynak güncelleştirmeleri için eşzamanlılık yönetimi sağlar.Azure Cognitive Search provides concurrency management for resource updates. Daha fazla bilgi için bkz. Azure bilişsel arama eşzamanlılık yönetimi.For more information, see How to manage concurrency in Azure Cognitive Search.
412 Önkoşul başarısız oldu412 Precondition Failed IF-Match veya If-None-Match üst bilgisinin koşulu false olarak değerlendirilirse döndürüldü.Returned when an If-Match or If-None-Match header's condition evaluates to false. Dizin tanımları, Dizin oluşturucular veya veri kaynakları için HTTP istekleri gönderirken iyimser eşzamanlılık denetimi kullanılarak ilişkili.Associated with using optimistic concurrency control when sending HTTP requests for index definitions, indexers, or data sources.
429 Çok Fazla İstek Var429 Too Many Requests Bir dizin oluşturmaya çalışırken bu hata oluşursa, fiyatlandırma katmanınız için izin verilen en fazla sayıda dizine zaten sahip olduğunuz anlamına gelir.If this error occurs while you are trying to create an index, it means you already have the maximum number of indexes allowed for your pricing tier. Azure Bilişsel Arama depolanan dizinlerin sayısı, Azure Portalarama hizmeti panosunda görünür.A count of the indexes stored in Azure Cognitive Search is visible in the search service dashboard on the Azure portal. Dizinleri ada göre görüntülemek için Dizin kutucuğuna tıklayın.To view the indexes by name, click the Index tile. Alternatif olarak, dizinleri Listeleme işlemini kullanarak dizinlerin listesini ada göre de alabilirsiniz.Alternatively, you can also get a list of the indexes by name using the List Indexes operation. Ayrıntılar için bkz. Azure Bilişsel Arama (dizinleri listeleme REST API) .See List Indexes (Azure Cognitive Search REST API) for details.

Belge karşıya yükleme sırasında bu hata oluşursa, dizin başına belge sayısında kotayı aşdığınızı gösterir.If this error occurs during document upload, it indicates that you've exceeded your quota on the number of documents per index. Yeni bir dizin oluşturmanız ya da daha yüksek kapasite sınırları için yükseltmeniz gerekir.You must either create a new index or upgrade for higher capacity limits.
499 istemci kapatıldı Isteği499 Client Closed Request Bu hata bir yanıtta hiçbir şekilde döndürülmez, ancak arama trafiği analizi ve Azure izleyici tarafından kaydedilen günlük girişlerinde görebilirsiniz.This error is never returned in a response, but you might see it in log entries recorded by search traffic analytics and Azure Monitor. Hizmet tarafından bir yanıt döndürülmeden önce bir istemcinin bağlantıyı kapattığından emin olduğunu gösterir.It indicates that a client closed the connection before a response was returned by the service. Azure Bilişsel Arama, hizmet tarafı kodu tarafından istenmiş olmayan bir iptal algıladığında veya istemcinin artık mevcut olmadığı durumlarda 499 hatası günlüğe kaydedilir.When Azure Cognitive Search detects a cancellation that was not requested by service-side code, or that the client no longer exists, a 499 error is logged.
502 Hatalı Ağ Geçidi502 Bad Gateway Bu hata, bağlantıda HTTPS yerine HTTP girdiğinizde oluşur.This error occurs when you enter HTTP instead of HTTPS in the connection.
503 Hizmet Kullanılamıyor503 Service Unavailable Bu hata, sistemin aşırı yüklü olduğu ve isteğinizin şu anda işlenemediği anlamına gelir.This error means that the system is under heavy load and your request can't be processed at this time. Önemli: Bu durumda, istemci kodunuzun yeniden denenmesini ve yeniden denemeden önce beklemesi önemle tavsiye ederiz.Important: In this case, we highly recommend that your client code back off and wait before retrying. Böylece kurtulması için sisteme biraz zaman tanınmış ve gelecekteki isteklerin başarılı olma şansı artırılmış olur.This will give the system some time to recover, increasing the chances that future requests will succeed. İsteklerinizi hızla yeniden denemeniz bu durumu yalnızca uzatır.Rapidly retrying your requests will only prolong the situation.
504: ağ geçidi zaman aşımı504: Gateway Timeout Azure Bilişsel Arama, HTTPS bağlantı noktası 443 ' de dinler.Azure Cognitive Search listens on HTTPS port 443. Arama Hizmeti URL 'niz HTTPS yerine HTTP içeriyorsa, 504 durum kodu döndürülür.If your search service URL contains HTTP instead of HTTPS, a 504 status code will be returned.

Ayrıca bkz.See also

Azure Bilişsel Arama .NET SDKAzure Cognitive Search .NET SDK
Azure Bilişsel Arama REST API 'LeriAzure Cognitive Search REST APIs