Skip to main content

avn service acl

Full list of commands for avn service acl.

Manage Aiven ACL​

The avn service acl command manages access control lists (ACLs) in Aiven for Apache Kafka®. ACLs define permissions for accessing topics and controlling user access. They support wildcard patterns (* and ?) for both topics and usernames. Supported permissions are read, write, and readwrite.

avn service acl-add​

Add an Aiven for Apache Kafka® ACL entry.

ParameterInformation
service_nameName of the service
--permissionPermission type: possible values are read, write or readwrite
--topicTopic name pattern: accepts * and ? as wildcard characters
--usernameUsername pattern: accepts * and ? as wildcard characters

Example: Add an ACL for usernames ending with userA to have readwrite access to topics starting with topic2020 in service kafka-doc.

avn service acl-add kafka-doc --username *userA --permission readwrite --topic topic2020*

avn service acl-delete​

Delete an Aiven for Apache Kafka® ACL entry.

ParameterInformation
service_nameName of the service
acl_idID of the ACL to delete

Example: Delete the ACL with ID acl3604f96c74a from the Aiven for Apache Kafka service kafka-doc.

avn service acl-delete kafka-doc acl3604f96c74a

avn service acl-list​

List Aiven for Apache Kafka® ACL entries.

ParameterInformation
service_nameName of the service

Example: List ACLs defined for service kafka-doc.

avn service acl-list kafka-doc

Example output of avn service acl-list:

ID              USERNAME  TOPIC      PERMISSION
============== ======== ========= ==========
default * * admin
acl3604f96c74a Jon orders readwrite
acl3604fa706cb Frida invoices* write

For managing Kafka-native ACLs, see avn service kafka-acl.