
Core Plugins and tasks PurgeKV
CertifiedPurge keys from the KV store.
Core Plugins and tasks PurgeKV
Purge keys from the KV store.
Deletes keys across Namespaces using a purge behavior (default: expired-only). Filter by explicit namespaces or namespacePattern, optional keyPattern, and include/exclude child namespaces.
Deprecated expiredOnly overrides behavior if set.
type: io.kestra.plugin.core.kv.PurgeKVExamples
Delete expired keys globally for a specific namespace, with or without including child namespaces.
id: purge_kv_store
namespace: system
tasks:
- id: purge_kv
type: io.kestra.plugin.core.kv.PurgeKV
expiredOnly: true
namespaces:
- company
includeChildNamespaces: true
Properties
behavior string
{"type":"key","expiredOnly":true}Purge behavior
Defines how keys are purged.
io.kestra.plugin.core.kv.KvPurgeBehavior
includeChildNamespaces booleanstring
trueDelete keys from child namespaces
Defaults to true. This means that if you set namespaces to company, it will also delete keys from company.team, company.data, etc.
keyPattern string
Key pattern, e.g. 'AI_*'
Delete only keys matching the glob pattern.
namespacePattern string
Glob pattern for the namespaces to delete keys from
If not set (e.g., AI_*), all namespaces will be considered. Can't be used with namespaces - use one or the other.
namespaces array
List of namespaces to delete keys from
If not set, all namespaces will be considered. Can't be used with namespacePattern - use one or the other.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
Outputs
size integer
The number of purged KV pairs