View capacity requests

This document explains how to view the status and details of capacity requests. To learn how to create a capacity request in Capacity Planner, see instead Create a capacity request.

After you create a capacity request, you can view the request to review the details of your requested resources, or verify the request approval status.

Limitations

You can only view capacity requests that exist in your project.

Before you begin

• If you can't access Capacity Planner in the Google Cloud console, then your organization might not be eligible to access and use Capacity Planner. To request access, you must contact your assigned technical account manager (TAM) or the sales team.

Required roles

To get the permissions that you need to view capacity requests, ask your administrator to grant you the Capacity Planner Usage Planner (roles/capacityplanner.planner) IAM role on your project. For more information about granting roles, see Manage access to projects, folders, and organizations.

This predefined role contains the permissions required to view capacity requests. To see the exact permissions that are required, expand the Required permissions section:

Required permissions

The following permissions are required to view capacity requests:

• To view a list of capacity requests in your project: capacityplanner.capacityPlans.list on the project
• To view the details of a single capacity request: capacityplanner.capacityPlans.get on the project

You might also be able to get these permissions with custom roles or other predefined roles.

View capacity requests

To view capacity requests, use one of the following methods:

• To get an overview of all capacity requests in your project and their status, view a list of capacity requests.

• To view the full details of a single capacity request, or review the usage and forecast of the resources that you requested in your request, view the details of a capacity request.

View a list of capacity requests

To view a list of capacity requests in your project, follow these steps:

1. In the Google Cloud console, go to the Capacity Planner page.

   Go to Capacity Planner

2. Optional: To refine your list of capacity requests, in the filter_list Filter field, select the properties that you want to filter the requests by.

View the details of a capacity request

When you view the details of a single capacity request, you can only view usage and forecast for the following resources:

• Compute Engine instances

• Disks

• GPUs

• TPUs

To view the details of a single capacity request in your project, follow these steps:

1. In the Google Cloud console, go to the Capacity Planner page.

   Go to Capacity Planner

2. In the Name column, click the arrow_right expander arrow next to the capacity request that you want to view the details of.

3. To view the usage and forecast of a type of compute instance, disk, GPU, or TPU that is specified in your capacity request, click the resource. A page that shows the usage and forecast of the resource appears.

What's next

• View usage and forecast data