[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-25。"],[[["\u003cp\u003eThis page outlines how to view and manage AlloyDB for PostgreSQL clusters within a Google Cloud project using the Google Cloud console and the \u003ccode\u003egcloud\u003c/code\u003e command-line tool.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003cstrong\u003eClusters\u003c/strong\u003e page provides an overview of database health and performance through summary cards, including information on performance limits and backup status.\u003c/p\u003e\n"],["\u003cp\u003eUsers can view a detailed list of clusters, instances, and their details, which can be filtered by various properties such as location, resource type, CPU usage, and backup status.\u003c/p\u003e\n"],["\u003cp\u003eBefore listing clusters, ensure your project has AlloyDB access enabled and you have the necessary IAM roles, such as \u003ccode\u003eroles/alloydb.admin\u003c/code\u003e, \u003ccode\u003eroles/owner\u003c/code\u003e, or \u003ccode\u003eroles/editor\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe list of clusters can be filtered, either by using the summary cards or by selecting properties from the \u003cstrong\u003eFilter\u003c/strong\u003e list in the resource table, including but not limited to: resource name, resource type, location, high availability, CPU%, and more.\u003c/p\u003e\n"]]],[],null,["# View the clusters in a project\n\nThis page describes how to list AlloyDB for PostgreSQL clusters in your\nproject and view information about them.\n\nThe **Clusters** page of the Google Cloud console displays summary cards and a\nresource table that provide information about all clusters in a project.\n\nThe following summary cards provide an overview of the database health and performance:\n\n- **Performance**. Displays the number of clusters that are at their performance\n limits for CPU utilization, connections capacity, and replication lag.\n\n- **Backups**. Displays the number of clusters without an automated backup\n policy and the number of clusters whose most recent successfully created backup\n is older than 24 hours, including clusters without backups.\n\nThe resource table provides a list of clusters, instances, and their details. For\nmore information about filtering the resource table, see [Filter the resource table](#filter-resource-table).\n\nEach summary card displays multiple metrics that you can click to filter the\nresource table. For example, when you click **No backups within 24h**\nin the **Backups** summary card, the resource table filters the information\nto display only clusters whose backups are not taken in the last 24 hours.\n\nBefore you begin\n----------------\n\n- The Google Cloud project you are using must have been [enabled to access AlloyDB](/alloydb/docs/project-enable-access).\n\n- You must have the `roles/monitoring.admin` role (the Monitoring Admin predefined IAM role)\n in the Google Cloud project you are using.\n\n- You must have one of these IAM roles in the Google Cloud project you are using:\n\n - `roles/alloydb.admin` (the AlloyDB Admin predefined IAM role)\n - `roles/owner` (the Owner basic IAM role)\n - `roles/editor` (the Editor basic IAM role)\n\n If you don't have any of these roles, contact your Organization Administrator\n to request access.\n\nView the list of clusters\n-------------------------\n\nYou can view the list of clusters, instances, and their details on the **Clusters**\npage. \n\n### Console\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the **Select a project** list, select a Google Cloud project.\n3. Click **Open**.\n4. To filter the resulting list of all of your project's clusters, either by location or another attribute, see [Filter the resource table](#filter-resource-table).\n\n### gcloud\n\nTo use the gcloud CLI, you can\n[install and initialize](/sdk/docs/install) the Google Cloud CLI, or you\ncan use [Cloud Shell](/shell/docs/using-cloud-shell).\nTo view the list of clusters, use the [`gcloud alloydb clusters list`](https://cloud.google.com/sdk/gcloud/reference/alloydb/clusters/list) command.\n\n#### View the list of clusters in all regions\n\nTo view the list clusters in all regions, run the following command: \n\n```\ngcloud alloydb clusters list \\\n --project=PROJECT_ID\n```\nReplace \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ePROJECT_ID\u003c/code\u003e\u003c/var\u003e with the ID of your project.\n\n#### View the list clusters in a specific region\n\nTo view the list clusters in a specific region, run the following command: \n\n```\ngcloud alloydb clusters list \\\n --region=REGION_ID \\\n --project=PROJECT_ID\n```\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e: The region whose clusters you want to list.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The ID of your project.\n\nFilter the resource table\n-------------------------\n\nBy default, the resource table lists all clusters, instances, and their details.\nYou can filter the resource table by using the summary cards or the **Filter**\nlist in the resource table.\n\nTo filter the resource table, follow these steps:\n\n\u003cbr /\u003e\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the **Select a project** list, select a Google Cloud project.\n3. Click **Open**.\n4. In the **Clusters** page that opens, choose one of the following methods to filter the resource table view:\n - Choose a summary card displayed at the top of the page, and click a metric value in the summary card.\n - Go to the [resource table](#resource-table) that displays the list of clusters, and select properties and values of the resources from the **Filter** list.\n\n\u003cbr /\u003e\n\n### Resource table properties\n\nThe **Filter** list in the resource table provides the following properties:\n\nWhat's next\n-----------\n\n- For information about how to monitor AlloyDB instances, see [Monitor instances](/alloydb/docs/monitor-instance)."]]
