Belgeleri say (Azure Bilişsel Arama REST API)Count Documents (Azure Cognitive Search REST API)

Belgeleri say işlemi, bir arama dizinindeki belge sayısı sayısını alır.The Count Documents operation retrieves a count of the number of documents in a search index. $countSöz dizimi OData protokolünün bir parçasıdır.The $count syntax is part of the OData protocol.

GET https://[service name].search.windows.net/indexes/[index name]/docs/$count?api-version=[api-version]  
  Content-Type: application/json   
  api-key: [admin or query key]    

URI ParametreleriURI Parameters

ParametreParameter AçıklamaDescription
hizmet adıservice name Gereklidir.Required. Bunu, arama hizmetinizin benzersiz, Kullanıcı tanımlı adı olarak ayarlayın.Set this to the unique, user-defined name of your search service.
Dizin adıindex name Gereklidir.Required. [index name]İstek URI 'si, hizmete belirtilen dizinin docs koleksiyonundaki tüm öğelerin sayısını döndürmesini söyler.The [index name] in the request URI tells the service to return a count of all items in the docs collection of the specified index.
api-sürümüapi-version Gereklidir.Required. Geçerli sürüm uygulamasının başlıca yeni özelliklerini ve yeteneklerini özetler.The current version is api-version=2020-06-30. Kullanılabilir sürümlerin bir listesi için bkz. Azure bilişsel arama 'Da API sürümleri .See API versions in Azure Cognitive Search for a list of available versions.

İstek Üst BilgileriRequest Headers

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üstbilgileri açıklanmaktadır.The following table describes the required and optional request headers.

AlanlarFields AçıklamaDescription
İçerik TürüContent-Type Gereklidir.Required. Bunu olarak ayarlaapplication/jsonSet this to application/json
api anahtarıapi-key Gereklidir.Required. API anahtarı, arama hizmetinize yönelik isteğin kimliğini doğrulamak için kullanılır.The api-key is used to authenticate the request to your Search service. Bu, hizmetinize özgü bir dize değeridir.It is a string value, unique to your service. Belge sayısı isteği için bir yönetici anahtarı ya da sorgu anahtarı belirtebilir api-key .The Count Documents request can specify either an admin key or query key for the api-key.

Azure portal API-Key değerini hizmet panonuzdan alabilirsiniz.You can get the api-key value from your service dashboard in the Azure portal. Daha fazla bilgi için bkz. var olan anahtarları bulma.For more information, see Find existing keys.

İstek GövdesiRequest Body

Yok.None.

YanıtResponse

Durum kodu: başarılı bir yanıt için 200 Tamam döndürülür.Status Code: 200 OK is returned for a successful response.

Yanıt gövdesi, sayı değerini düz metin olarak biçimlendirilen bir tamsayı olarak içerir.The response body contains the count value as an integer formatted in plain text.

Ayrıca bkz.See also

Azure Bilişsel Arama REST API 'Leri Azure Cognitive Search REST APIs
Azure Bilişsel Arama (HTTP durum kodları) HTTP status codes (Azure Cognitive Search)
Azure Bilişsel Arama için OData Ifadesi sözdizimi OData Expression Syntax for Azure Cognitive Search
Azure Bilişsel Arama API sürümleriAPI versions in Azure Cognitive Search
Arama sonuçları sayfasıSearch results page