List your Connect clusters
Stay organized with collections Save and categorize content based on your preferences.

Listing your Connect clusters lets you view the details of all your Connect clusters in one pane, including details such as health of the clusters, locations, uptime of the clusters, compute size, associated Google Cloud Managed Service for Apache Kafka cluster, and labels.

To list your Connect clusters, you can use the Google Cloud console, the gcloud CLI, the client library, or the Managed Kafka API. You can't use the open source Apache Kafka API to list Connect clusters.

Required roles and permissions to list your Connect clusters

To get the permissions that you need to list your Connect clusters, ask your administrator to grant you the Managed Kafka Viewer (roles/managedkafka.viewer) IAM role on your project. For more information about granting roles, see Manage access to projects, folders, and organizations.

This predefined role contains the permissions required to list your Connect clusters. To see the exact permissions that are required, expand the Required permissions section:

Required permissions

The following permissions are required to list your Connect clusters:

Grant the list clusters permission on the specified location: managedkafka.connectClusters.list
Grant the get cluster details permission on the specified location: managedkafka.connectClusters.get

You might also be able to get these permissions with custom roles or other predefined roles.

For more information about the Managed Kafka Viewer role, see Managed Service for Apache Kafka predefined roles.

View your Connect clusters

Console

In the Google Cloud console, go to the Connect clusters page.

Go to Connect clusters
The clusters you created in a project are listed. The page lets you view the following cluster properties:
- Name: The unique identifier for your Connect cluster. You can use it to reference the Connect cluster in various operations.
- State: Indicates the current operational status of the Connect cluster, such as Active.
- Location: The geographical location where your Connect cluster is hosted.
- Update time: The time the Connect cluster was last updated.
- vCPUs: The number of vCPUs assigned to the Connect cluster.
- Memory: The total amount of memory allocated to the Connect cluster.
- Primary Kafka cluster: The Managed Service for Apache Kafka cluster associated with the Connect cluster.
- Labels: Key-value pairs that you can attach to the Connect cluster for organization, filtering, and automation purposes.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Use the gcloud alpha managed-kafka connect-clusters list command to list Connect clusters:
```
gcloud alpha managed-kafka connect-clusters list \
    --location=LOCATION
```
To further refine the list of Connect clusters, you can use additional flags:
```
gcloud alpha managed-kafka connect-clusters list \
    --location=LOCATION \
    [--filter=EXPRESSION] \
    [--limit=LIMIT] \
    [--page-size=PAGE_SIZE] \
    [--sort-by=SORT_BY]
```
Replace the following:
- LOCATION: Required. The location of the Connect clusters you want to list.
- EXPRESSION: (Optional) A boolean filter expression to apply to the list. If the expression evaluates to True, the item is included in the list. For more details and examples, run gcloud topic filters.
- LIMIT: (Optional) The maximum number of Connect clusters to display. If not specified, all Connect clusters are listed.
- PAGE_SIZE: (Optional) The number of results to display per page. If not specified, the service determines a suitable page size.
- SORT_BY: (Optional) A comma-separated list of fields to sort by. The default sort order is ascending. To sort in descending order, prefix the field with ~.

Example output:

NAME                   VCPU  MEMORY_BYTES  STATE   NETWORK
connect-cluster-alpha  3     3221225472    ACTIVE
connect-cluster-beta   3     3221225472    ACTIVE

What's next?

Apache Kafka® is a registered trademark of The Apache Software Foundation or its affiliates in the United States and/or other countries.