Core Plugins and tasks PurgeFiles

Core Plugins and tasks PurgeFiles

Certified

Purge Namespace files (and versions).

Deletes files from Namespace storage using a purge behavior (default keeps 1 latest version), optional file glob, and Namespace filters (namespaces list or namespacePattern). Child Namespaces are included by default.

Use to clean old asset versions at scale; behavior controls retention (keepAmount/before).

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.

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

The number of purged namespace file versions