Apache Kafka AclDelete

Apache Kafka AclDelete

Certified

Delete Kafka ACLs matching a filter

Deletes every ACL matching the given filter using the Kafka AdminClient. This operation is destructive and cannot be undone. Unset filter fields match any value, so a filter with nothing set would match every ACL on the cluster — this task refuses to run in that case unless deleteAll is set to true.

yaml
type: io.kestra.plugin.kafka.AclDelete

Revoke every ACL granted to a decommissioned tenant service account

yaml
id: kafka_acl_delete
namespace: company.team

tasks:
  - id: delete_acls
    type: io.kestra.plugin.kafka.AclDelete
    properties:
      bootstrap.servers: localhost:9092
    principal: "User:tenant-acme-svc"
Properties

Kafka AdminClient properties

Must include bootstrap.servers; accepts any Kafka AdminClient config. Provide base64-encoded content for ssl.keystore.location and ssl.truststore.location when using SSL.

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.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset 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.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
DefaultPT30S

AdminClient call timeout

Maximum duration to wait for each AdminClient operation to complete before failing the task. Defaults to PT30S (30 seconds). Distinct from the task-level timeout, which lets the worker kill the task without retrying it.

Defaultfalse

Confirm deleting every ACL on the cluster

Required opt-in when every filter field is unset (or renders empty), which would otherwise match — and delete — every ACL on the cluster. Defaults to false.

Host filter

Matches any host when unset.

Possible Values
ALLREADWRITECREATEDELETEALTERDESCRIBECLUSTER_ACTIONDESCRIBE_CONFIGSALTER_CONFIGSIDEMPOTENT_WRITE

Operation filter

Matches any operation when unset.

Possible Values
LITERALPREFIXEDMATCH

Resource pattern type filter

Matches any pattern type when unset.

Possible Values
ALLOWDENY

Permission type filter

Matches any permission type when unset.

Principal filter

For example User: alice. Matches any principal when unset.

Resource name filter

Matches any resource name when unset.

Possible Values
TOPICGROUPCLUSTERTRANSACTIONAL_IDDELEGATION_TOKENUSER

Resource type filter

Matches any resource type when unset.

SubTypeobject

Deleted ACLs

Each entry contains resourceType, resourceName, patternType, principal, host, operation and permissionType.