liveBook · Manning

Administrative API

As explained in Kafka for Architects

The Kafka Admin API is Kafka's programmatic interface for inspecting and modifying administrative resources and cluster configuration.

An administrative API turns Kafka cluster management into repeatable programmatic operations instead of ad hoc scripts or manual console changes. It supports the governance needed when multiple teams share topics, schemas, access policies, and infrastructure across environments. section 10.0 section 10.2.3

Use the Kafka Admin Client API to manage:

  • Topics: create, modify, and delete them; adjust partitions, replication factors, and retention settings. section 10.2.3
  • Broker configuration: update settings dynamically as operational requirements change. section 10.2.3
  • Access control: manage ACLs that enforce security policies. section 10.2.3
  • Consumer groups: inspect offsets and reset them when recovery or operational intervention requires it. section 10.2.3

A GitOps-managed Kafka environment

A platform team can represent topics, partitions, retention, replication, and ACLs as approved environment configuration, then use the administrative API to apply consistent changes across environments. The API does not replace governance: it makes approved infrastructure changes repeatable and auditable rather than dependent on quick setup scripts. section 10.0 section 10.2.3

Figure 9.1 Controllers operate as a quorum, responsible for storing metadata and monitoring cluster health.
A diagram of a system

AI-generated content may be incorrect.

Trace how an admin client request reaches brokers and the leader controller, which updates replicated cluster metadata and maintains cluster state. section 9.1

How Kafka for Architects covers it

How deep it goes
Defines administrative operations and request flow through brokers and controllers, but stops short of implementation walkthroughs.
Examples
Uses topic changes, ACL management, offset resets, dynamic broker configuration, and controller metadata updates as concrete operations.
What it assumes
Assumes familiarity with Kafka clusters, topics, partitions, ACLs, consumer groups, and environment management.
What you can do after
Operate/configure Kafka resources consistently through automation rather than manual setup or ad hoc scripts.
How it connects
Connects topics, broker configuration, ACLs, consumer groups, GitOps, controllers, and cluster metadata.

Also explained in

Compare how 2 books explain administrative API →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Kafka for Architects. The section links point to the parts of the book it draws on.