Ottenere statistiche sugli indici (API REST di Azure ricerca cognitiva)Get Index Statistics (Azure Cognitive Search REST API)

L'operazione Get index Statistics restituisce da Azure ricerca cognitiva un conteggio dei documenti per l'indice corrente e l'utilizzo dell'archiviazione.The Get Index Statistics operation returns from Azure Cognitive Search a document count for the current index, plus storage usage. È anche possibile ottenere queste informazioni dal portale.You can also get this information from the portal.

Nota

Le statistiche sul numero di documenti e le dimensioni vengono raccolte ad intervalli di pochi minuti, non in tempo reale.Statistics on document count and storage size are collected every few minutes, not in real time. Di conseguenza, le statistiche restituite da questa API potrebbero non riflettere le modifiche apportate da operazioni di indicizzazione recenti.Therefore, the statistics returned by this API may not reflect changes caused by recent indexing operations.

GET https://[service name].search.windows.net/indexes/[index name]/stats?api-version=[api-version]  
  Content-Type: application/json  
  api-key: [admin 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'URI della richiesta specifica il nome dell'indice per il quale devono essere restituite le statistiche.The request URI specifies the name of the index for which statistics should be returned.
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. Le richieste Get per le informazioni di sistema devono includere un campo di chiave API impostato sulla chiave amministratore, anziché su una chiave di query.Get requests for system information must include an api-key field set to your admin key (as opposed to a query 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

Il codice di stato "200 OK" viene restituito per una risposta con esito positivo.Status Code: "200 OK" is returned for a successful response. Il corpo della risposta è nel formato seguente:The response body is in the following format:

{  
  "documentCount": number,  
  "storageSize": number (size of the index in bytes)  
}  

Vedere ancheSee also

API REST di Azure ricerca cognitiva Azure Cognitive Search REST APIs
Versioni API in Azure ricerca cognitivaAPI versions in Azure Cognitive Search