Kafka Admin API

Go to the Service credentials page and View credentials. To access the Kafka Admin API, use the value for property kafka_admin_url. The Swagger 2.0 docs for the IBM Event Streams Administration REST API is found at https://raw.githubusercontent.com/ibm-messaging/event-streams-docs/master/admin-rest-api/admin-rest-api.yaml. You can load the file via URL import in the http://editor.swagger.io, click File > Import URL > OK. Or read the README for the Admin API at https://github.com/ibm-messaging/event-streams-docs/tree/master/admin-rest-api.

To authenticate add an X-Auth-Token HTTP Header with the apikey found in the service credentials.

List the Kafka topics,

$ curl -X GET \
https://a1bc2d3efg4hijkl.svc01.us-south.eventstreams.cloud.ibm.com/admin/topics \
-H 'X-Auth-Token: 1abCDEFgHi2jKlmnO3pqrsTU4VwXyzaBcdeFgHiJkLmN'
[
{
"name": "greetings",
"partitions": 1,
"replicationFactor": 3,
"retentionMs": 86400000,
"cleanupPolicy": "delete",
"configs": {
"cleanup.policy": "delete",
"min.insync.replicas": "2",
"retention.bytes": "104857600",
"retention.ms": "86400000",
"segment.bytes": "536870912"
},
"replicaAssignments": [
{
"id": 0,
"brokers": {
"replicas": [
0,
1,
2
]
}
}
]
}
]

Delete a topic,

$ curl -X DELETE \
https://a1bc2d3efg4hijkl.svc01.us-south.eventstreams.cloud.ibm.com/admin/topics/greetings \
-H 'X-Auth-Token: 1abCDEFgHi2jKlmnO3pqrsTU4VwXyzaBcdeFgHiJkLmN'

Create a topic,

$ curl -X POST \
https://a1bc2d3efg4hijkl.svc01.us-south.eventstreams.cloud.ibm.com/admin/topics \
-H 'X-Auth-Token: 1abCDEFgHi2jKlmnO3pqrsTU4VwXyzaBcdeFgHiJkLmN' \
-d '{
"name": "greetings",
"partitions": 1
}'

Get a topic,

$ curl -X GET \
https://a1bc2d3efg4hijkl.svc01.us-south.eventstreams.cloud.ibm.com/admin/topics/greetings \
-H 'X-Auth-Token: 1abCDEFgHi2jKlmnO3pqrsTU4VwXyzaBcdeFgHiJkLmN'

Update a topic configuration,

$ curl -X PATCH \
https://a1bc2d3efg4hijkl.svc01.us-south.eventstreams.cloud.ibm.com/admin/topics/greetings \
-H 'X-Auth-Token: 1abCDEFgHi2jKlmnO3pqrsTU4VwXyzaBcdeFgHiJkLmN' \
-d '{
"new_total_partition_count": 1
}'

‚Äč