
Core Plugins and tasks Get
CertifiedRead a key-value entry.
Core Plugins and tasks Get
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.
type: io.kestra.plugin.core.kv.GetExamples
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')}}.
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
key *Requiredstring
The key for which to get the value
errorOnMissing booleanstring
falseFlag specifying whether to fail if there is no value for the given key
namespace string
{{ flow.namespace }}The namespace from which to retrieve the KV pair
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
Outputs
value object
Value retrieved for the key
This can be of any type and will stay the same as when it was set.