View and list previews

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