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.liston the project -
To view the details of a single capacity request:
capacityplanner.capacityPlans.geton 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:
In the Google Cloud console, go to the Capacity Planner page.
Optional: To refine your list of capacity requests, in the 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:
In the Google Cloud console, go to the Capacity Planner page.
In the Name column, click the expander arrow next to the capacity request that you want to view the details of.
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.