v50

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-0193273218.8 KB
Redpanda ACLs

List ACLs

List all ACLs. The filter. query string parameters find matching ACLs that meet all specified conditions.

get/v1/acls

Query parameters

filter.resource_type'RESOURCE_TYPE_ANY' | 'RESOURCE_TYPE_TOPIC' | 'RESOURCE_TYPE_GROUP' | 'RESOURCE_TYPE_CLUSTER' | 'RESOURCE_TYPE_TRANSACTIONAL_ID' | 'RESOURCE_TYPE_DELEGATION_TOKEN' | 'RESOURCE_TYPE_USER' | 'RESOURCE_TYPE_REGISTRY' | 'RESOURCE_TYPE_SUBJECT'

The type of resource (topic, consumer group, etc.) this ACL targets.

filter.resource_namestring

The name of the resource this ACL targets.

filter.resource_pattern_type'RESOURCE_PATTERN_TYPE_ANY' | 'RESOURCE_PATTERN_TYPE_MATCH' | 'RESOURCE_PATTERN_TYPE_LITERAL' | 'RESOURCE_PATTERN_TYPE_PREFIXED'

The pattern to use for matching the specified resource_name (any, exact match, literal, or prefixed).

filter.principalstring

The user for whom this ACL applies. With the Kafka simple authorizer, you must include the prefix "User:" with the user name.

filter.hoststring

The host address to use for this ACL. To allow a principal access from multiple hosts, you must create an ACL for each host.

filter.operation'OPERATION_ANY' | 'OPERATION_ALL' | 'OPERATION_READ' | 'OPERATION_WRITE' | 'OPERATION_CREATE' | 'OPERATION_DELETE' | 'OPERATION_ALTER' | 'OPERATION_DESCRIBE' | 'OPERATION_CLUSTER_ACTION' | 'OPERATION_DESCRIBE_CONFIGS' | 'OPERATION_ALTER_CONFIGS' | 'OPERATION_IDEMPOTENT_WRITE' | 'OPERATION_CREATE_TOKENS' | 'OPERATION_DESCRIBE_TOKENS'

The operation that is allowed or denied (e.g. READ).

filter.permission_type'PERMISSION_TYPE_ANY' | 'PERMISSION_TYPE_DENY' | 'PERMISSION_TYPE_ALLOW'

Whether the operation should be allowed or denied.

Response

OK