Method: projects.locations.clusters.topics.create

Creates a new topic in a given project and location.

HTTP request

POST https://managedkafka.googleapis.com/v1/{parent=projects/*/locations/*/clusters/*}/topics

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent cluster in which to create the topic. Structured like projects/{project}/locations/{location}/clusters/{cluster}.

Query parameters

Parameters
topicId

string

Required. The ID to use for the topic, which will become the final component of the topic's name.

This value is structured like: my-topic-name.

Request body

The request body contains an instance of Topic.

Response body

If successful, the response body contains a newly created instance of Topic.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • managedkafka.topics.create

For more information, see the IAM documentation.