View and list previews

Stay organized with collections Save and categorize content based on your preferences.

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.