PurgeFilesPurgeFiles
PurgeFilesCertified

Purge namespace files for one or multiple namespaces.

Purge namespace files for one or multiple namespaces.

This task purges namespace files (and their versions) stored in Kestra. You can restrict the purge to specific namespaces (or a namespace glob pattern), optionally include child namespaces, and filter files by a glob pattern. The purge strategy is controlled via behavior (e.g. keep the last N versions and/or delete versions older than a given date).

yaml
type: "io.kestra.plugin.core.namespace.PurgeFiles"

Purge old versions of namespace files for a namespace tree.

yaml
id: purge_namespace_files
namespace: system

tasks:
  - id: purge_files
    type: io.kestra.plugin.core.namespace.PurgeFiles
    namespaces:
      - company
    includeChildNamespaces: true
    filePattern: "**/*.sql"
    behavior:
      type: version
      before: "2025-01-01T00:00:00Z"
Properties
Default{"type":"version","keepAmount":1}

Purge behavior

Defines how files are purged.

Definitions

File pattern, e.g. 'AI_*'

Delete only files whose path is matching the glob pattern.

Defaulttrue

Delete files from child namespaces

Defaults to true. This means that if you set namespaces to company, it will also delete files from company.team, company.data, etc.

Glob pattern for the namespaces to delete files from

If not set (e.g., AI_*), all namespaces will be considered. Can't be used with namespaces - use one or the other.

SubTypestring

List of namespaces to delete files from

If not set, all namespaces will be considered. Can't be used with namespacePattern - use one or the other.

The number of purged namespace file versions