---
title: "POST /v1/{+parent}/connectClusters"
method: POST
path: "/v1/{+parent}/connectClusters"
tags: ["projects"]
---

# POST /v1/{+parent}/connectClusters

`POST /v1/{+parent}/connectClusters`

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

## Path parameters

- `parent` string, required

## Query parameters

- `connectClusterId` string
- `requestId` string

## Request body

- ConnectCluster — An Apache Kafka Connect cluster deployed in a location.
  - `capacityConfig` CapacityConfig — A capacity configuration of a Kafka cluster.
    - `memoryBytes` string, int64 — Required. The memory to provision for the cluster in bytes. The CPU:memory ratio (vCPU:GiB) must be between 1:1 and 1:8. Minimum: 3221225472 (3 GiB).
    - `vcpuCount` string, int64 — Required. The number of vCPUs to provision for the cluster. Minimum: 3.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'DETACHED' — Output only. The current state of the Kafka Connect cluster.
  - `createTime` string, google-datetime — Output only. The time when the cluster was created.
  - `updateTime` string, google-datetime — Output only. The time when the cluster was last updated.
  - `gcpConfig` ConnectGcpConfig — Configuration properties for a Kafka Connect cluster deployed to Google Cloud Platform.
    - `accessConfig` ConnectAccessConfig — The configuration of access to the Kafka Connect cluster.
      - `networkConfigs` ConnectNetworkConfig[] — Required. Virtual Private Cloud (VPC) networks that must be granted direct access to the Kafka Connect cluster. Minimum of 1 network is required. Maximum 10 networks can be specified.
        - `primarySubnet` string — Required. VPC subnet to make available to the Kafka Connect cluster. Structured like: projects/{project}/regions/{region}/subnetworks/{subnet_id} It is used to create a Private Service Connect (PSC) interface for the Kafka Connect workers. It must be located in the same region as the Kafka Connect cluster. The CIDR range of the subnet must be within the IPv4 address ranges for private networks, as specified in RFC 1918. The primary subnet CIDR range must have a minimum size of /22 (1024 addresses).
        - `dnsDomainNames` string[] — Optional. Additional DNS domain names from the subnet's network to be made visible to the Connect Cluster. When using MirrorMaker2, it's necessary to add the bootstrap address's dns domain name of the target cluster to make it visible to the connector. For example: my-kafka-cluster.us-central1.managedkafka.my-project.cloud.goog
        - `additionalSubnets` string[] — Optional. Deprecated: Managed Kafka Connect clusters can now reach any endpoint accessible from the primary subnet without the need to define additional subnets. Please see https://cloud.google.com/managed-service-for-apache-kafka/docs/connect-cluster/create-connect-cluster#worker-subnet for more information.
    - `secretPaths` string[] — Optional. Secrets to load into workers. Exact SecretVersions from Secret Manager must be provided -- aliases are not supported. Up to 32 secrets may be loaded into one cluster. Format: projects//secrets//versions/
  - `satisfiesPzs` boolean — Output only. Reserved for future use.
  - `kafkaCluster` string — Required. Immutable. The name of the Kafka cluster this Kafka Connect cluster is attached to. Structured like: projects/{project}/locations/{location}/clusters/{cluster}
  - `labels` object — Optional. Labels as key value pairs.
  - `config` object — Optional. Reserved for future use. This field is meant for worker config overrides, but is unsupported for now.
  - `name` string — Identifier. The name of the Kafka Connect cluster. Structured like: projects/{project_number}/locations/{location}/connectClusters/{connect_cluster_id}

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/managedkafka.md) · [All operations](https://skmtc.net/google/apis/managedkafka/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/managedkafka/versions/ebfb70483869/schema)