[[["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-25 UTC."],[[["\u003cp\u003eThis page provides instructions on how to list existing previews and check their status within the Infrastructure Manager.\u003c/p\u003e\n"],["\u003cp\u003eYou must have the \u003ccode\u003eroles/config.admin\u003c/code\u003e IAM permission to view previews.\u003c/p\u003e\n"],["\u003cp\u003eYou can list previews in a specific location using the command \u003ccode\u003egcloud infra-manager previews list --location=<var translate="no">LOCATION</var>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDetails of a preview, such as its state and the Terraform version used, can be viewed with \u003ccode\u003egcloud infra-manager previews describe projects/<var translate="no">PROJECT_ID</var>/locations/<var translate="no">LOCATION</var>/previews/<var translate="no">PREVIEW_ID</var>\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# View and list previews\n\nThis page describes how to list existing previews, and view the status\nof a preview.\n\nIf you have not created a preview, see\n[Preview a deployment](/infrastructure-manager/docs/preview-deployment).\n\nBefore you begin\n----------------\n\nEnsure that you have the IAM permissions needed to view previews: `roles/config.admin`.\n\nList previews\n-------------\n\nTo list the previews in a specific location: \n\n gcloud infra-manager previews list --location=\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e with the location that contains the previews\nyou want to list. See\n[Infrastructure Manager locations](/infrastructure-manager/docs/locations) for the\nlist of valid locations.\n\nView details of a preview\n-------------------------\n\nAfter you create a preview, you might want to view details about the\ndeployment, including the following:\n\n- The state of the preview. View the state to verify if the preview was successful, failed, or had any issues.\n- The version of Terraform that Infra Manager used to create the preview.\n\nTo view details of a preview, use the following command: \n\n gcloud infra-manager previews describe \\\n projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/locations/\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e/previews/\u003cvar translate=\"no\"\u003ePREVIEW_ID\u003c/var\u003e\n\nReplace:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is the project ID where Infrastructure Manager runs.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e is the location where Infra Manager runs. See [Infrastructure Manager locations](/infrastructure-manager/docs/locations) for the list of valid locations.\n- \u003cvar translate=\"no\"\u003ePREVIEW_ID\u003c/var\u003e is the preview identifier of the preview.\n\nWhat's next\n-----------\n\n- [Create a new preview](/infrastructure-manager/docs/preview-deployment).\n- Use Infra Manager to [deploy resources](/infrastructure-manager/docs/deploy-resources).\n- [Delete a preview](/infrastructure-manager/docs/delete-preview).\n- Learn more about [Terraform with Infra Manager](/infrastructure-manager/docs/terraform)."]]