Obtener estadísticas de servicio (API REST de versión preliminar)
se aplica a: 2023-07-01-Preview. Esta versión ya no se admite. Actualizar inmediatamente a una versión más reciente.
Importante
2023-07-01-Preview agrega vectorIndexSize ámbito a un servicio de búsqueda.
2021-04-30-Preview agrega aliasesCount.
La operación estadísticas del servicio
Las estadísticas sobre el número de documentos y el tamaño de almacenamiento se recopilan cada pocos minutos, no en tiempo real. Por lo tanto, es posible que las estadísticas devueltas por esta API no reflejen los cambios causados por las operaciones de indexación recientes.
GET https://[service name].search.windows.net/servicestats?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Parámetros de URI
| Parámetro | Descripción |
|---|---|
| nombre del servicio | Obligatorio. Establezca este valor en el nombre único definido por el usuario del servicio de búsqueda. El URI de solicitud especifica el nombre del índice para el que se deben devolver las estadísticas. |
| api-version | Obligatorio. Consulte versiones de API para obtener más versiones. |
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales.
| Campos | Descripción |
|---|---|
| Tipo de contenido | Obligatorio. Establezca este valor en application/json |
| api-key | Opcional si usa roles de Azure y se proporciona un token de portador en la solicitud; de lo contrario, se requiere una clave. Una clave de API es una cadena única generada por el sistema que autentica la solicitud en el servicio de búsqueda. Obtener solicitudes en el servicio de búsqueda debe incluir un encabezado api-key establecido en la clave de administrador (en lugar de una clave de consulta). Consulte Conexión a Azure AI Search mediante la autenticación de claves para más información. |
Cuerpo de la solicitud
Ninguno.
Respuesta
Código de estado: se devuelve "200 OK" para obtener una respuesta correcta. El cuerpo de la respuesta tiene el formato siguiente:
{
"counters": {
"documentCount": {
"usage": number,
"quota": number | null (if the service has unlimited document counts, the quota will be null)
},
"indexesCount": {
"usage": number,
"quota": number
},
"indexersCount": {
"usage": number,
"quota": number
},
"dataSourcesCount": {
"usage": number,
"quota": number
},
"storageSize": {
"usage": number (bytes),
"quota": number (bytes)
},
"synonymMaps": {
"usage": number,
"quota": number
},
"aliasesCount": {
"usage": number,
"quota": number
},
"vectorIndexSize": {
"usage": number (bytes),
"quota": number (bytes)
}
},
"limits": {
"maxFieldsPerIndex": number,
"maxIndexerRunTime": string,
"maxFileExtractionSize": number,
"maxFileContentCharactersToExtract": number,
"maxFieldNestingDepthPerIndex": number,
"maxComplexCollectionFieldsPerIndex": number,
"maxComplexObjectsInCollectionsPerDocument": number
}
}
| Estadística | Tipo | Descripción |
|---|---|---|
| documentCount | Contar | Agregación de todos los documentos de todos los índices. Las versiones anteriores de Azure AI Search aplican límites de recuento de documentos, pero ese límite ya no existe. La cuota siempre es null que indica que el servicio puede tener recuentos ilimitados de documentos. |
| indexesCount | Contar | Número de índices en el servicio de búsqueda. Los índices máximos varían según el nivel, según lo notificado por la cuota. |
| indexersCount | Contar | Número de indizadores en el servicio de búsqueda. Los indexadores máximos varían según el nivel, según lo notificado por la cuota. |
| dataSourcesCount | Contar | Número de orígenes de datos en el servicio de búsqueda. Los orígenes de datos máximos varían según el nivel, según lo notificado por la cuota. Los orígenes de datos máximos son el mismo número que los indexadores máximos. |
| aliasesCount | Contar | Número de alias de índice en el servicio de búsqueda. El máximo varía según el nivel, según lo notificado por la cuota. |
| synonymMaps | Contar | Número de asignaciones de sinónimos en el servicio de búsqueda. El máximo varía según el nivel, según lo notificado por la cuota. |
| storageSize | Bytes | El uso es la cantidad de almacenamiento que usan todos los objetos del servicio. La cuota es el almacenamiento máximo disponible en función del tamaño y el número de particiones configuradas para el servicio. La cuota aumenta y disminuye en respuesta al número de particiones aprovisionadas en el servicio de búsqueda. El tamaño de la partición varía según el nivel. |
| vectorIndexSize | Bytes | Un índice vectorial es una estructura interna, un índice de vector por campo vectorial tal como se define en un índice de búsqueda. El uso total se notifica en el servicio para que pueda supervisar el consumo de espacio vectorial en relación con el límite de índice de vectores del servicio de búsqueda. La cuota varía según la antigüedad del servicio de búsqueda, el número de particiones y el tamaño de las particiones según lo determine el nivel. |
Para obtener más información sobre todos los límites, consulte Límites de servicio .
Ejemplos
Esta API es el plano de datos. Para obtener más información sobre un servicio, como el nivel o la ubicación, consulte la API rest de administración de .
{
"@odata.context": "https://my-search-service.search.windows.net/$metadata#Microsoft.Azure.Search.V2019_05_06.ServiceStatistics",
"counters": {
"documentCount": {
"usage": 5072,
"quota": null
},
"indexesCount": {
"usage": 10,
"quota": 15
},
"indexersCount": {
"usage": 8,
"quota": 15
},
"dataSourcesCount": {
"usage": 9,
"quota": 15
},
"storageSize": {
"usage": 22265221,
"quota": 2147483648
},
"synonymMaps": {
"usage": 0,
"quota": 3
},
"aliasesCount": {
"usage": 7,
"quota": 30
},
"vectorIndexSize": {
"usage": 1342476,
"quota": 1073741824
},
"limits": {
"maxFieldsPerIndex": 1000,
"maxIndexerRunTime": "P1D",
"maxFileExtractionSize": 16777216,
"maxFileContentCharactersToExtract": 65536,
"maxFieldNestingDepthPerIndex": 10,
"maxComplexCollectionFieldsPerIndex": 40,
"maxComplexObjectsInCollectionsPerDocument": 3000
}
}