Elasticsearch
Buscar, indexar y gestionar datos en Elasticsearch
Configuración
Búsqueda
Operación
Buscar
Tipo de implementación
Autohospedado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Enter username
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
Consulta de búsqueda
json
{ "match": { "field": "search term" } }
Número de resultados
10
Desplazamiento
0
Ordenación
json
[{ "field": { "order": "asc" } }]
Campos a incluir
field1, field2 (comma-separated)
Campos a excluir
field1, field2 (comma-separated)
Búsqueda (
elasticsearch_search)Busca documentos en Elasticsearch mediante Query DSL. Devuelve los documentos coincidentes con puntuaciones y metadatos.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de despliegue: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para despliegues en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice que se va a buscar |
query | string | No | Query DSL como cadena JSON |
from | number | No | Desplazamiento inicial para la paginación (predeterminado: 0) |
size | number | No | Número de resultados que se devolverán (predeterminado: 10) |
sort | string | No | Especificación de ordenación como cadena JSON |
sourceIncludes | string | No | Lista de campos separados por comas que se incluirán en _source |
sourceExcludes | string | No | Lista de campos separados por comas que se excluirán de _source |
trackTotalHits | boolean | No | Rastrear el recuento total exacto de coincidencias (predeterminado: true) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
took | number | Tiempo en milisegundos que tardó la búsqueda |
timed_out | boolean | Indica si la búsqueda agotó el tiempo de espera |
hits | object | Resultados de búsqueda con recuento total y documentos coincidentes |
aggregations | json | Resultados de agregación, si los hay |
Indexar documento
Operación
Indexar documento
Tipo de implementación
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
API Key
API Key
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Introduce el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
ID del documento
Dejar vacío para ID generado automáticamente
Documento*
json
{ "field": "value", "another_field": 123 }
Actualización
Predeterminado
Indexar documento (
elasticsearch_index_document)Indexar (crear o actualizar) un documento en Elasticsearch.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de implementación: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para implementaciones en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice de destino |
documentId | string | No | ID del documento (generado automáticamente si no se proporciona) |
document | string | Sí | Cuerpo del documento como cadena JSON |
refresh | string | No | Política de actualización: true, false o wait_for |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
_index | string | Índice donde se almacenó el documento |
_id | string | ID del documento |
_version | number | Versión del documento |
result | string | Resultado de la operación (creado o actualizado) |
Obtener documento
Operación
Obtener documento
Tipo de implementación
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Introduce el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
ID del documento*
unique-document-id
Campos a incluir
campo1, campo2 (separados por comas)
Campos a excluir
campo1, campo2 (separados por comas)
Obtener documento (
elasticsearch_get_document)Recuperar un documento por ID de Elasticsearch.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de implementación: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para implementaciones en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice |
documentId | string | Sí | ID del documento a recuperar |
sourceIncludes | string | No | Lista de campos a incluir separados por comas |
sourceExcludes | string | No | Lista de campos a excluir separados por comas |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
_index | string | Nombre del índice |
_id | string | ID del documento |
_version | number | Versión del documento |
found | boolean | Si se encontró el documento |
_source | json | Contenido del documento |
Actualizar documento
Operación
Actualizar documento
Tipo de implementación
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Ingresa el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
ID del documento*
unique-document-id
Documento parcial*
json
{ "field_to_update": "new_value" }
Reintentar en conflicto
3
Actualizar documento (
elasticsearch_update_document)Actualiza parcialmente un documento en Elasticsearch mediante la combinación de documentos.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de despliegue: self_hosted o cloud |
host | string | No | URL de host de Elasticsearch (para autoalojado) |
cloudId | string | No | ID de Elastic Cloud (para despliegues en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice |
documentId | string | Sí | ID del documento a actualizar |
document | string | Sí | Documento parcial a fusionar como cadena JSON |
retryOnConflict | number | No | Número de reintentos en conflicto de versión |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
_index | string | Nombre del índice |
_id | string | ID del documento |
_version | number | Nueva versión del documento |
result | string | Resultado de la operación (actualizado o noop) |
Eliminar documento
Operación
Eliminar documento
Tipo de despliegue
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Introduce el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
ID del documento*
unique-document-id
Actualizar
Predeterminado
Eliminar documento (
elasticsearch_delete_document)Eliminar un documento de Elasticsearch por ID.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de despliegue: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para despliegues en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice |
documentId | string | Sí | ID del documento a eliminar |
refresh | string | No | Política de actualización: true, false o wait_for |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
_index | string | Nombre del índice |
_id | string | ID del documento |
_version | number | Versión del documento |
result | string | Resultado de la operación (deleted o not_found) |
Operaciones masivas
Operación
Operaciones masivas
Tipo de despliegue
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Ingresa el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
mi-índice
Operaciones masivas*
json
{ "index": { "_index": "my-index", "_id": "1" } }
{ "field": "value" }
{ "delete": { "_index": "my-index", "_id": "2" } }
Actualizar
Predeterminado
Operaciones masivas (
elasticsearch_bulk)Realiza múltiples operaciones de indexación, creación, eliminación o actualización en una sola solicitud para un alto rendimiento.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de despliegue: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para despliegues en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | No | Índice predeterminado para operaciones que no especifican uno |
operations | string | Sí | Operaciones masivas como cadena NDJSON (JSON delimitado por saltos de línea) |
refresh | string | No | Política de actualización: true, false o wait_for |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
took | number | Tiempo en milisegundos que tardó la operación masiva |
errors | boolean | Indica si alguna operación tuvo un error |
items | array | Resultados para cada operación |
Contar documentos
Operación
Contar documentos
Tipo de despliegue
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Introduce el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
Consulta
json
{ "match": { "field": "value" } }
Contar documentos (
elasticsearch_count)Cuenta documentos que coinciden con una consulta en Elasticsearch.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de implementación: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para implementaciones en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice para contar documentos |
query | string | No | Consulta opcional para filtrar documentos (cadena JSON) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
count | number | Número de documentos que coinciden con la consulta |
_shards | object | Estadísticas de shard |
Crear índice
Operación
Crear índice
Tipo de implementación
Autohospedado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Introduce el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
Configuración del índice
json
{ "number_of_shards": 1, "number_of_replicas": 1 }
Mapeos del índice
json
{ "properties": { "field": { "type": "text" } } }
Crear índice (
elasticsearch_create_index)Crea un nuevo índice con configuraciones y mapeos opcionales.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de despliegue: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para despliegues en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice a crear |
settings | string | No | Configuraciones del índice como cadena JSON |
mappings | string | No | Mapeos del índice como cadena JSON |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
acknowledged | boolean | Si la solicitud fue reconocida |
shards_acknowledged | boolean | Si los fragmentos fueron reconocidos |
index | string | Nombre del índice creado |
Eliminar índice
Operación
Eliminar índice
Tipo de despliegue
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Ingrese el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
Eliminar índice (
elasticsearch_delete_index)Elimina un índice y todos sus documentos. Esta operación es irreversible.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de despliegue: self_hosted o cloud |
host | string | No | URL de host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para despliegues en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice a eliminar |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
acknowledged | boolean | Si la eliminación fue confirmada |
Obtener información del índice
Operación
Obtener información del índice
Tipo de despliegue
Autoalojado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Ingresa el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Nombre del índice*
my-index
Obtener información del índice (
elasticsearch_get_index)Recupera información del índice, incluida la configuración, las asignaciones y los alias.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de implementación: self_hosted o cloud |
host | string | No | URL de host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para implementaciones en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
index | string | Sí | Nombre del índice para obtener información |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
index | json | Información del índice, incluidos alias, asignaciones y configuración |
Salud del clúster
Operación
Salud del clúster
Tipo de implementación
Autohospedado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Ingresa el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Esperar estado
Ninguno
Tiempo de espera (segundos)
30
Estado del clúster (
elasticsearch_cluster_health)Obtiene el estado de salud del clúster de Elasticsearch.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de implementación: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para implementaciones en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
waitForStatus | string | No | Esperar hasta que el clúster alcance este estado: verde, amarillo o rojo |
timeout | string | No | Tiempo de espera para la operación de espera (p. ej., 30s, 1m) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
cluster_name | string | Nombre del clúster |
status | string | Estado de salud del clúster: verde, amarillo o rojo |
number_of_nodes | number | Número total de nodos en el clúster |
number_of_data_nodes | number | Número de nodos de datos |
active_shards | number | Número de shards activos |
unassigned_shards | number | Número de shards no asignados |
Estadísticas del clúster
Operación
Estadísticas del clúster
Tipo de despliegue
Autohospedado
Host de Elasticsearch
https://localhost:9200
Se muestra cuando deploymentType es 'self_hosted'.
ID de Cloud
deployment-name:base64-encoded-data
Se muestra cuando deploymentType es 'cloud'.
Método de autenticación
Clave de API
Clave de API
••••••••
Se muestra cuando authMethod es 'api_key'.
Nombre de usuario
Introduce el nombre de usuario
Se muestra cuando authMethod es 'basic_auth'.
Contraseña
••••••••
Se muestra cuando authMethod es 'basic_auth'.
Estadísticas del clúster (
elasticsearch_cluster_stats)Obtén estadísticas completas sobre el clúster de Elasticsearch.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
deploymentType | string | Sí | Tipo de despliegue: self_hosted o cloud |
host | string | No | URL del host de Elasticsearch (para self-hosted) |
cloudId | string | No | ID de Elastic Cloud (para despliegues en la nube) |
authMethod | string | Sí | Método de autenticación: api_key o basic_auth |
apiKey | string | No | Clave de API de Elasticsearch |
username | string | No | Nombre de usuario para autenticación básica |
password | string | No | Contraseña para autenticación básica |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
cluster_name | string | Nombre del clúster |
status | string | Estado de salud del clúster |
nodes | object | Estadísticas de nodos, incluidos recuento y versiones |
indices | object | Estadísticas de índices, incluidos recuento de documentos y tamaño de almacenamiento |
Instrucciones de uso
Integra Elasticsearch en flujos de trabajo para búsqueda potente, indexación y gestión de datos. Admite operaciones CRUD de documentos, consultas de búsqueda avanzada, operaciones masivas, gestión de índices y supervisión de clústeres. Funciona con despliegues self-hosted y Elastic Cloud.
Notas
- Categoría:
tools - Tipo:
elasticsearch