OpenSearch Get

OpenSearch Get

Certified

Retrieve a document from OpenSearch

Fetches one document by index and id with optional routing and version match; returns the source map.

yaml
type: io.kestra.plugin.opensearch.Get
yaml
id: opensearch_get
namespace: company.team

tasks:
  - id: get
    type: io.kestra.plugin.opensearch.Get
    connection:
      hosts:
        - "http://localhost:9200"
    index: "my_index"
    key: "my_id"
    docVersion: 1
Properties

Configure OpenSearch connection

Hosts, auth headers, and TLS options reused by every task invocation.

Definitions
hosts*Requiredarray
SubTypestring

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.

basicAuth

Basic auth configuration

passwordstring

Basic auth password

usernamestring

Basic auth username

headersarray
SubTypestring

Additional HTTP headers

Each entry is Key: Value, e.g. Authorization: Token XYZ; rendered per request.

pathPrefixstring

Path prefix for every request

Prepends /my/path to all endpoints when OpenSearch is behind a proxy enforcing a base path; leave unset otherwise.

strictDeprecationModebooleanstring

Fail on warning headers

If true, any response containing an OpenSearch warning header is treated as a failure; defaults to server/client behavior.

trustAllSslbooleanstring

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.

Expected document version

Request fails if the cluster version differs; use for optimistic concurrency.

Target OpenSearch index

Document id

Reference (ref) of the pluginDefaults to apply to this task.

Shard routing key

Hashes routing using this value instead of the document id to colocate related records.

The document retrieved from OpenSearch