OpenSearch Put

OpenSearch Put

Certified

Index a single OpenSearch document

Writes one document with optional custom id, opType, routing, and refresh policy; accepts JSON string or Map payload.

yaml
type: io.kestra.plugin.opensearch.Put

Put a document with a Map.

yaml
id: opensearch_put
namespace: company.team

tasks:
  - id: put
    type: io.kestra.plugin.opensearch.Put
    connection:
      hosts:
        - "http://localhost:9200"
    index: "my_index"
    key: "my_id"
    value:
      name: "John Doe"
      city: "Paris"

Put a document from a JSON string.

yaml
id: opensearch_put
namespace: company.team

inputs:
  - id: value
    type: JSON
    defaults: {"name": "John Doe", "city": "Paris"}

tasks:
  - id: put
    type: io.kestra.plugin.opensearch.Put
    connection:
      hosts:
        - "http://localhost:9200"
    index: "my_index"
    key: "my_id"
    value: "{{ inputs.value }}"
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.

Target OpenSearch index

DefaultJSON
Possible Values
CBORJSONSMILEYAML

Payload content type

Format used when value is a string; defaults to JSON.

Document id

Possible Values
INDEXCREATEUPDATEDELETE

Operation type

INDEX or CREATE are supported; others are rejected.

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

DefaultNONE
Possible Values
IMMEDIATEWAIT_UNTILNONE

Refresh policy

IMMEDIATE forces refresh, WAIT_UNTIL waits for refresh, NONE (default) leaves refresh to cluster.

Shard routing key

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

Document body

String rendered then parsed using contentType, or a Map rendered and sent as JSON.

Document id written

Possible Values
CreatedDeletedNoOpNotFoundUpdated

Result of the write

Document version

More Plugins in this Category

Liquibase
Liquibase

Tasks that run Liquibase change management commands.

Data

2 tasks

6 blueprints

PostgreSQL
PostgreSQL

Tasks that connect to PostgreSQL via JDBC to run queries and loads.

Data

6 tasks

25 blueprints