# Announcing Integrated Apache Kafka® Topic and ACL Management via the Instaclustr Provisioning API and Terraform Provider

[Blog](/blog/)&gt;[Technology](/blog/category/technical/)&gt;Announcing Integrated Apache Kafka® Topic and ACL Management via the Instaclustr Provisioning API and Terraform Provider 

Announcing Integrated Apache Kafka® Topic and ACL Management via the Instaclustr Provisioning API and Terraform Provider
========================================================================================================================

December 01, 2021 | By [ Varun Ghai](https://www.instaclustr.com/blog/author/varun-ghai/)

 

 

 

 



   [ ](https://x.com/intent/tweet?text=Announcing%20Integrated%20Apache%20Kafka%C2%AE%20Topic%20and%20ACL%20Management%20via%20the%20Instaclustr%20Provisioning%20API%20and%20Terraform%20Provider&url=https://www.instaclustr.com/blog/integrated-apache-kafka-topic-and-acl-management-via-the-instaclustr-provisioning-api-and-terraform-provider/) [ ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.instaclustr.com/blog/integrated-apache-kafka-topic-and-acl-management-via-the-instaclustr-provisioning-api-and-terraform-provider/&title=&summary=Announcing%20Integrated%20Apache%20Kafka%C2%AE%20Topic%20and%20ACL%20Management%20via%20the%20Instaclustr%20Provisioning%20API%20and%20Terraform%20Provider&source=) 

Instaclustr is pleased to announce the general availability of extensions to our provisioning APIs and Terraform Provider to allow Apache Kafka® topic configuration and ACL management.

**What Is Apache Kafka Topic Management and ACL Management?**

Topics are the core piece of application configuration for any Apache Kafka usage. Topic management includes operations such as accessing and modifying topics’ configurations, deleting topics, and creating new ones.

ACLs (Access Controls Lists) are how Kafka manages granting and restricting access to Kafka topics. ACL management refers to the set of operations that can be performed for managing ACLs**\*** in Kafka such as creating and deleting ACLs, and listing all existing ACLs.

**What’s New With These Changes?**

Currently, when provisioning clusters, customers wanting to manage topics have to switch from using the provisioning APIs (for spinning up the Kafka cluster) to using the kafka-topics.sh or ic-kafka-topics tools (to create topics). The new changes introduce extensions to existing functionality in the provisioning APIs to allow operations like creating topics to be carried out without having to download, install, and use other tools. The same applies for customers using the Instaclustr Terraform provider, who now have access to additional options to, for example, streamline their CI/CD pipelines. In short, customers will now find it easier to provision and maintain usable Kafka clusters via a single familiar interface that can be scripted from end to end.

**What Topic and ACL Management-related Changes Are Being Introduced?**

The new extensions are:

- For topic management:
    - List all topics
    - Create a topic
    - Delete a topic
    - Get a topic’s replication factor and number of partitions
    - Get a topic’s configuration
    - Modify a topic’s configuration

- For ACL management:
    - List all ACLs
    - Search ACLs
    - Create ACL
    - Delete ACL

All functionality available through these APIs is also available via our Terraform provider. To learn more about the Instaclustr Terraform provider and how to use it, please read further [here](/blog/what-is-the-instaclustr-terraform-provider/).

**Examples on Using New APIs**

We’ve done our best to make using these APIs simple and straightforward. For example, to create a new topic you would send a POST request to https://api.instaclustr.com/provisioning/v1/{cluster}/kafka/topics (where {cluster} is the IP address of your Kafka cluster), with the following body:































Body { "topic": "test", "partitions": 3, "replicationFactor": 3 }

   1

2

3

4

5

6

7

8

9

10



  Body

{



 "topic": "test",



 "partitions": 3,



 "replicationFactor": 3



}



   

 

 The output from this would be something like the following, indicating that a new topic with the specified name has been created:































{ "message": "Kafka topic test created." }

   1

2

3

4

5



  {



 "message": "Kafka topic test created."



}



   

 

 To achieve the same result using the Instaclustr Terraform provider, the following code would be needed:































resource "instaclustr\_kafka\_topic" "test"{ cluster\_id = xxx topic = "test" replication\_factor = 3 partitions = 3 }

   1

2

3

4

5

6

7

8

9

10

11



  resource "instaclustr\_kafka\_topic" "test"{



 cluster\_id = xxx



 topic = "test"



 replication\_factor = 3



 partitions = 3



}



   

 

 These APIs are available now with Kafka 2.6.1 and later deployments and are in addition to existing methods of topic and ACL management described in our [provisioning API documentation](https://www.instaclustr.com/support/api-integrations/api-reference/cluster-management-api/).

Existing customers who would like further information are encouraged to get in touch with their Customer Success representative or to[ consult our support page](https://www.instaclustr.com/). New customers should [visit this page](/contact-us/) to sign up for a free consultation with one of our experts and welcome to [sign up for a 30-day free trial](https://console2.instaclustr.com/signup) to try out our Managed Kafka offering.

---

##### \*It is recommended that you do not use the Kafka ACLs to grant higher privileges than the default given by Instaclustr. This could result in your cluster being unrecoverable and not covered under Instaclustr’s SLAs. If you have any questions about this, please submit a support request before making any changes beyond those described in our support pages.

Discover the fundamentals of Apache Kafka®

[Free White Paper](https://www.instaclustr.com/resources/understanding-apache-kafka/)

 

 

 

### About the author

**[Varun Ghai](https://www.instaclustr.com/blog/author/varun-ghai/)** | Product Manager

With a keen focus on product management, Varun brings a wealth of experience and expertise to the team, driving innovation and excellence in the company's Apache Kafka offering.

 

 [ Add Instaclustr as a preferred source on Google ](https://google.com/preferences/source?q=instaclustr.com)



 

 ![mail icon]()#### Get the latest articles for open sourceIn your inbox

 <a class="btn btn-primary btn-popup text-dark" href="">Sign up now</a> 

 

 

 

  ### Related content

 [ “Kongo” Part 1: Apache Kafka®—IoT Logistics Streaming Demo Application 

 

 We picked logistics as the problem domain for Kongo: Instaclustr's IoT streaming application dealing with large scale logistics... 

 

 

 

 

 

 

 ](https://www.instaclustr.com/blog/instaclustr-kongo-iot-logistics-streaming-demo-application/) 

 [ Apache Kafka MirrorMaker 2 (MM2) Part 1: Theory 

 

 This blog focuses on Kafka MirrorMaker 2 theory (Kafka replication, architecture, components and terminology) and invent some MM2 ... 

 

 

 

 

 

 

 ](https://www.instaclustr.com/blog/kafka-mirrormaker-2-theory/) 

 [ Apache Kafka: Architecture, deployment and ecosystem [2026 guide] 

 

 Apache Kafka is an open-source distributed event-streaming platform for real-time data pipelines and applications, now running ... 

 

 

 

 

 

 

 ](https://www.instaclustr.com/education/apache-kafka/) 

 

  <a class="close-modal" href="">×</a>Sign upto ourNewsletter
-----------------------
