Core Plugins and tasks Get

Core Plugins and tasks Get

Certified

Read a key-value entry.

Renders key/namespace (defaults to flow namespace) and fetches the value. In the same namespace it walks dot-delimited parents to support hierarchical lookup. Set errorOnMissing to true to fail when absent.

Respects namespace ACLs when reading other namespaces.

yaml
type: io.kestra.plugin.core.kv.Get

Get value for my_variable key in dev namespace and fail if it's not present. Note that you can accomplish the same using the kv() Pebble function, e.g. {{kv('my_variable')}}.

yaml
id: kv_store_get
namespace: company.team

tasks:
  - id: kv_get
    type: io.kestra.plugin.core.kv.Get
    key: my_variable
    namespace: company # the current namespace is used by default
    errorOnMissing: true
Properties

The key for which to get the value

Defaultfalse

Flag specifying whether to fail if there is no value for the given key

Default{{ flow.namespace }}

The namespace from which to retrieve the KV pair

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

Value retrieved for the key

This can be of any type and will stay the same as when it was set.