Conteggio documenti (API REST di Azure ricerca cognitiva)Count Documents (Azure Cognitive Search REST API)

L'operazione count Documents recupera un conteggio del numero di documenti in un indice di ricerca.The Count Documents operation retrieves a count of the number of documents in a search index. La sintassi $count fa parte del protocollo OData.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]    

Parametri dell'URIURI Parameters

ParametroParameter DescrizioneDescription
nome servizioservice name Obbligatorio.Required. Impostare questa impostazione sul nome univoco definito dall'utente del servizio di ricerca.Set this to the unique, user-defined name of your search service.
nome indiceindex name Obbligatorio.Required. L'elemento [index name] nell'URI della richiesta indica al servizio di restituire un conteggio di tutti gli elementi disponibili nella raccolta di documenti dell'indice specificato.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-versionapi-version Obbligatorio.Required. La versione corrente è api-version=2020-06-30.The current version is api-version=2020-06-30. Per un elenco delle versioni disponibili, vedere versioni API in Azure ricerca cognitiva .See API versions in Azure Cognitive Search for a list of available versions.

Intestazioni richiestaRequest Headers

La tabella seguente descrive le intestazioni della richiesta obbligatorie e facoltative.The following table describes the required and optional request headers.

CampiFields DescrizioneDescription
Content-TypeContent-Type Obbligatorio.Required. Impostare il valore su application/jsonSet this to application/json
api-keyapi-key Obbligatorio.Required. La chiave API viene usata per autenticare la richiesta nel servizio di ricerca.The api-key is used to authenticate the request to your Search service. È un valore stringa univoco per il servizio.It is a string value, unique to your service. La richiesta count Documents può specificare una chiave amministratore o una chiave di query per api-key .The Count Documents request can specify either an admin key or query key for the api-key.

È possibile ottenere il valore della chiave API dal dashboard del servizio nel portale di Azure.You can get the api-key value from your service dashboard in the Azure portal. Per ulteriori informazioni, vedere Find existing Keys.For more information, see Find existing keys.

Corpo della richiestaRequest Body

No.None.

RispostaResponse

Se la risposta ha esito positivo, viene restituito il codice di stato 200 OK.Status Code: 200 OK is returned for a successful response.

Il corpo della risposta include il valore count sotto forma di Integer formattato in testo normale.The response body contains the count value as an integer formatted in plain text.

Vedere ancheSee also

API REST di Azure ricerca cognitiva Azure Cognitive Search REST APIs
Codici di stato HTTP (ricerca cognitiva di Azure) HTTP status codes (Azure Cognitive Search)
Sintassi delle espressioni OData per ricerca cognitiva di Azure OData Expression Syntax for Azure Cognitive Search
Versioni API in Azure ricerca cognitivaAPI versions in Azure Cognitive Search
pagina dei risultati della ricercaSearch results page