This page describes how to list existing previews, and view the status of a preview.
If you have not created a preview, see Preview a deployment.
Before you begin
Ensure that you have the IAM permissions needed to view previews: roles/config.admin
.
List previews
To list the previews in a specific location:
gcloud infra-manager previews list --location=LOCATION
Replace LOCATION with the location that contains the previews you want to list. See Infrastructure Manager locations for the list of valid locations.
View details of a preview
After you create a preview, you might want to view details about the deployment, including the following:
- The state of the preview. View the state to verify if the preview was successful, failed, or had any issues.
- The version of Terraform that Infra Manager used to create the preview.
To view details of a preview, use the following command:
gcloud infra-manager previews describe \
projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID
Replace:
- PROJECT_ID is the project ID where Infrastructure Manager runs.
- LOCATION is the location where Infra Manager runs. See Infrastructure Manager locations for the list of valid locations.
- PREVIEW_ID is the preview identifier of the preview.
What's next
- Create a new preview.
- Use Infra Manager to deploy resources.
- Delete a preview.
- Learn more about Terraform with Infra Manager.