
OpenSearch Load
CertifiedBulk load records from Internal Storage
OpenSearch Load
Bulk load records from Internal Storage
Reads line-delimited JSON/ION from Kestra internal storage and indexes documents in batches.
type: io.kestra.plugin.opensearch.LoadExamples
id: opensearch_load
namespace: company.team
inputs:
- id: file
type: FILE
tasks:
- id: load
type: io.kestra.plugin.opensearch.Load
connection:
hosts:
- "http://localhost:9200"
from: "{{ inputs.file }}"
index: "my_index"
Properties
connection *RequiredNon-dynamic
Configure OpenSearch connection
Hosts, auth headers, and TLS options reused by every task invocation.
io.kestra.plugin.opensearch.OpensearchConnection
OpenSearch HTTP endpoints
One or more host URLs with scheme and port, e.g. https://opensearch.com: 9200; all are used for load-balancing/failover.
Basic auth configuration
io.kestra.plugin.opensearch.OpensearchConnection-BasicAuth
Basic auth password
Basic auth username
Additional HTTP headers
Each entry is Key: Value, e.g. Authorization: Token XYZ; rendered per request.
Path prefix for every request
Prepends /my/path to all endpoints when OpenSearch is behind a proxy enforcing a base path; leave unset otherwise.
Fail on warning headers
If true, any response containing an OpenSearch warning header is treated as a failure; defaults to server/client behavior.
Trust all SSL certificates
INSECURE — disables TLS certificate and hostname verification entirely, allowing man-in-the-middle attacks. Must never be used against production clusters or over untrusted networks. Prefer supplying a trusted CA certificate/trust store instead.
from *Requiredstring
Source file in Internal Storage
Path to Kestra internal storage object containing line-delimited JSON or ION records.
Pebble expression referencing an Internal Storage URI e.g. {{ outputs.mytask.uri }}.
index *Requiredstring
Target OpenSearch index
chunk integerstring
1000Bulk chunk size
Number of operations per bulk request; defaults to 1000.
idKey string
Field to use as document id
If set, uses this field value as _id; field is removed when removeIdKey is true.
opType string
INDEXCREATEUPDATEDELETEBulk operation type
Indexing op type; INDEX/CREATE supported, others rejected by client.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
removeIdKey booleanstring
trueRemove idKey from document
Defaults to true; keep the id field in the document by setting to false.
routing string
Shard routing key
Hashes routing using this value instead of the document id to colocate related records.
Outputs
size integer
Number of records sent