REGION_ID: The region whose
backups you want listed. For example, us-central1.
To list backups in all regions, omit this argument.
CLUSTER_ID: The ID of the cluster whose
backups you want listed.
To list backups in all your clusters within the specified
regions, omit this argument.
PROJECT_ID: The ID of the project whose backups
you want listed.
Note that the NAME column in the output table displays the full name of
each backup, which includes its project ID and location. The backup's ID
is the substring following /backups/ in its name.
For example, if a backup has a name of
/projects/myproject/locations/us-central1/backups/bkp-1, the backup's ID
is bkp-1.
[[["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-29 UTC."],[[["\u003cp\u003eThis page details how to view a list of AlloyDB backups within your Google Cloud project.\u003c/p\u003e\n"],["\u003cp\u003eTo access AlloyDB backups, you must have the AlloyDB Admin, Owner, or Editor IAM role enabled in your project.\u003c/p\u003e\n"],["\u003cp\u003eYou can view backups through the Google Cloud console by navigating to the Backups page.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, use the \u003ccode\u003egcloud alloydb backups list\u003c/code\u003e command in the Google Cloud CLI to view a list of backups, with optional filters for region and cluster.\u003c/p\u003e\n"],["\u003cp\u003eThe backup's ID can be found in the NAME column of the gcloud output, as the substring following \u003ccode\u003e/backups/\u003c/code\u003e in its full name.\u003c/p\u003e\n"]]],[],null,["# View a list of backups\n\nThis page describes how to view a list of AlloyDB backups.\n\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- You must have one of these IAM roles in the Google Cloud project you are using:\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 to request\n access.\n\n\u003cbr /\u003e\n\nProcedure\n---------\n\n### Console\n\nIn the Google Cloud console, go to the **Backups** page.\n\n[Go to Backups](https://console.cloud.google.com/alloydb/backups)\n\nThis displays a list of all AlloyDB backups within your project.\n\n### gcloud\n\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).\n\n\u003cbr /\u003e\n\nTo view a list of backups, use the [`gcloud alloydb backups\nlist`](/sdk/gcloud/reference/alloydb/backups/list) command. \n\n gcloud alloydb backups list \\\n --region=\u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e \\\n --filter=clusters/\u003cvar translate=\"no\"\u003eCLUSTER_ID\u003c/var\u003e\\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e: The region whose\n backups you want listed. For example, `us-central1`.\n\n To list backups in all regions, omit this argument.\n- \u003cvar translate=\"no\"\u003eCLUSTER_ID\u003c/var\u003e: The ID of the cluster whose\n backups you want listed.\n\n To list backups in all your clusters within the specified\n regions, omit this argument.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The ID of the project whose backups\n you want listed.\n\nNote that the `NAME` column in the output table displays the full name of\neach backup, which includes its project ID and location. The backup's ID\nis the substring following `/backups/` in its name.\n\nFor example, if a backup has a name of\n`/projects/myproject/locations/us-central1/backups/bkp-1`, the backup's ID\nis `bkp-1`."]]