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 *string
The key for which to get the value
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150errorOnMissing 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
Outputs
value object
Value retrieved for the key
This can be of any type and will stay the same as when it was set.
