Stay organized with collections
Save and categorize content based on your preferences.
This page shows you how to get the fleet membership status of your clusters, including listing all your fleet members, and getting membership details such as the cluster's membership name or if it has fleet Workload Identity enabled. You can use this information to validate that you have successfully registered a cluster, or to perform other fleet-level tasks.
You can view clusters that have been successfully registered by using the gcloud CLI or the
Google Cloud console. Some additional status details are available only by using the gcloud CLI.
Console
Required roles
Ensure you have the minimum permissions to view fleet clusters in the Google Cloud console.
A cluster's fleet registration status is shown in the following pages:
The GKE clusters page displays the fleet name in the cluster list's Fleet column.
The following commands provide information about fleet members:
List all registered clusters in a project:
gcloud container fleet memberships list \
--project=PROJECT_ID
In the command output, the Name column lists the membership names of
registered clusters. The membership name might be the same as the
cluster name depending on the membership name that was chosen when
the cluster was registered. The EXTERNAL_ID column lists the
clusters' UIDs in the kube-system namespace. You can find a cluster's
UID with the following command:
kubectl get namespace kube-system -o jsonpath='{.metadata.uid}'
This command returns complete details of your cluster's fleet membership, including when it was registered and if it has fleet Workload Identity enabled.
What's next
Learn more about working with, and connecting to fleet clusters in the following guides:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Get fleet membership status\n\nThis page shows you how to get the fleet membership status of your clusters, including listing all your fleet members, and getting membership details such as the cluster's [membership name](/kubernetes-engine/fleet-management/docs/fleet-creation#about_fleet_membership) or if it has [fleet Workload Identity](/kubernetes-engine/fleet-management/docs/use-workload-identity) enabled. You can use this information to validate that you have successfully registered a cluster, or to perform other fleet-level tasks.\n\nYou can view clusters that have been successfully registered by using the gcloud CLI or the\nGoogle Cloud console. Some additional status details are available only by using the gcloud CLI. \n\n### Console\n\n### Required roles\n\nEnsure you have the [minimum permissions](/kubernetes-engine/fleet-management/docs/console) to view fleet clusters in the Google Cloud console.\n\nA cluster's fleet registration status is shown in the following pages:\n\n- The GKE clusters page displays the fleet name in the cluster list's **Fleet** column.\n\n [Go to Kubernetes clusters](https://console.cloud.google.com/kubernetes/list)\n- The GKE cluster details page shows the cluster's [unique membership name](/kubernetes-engine/fleet-management/docs/fleet-creation#about_fleet_membership) in the **GKE Hub Membership** field.\n\n- If you have running workloads on the cluster, the fleet name is also displayed on the GKE workloads page, in the workload list's **Fleet** column.\n\n [Go to Workloads](https://console.cloud.google.com/kubernetes/workload/overview)\n\n### gcloud\n\nThe following commands provide information about fleet members:\n\n- List all registered clusters in a project:\n\n gcloud container fleet memberships list \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n In the command output, the `Name` column lists the [membership names](/kubernetes-engine/fleet-management/docs/fleet-creation#about_fleet_membership) of\n registered clusters. The membership name might be the same as the\n cluster name depending on the membership name that was chosen when\n the cluster was registered. The `EXTERNAL_ID` column lists the\n clusters' UIDs in the `kube-system` namespace. You can find a cluster's\n UID with the following command:\n `kubectl get namespace kube-system -o jsonpath='{.metadata.uid}'`\n\n \u003cbr /\u003e\n\n | **Note:** Depending on the version, admin clusters in Google Distributed Cloud deployments on VMware might not be in the command output. If you don't know the membership name of the admin cluster, run the following command on your admin workstation to get the membership name: `kubectl describe membership membership --kubeconfig `\u003cvar translate=\"no\"\u003eADMIN_CLUSTER_KUBECONFIG\u003c/var\u003e\n- View fleet membership details about a cluster:\n\n gcloud container fleet memberships describe \u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n This command returns complete details of your cluster's fleet membership, including when it was registered and if it has [fleet Workload Identity](/kubernetes-engine/fleet-management/docs/use-workload-identity) enabled.\n\nWhat's next\n-----------\n\nLearn more about working with, and connecting to fleet clusters in the following guides:\n\n- [Manage identity for authenticating to clusters](/kubernetes-engine/fleet-management/docs/secure#manage_identity)\n- [Work with fleet clusters from the Google Cloud console](/kubernetes-engine/fleet-management/docs/console)\n- [Work with fleet clusters from the command line](/kubernetes-engine/fleet-management/docs/command-line)"]]
