v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13356598.3 KB
projects

Creates a new Kafka Connect cluster in a given project and location.

post/v1/{+parent}/connectClusters

Path parameters

parentstring required

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

Query parameters

connectClusterIdstring

Required. The ID to use for the Connect cluster, which will become the final component of the cluster's name. The ID must be 1-63 characters long, and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? to comply with RFC 1035. This value is structured like: my-cluster-id.

requestIdstring

Optional. An optional request ID to identify requests. Specify a unique request ID to avoid duplication of requests. If a request times out or fails, retrying with the same ID allows the server to recognize the previous attempt. For at least 60 minutes, the server ignores duplicate requests bearing the same ID. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID within 60 minutes of the last request, the server checks if an original operation with the same request ID was received. If so, the server ignores the second request. The request ID must be a valid UUID. A zero UUID is not supported (00000000-0000-0000-0000-000000000000).

Request body

satisfiesPziboolean

Output only. Reserved for future use.

state'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'DETACHED'

Output only. The current state of the Kafka Connect cluster.

createTimestring google-datetime

Output only. The time when the cluster was created.

updateTimestring google-datetime

Output only. The time when the cluster was last updated.

satisfiesPzsboolean

Output only. Reserved for future use.

kafkaClusterstring

Required. Immutable. The name of the Kafka cluster this Kafka Connect cluster is attached to. Structured like: projects/{project}/locations/{location}/clusters/{cluster}

labelsobject

Optional. Labels as key value pairs.

configobject

Optional. Reserved for future use. This field is meant for worker config overrides, but is unsupported for now.

namestring

Identifier. The name of the Kafka Connect cluster. Structured like: projects/{project_number}/locations/{location}/connectClusters/{connect_cluster_id}

Response

Successful response