List ACLs

GET 
/kafka/v3/clusters/:cluster_id/acls

• When calling /acls without the principal parameter, service accounts are returned in numeric ID format (e.g., User:12345).
• To retrieve service accounts in the sa-xxx format, use /acls?principal=UserV2:*.
• The principal parameter supports both legacy User: format and new UserV2: format for service accounts. Return a list of ACLs that match the search criteria.

Request

Responses

200

The list of ACLs.

400

Indicates a bad request error. It could be caused by an unexpected request body format or other forms of request validation failure.

401

Indicates a client authentication error. Kafka authentication failures will contain error code 40101 in the response body.

403

Indicates a client authorization error. Kafka authorization failures will contain error code 40301 in the response body.

429

Indicates that a rate limit threshold has been reached, and the client should retry again later.

5XX

A server-side problem that might not be addressable from the client side. Retriable Kafka errors will contain error code 50003 in the response body.