Method: projects.locations.clusters.acls.create

Creates a new acl in the given project, location, and cluster.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

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

Query parameters

Parameters
aclId

string

Required. The ID to use for the acl, which will become the final component of the acl's name. The structure of aclId defines the Resource Pattern (resourceType, resourceName, patternType) of the acl. aclId is structured like one of the following:

For acls on the cluster: cluster

For acls on a single resource within the cluster: topic/{resourceName} consumerGroup/{resourceName} transactionalId/{resourceName}

For acls on all resources that match a prefix: topicPrefixed/{resourceName} consumerGroupPrefixed/{resourceName} transactionalIdPrefixed/{resourceName}

For acls on all resources of a given type (i.e. the wildcard literal "*"): allTopics (represents topic/*) allConsumerGroups (represents consumerGroup/*) allTransactionalIds (represents transactionalId/*)

Request body

The request body contains an instance of Acl.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.