This page lists the IAM roles and permissions for Capacity Planner. To
search through all roles and permissions, see the [role and
permission index](https://docs.cloud.google.com/iam/docs/roles-permissions).

## Capacity Planner roles

| Role | Permissions |
|---|---|
| #### Capacityplanner Admin ^Beta^ (`roles/capacityplanner.admin`) Admin role for capacityplanner | `capacityplanner.*` - `capacityplanner.capacityPlans.create` - `capacityplanner.capacityPlans.delete` - `capacityplanner.capacityPlans.get` - `capacityplanner.capacityPlans.list` - `capacityplanner.capacityPlans.update` - `capacityplanner.forecasts.list` - `capacityplanner.messages.generate` - `capacityplanner.operations.get` - `capacityplanner.planAlertInsights.list` - `capacityplanner.usageAlertInsights.list` - `capacityplanner.usageHistories.list` - `capacityplanner.usageHistories.summarize` `cloudquotas.quotas.get` `compute.futureReservations.get` `compute.futureReservations.list` `compute.reservations.get` `compute.reservations.list` `monitoring.timeSeries.list` `resourcemanager.folders.get` `resourcemanager.organizations.get` `resourcemanager.projects.get` `resourcemanager.projects.list` `serviceusage.catalogs.listMembers` `serviceusage.consumerpolicy.analyze` `serviceusage.consumerpolicy.get` `serviceusage.effectivepolicy.get` `serviceusage.groups.*` - `serviceusage.groups.list` - `serviceusage.groups.listExpandedMembers` - `serviceusage.groups.listMembers` `serviceusage.quotas.get` `serviceusage.services.get` `serviceusage.services.listApis` `serviceusage.services.listDependentServices` `serviceusage.values.test` |
| #### Capacity Planner Viewer ^Beta^ (`roles/capacityplanner.viewer`) Read-only access to Capacity Planner resources | `capacityplanner.capacityPlans.get` `capacityplanner.capacityPlans.list` `capacityplanner.forecasts.list` `capacityplanner.messages.generate` `capacityplanner.operations.get` `capacityplanner.planAlertInsights.list` `capacityplanner.usageAlertInsights.list` `capacityplanner.usageHistories.*` - `capacityplanner.usageHistories.list` - `capacityplanner.usageHistories.summarize` `cloudquotas.quotas.get` `compute.futureReservations.get` `compute.futureReservations.list` `compute.reservations.get` `compute.reservations.list` `monitoring.timeSeries.list` `resourcemanager.folders.get` `resourcemanager.organizations.get` `resourcemanager.projects.get` `resourcemanager.projects.list` `serviceusage.catalogs.listMembers` `serviceusage.consumerpolicy.analyze` `serviceusage.consumerpolicy.get` `serviceusage.effectivepolicy.get` `serviceusage.groups.*` - `serviceusage.groups.list` - `serviceusage.groups.listExpandedMembers` - `serviceusage.groups.listMembers` `serviceusage.quotas.get` `serviceusage.services.get` `serviceusage.services.listApis` `serviceusage.services.listDependentServices` `serviceusage.values.test` |
| #### Capacity Planner ^Beta^ (`roles/capacityplanner.planner`) Role that enables capacity planning | `capacityplanner.*` - `capacityplanner.capacityPlans.create` - `capacityplanner.capacityPlans.delete` - `capacityplanner.capacityPlans.get` - `capacityplanner.capacityPlans.list` - `capacityplanner.capacityPlans.update` - `capacityplanner.forecasts.list` - `capacityplanner.messages.generate` - `capacityplanner.operations.get` - `capacityplanner.planAlertInsights.list` - `capacityplanner.usageAlertInsights.list` - `capacityplanner.usageHistories.list` - `capacityplanner.usageHistories.summarize` `cloudquotas.quotas.get` `compute.futureReservations.get` `compute.futureReservations.list` `compute.reservations.get` `compute.reservations.list` `monitoring.timeSeries.list` `resourcemanager.folders.get` `resourcemanager.organizations.get` `resourcemanager.projects.get` `resourcemanager.projects.list` `serviceusage.catalogs.listMembers` `serviceusage.consumerpolicy.analyze` `serviceusage.consumerpolicy.get` `serviceusage.effectivepolicy.get` `serviceusage.groups.*` - `serviceusage.groups.list` - `serviceusage.groups.listExpandedMembers` - `serviceusage.groups.listMembers` `serviceusage.quotas.get` `serviceusage.services.get` `serviceusage.services.listApis` `serviceusage.services.listDependentServices` `serviceusage.values.test` |

## Capacity Planner permissions

| Permission | Included in roles |
|---|---|
| #### `capacityplanner.capacityPlans.create` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) |
| #### `capacityplanner.capacityPlans.delete` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) |
| #### `capacityplanner.capacityPlans.get` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.capacityPlans.list` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Security Reviewer](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityReviewer) (`roles/iam.securityReviewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Security Auditor](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.securityAuditor) (`roles/iam.securityAuditor`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.capacityPlans.update` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) |
| #### `capacityplanner.forecasts.list` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Security Reviewer](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityReviewer) (`roles/iam.securityReviewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Security Auditor](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.securityAuditor) (`roles/iam.securityAuditor`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.messages.generate` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.operations.get` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.planAlertInsights.list` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Security Reviewer](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityReviewer) (`roles/iam.securityReviewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Security Auditor](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.securityAuditor) (`roles/iam.securityAuditor`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.usageAlertInsights.list` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Security Reviewer](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityReviewer) (`roles/iam.securityReviewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Security Auditor](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.securityAuditor) (`roles/iam.securityAuditor`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.usageHistories.list` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Security Reviewer](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityReviewer) (`roles/iam.securityReviewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Security Auditor](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.securityAuditor) (`roles/iam.securityAuditor`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `capacityplanner.usageHistories.summarize` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Capacityplanner Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.admin) (`roles/capacityplanner.admin`) [Capacity Planner Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.viewer) (`roles/capacityplanner.viewer`) [Capacity Planner](https://docs.cloud.google.com/iam/docs/roles-permissions/capacityplanner.md.txt#capacityplanner.planner) (`roles/capacityplanner.planner`) [Cloud Hub Operator](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudhub.md.txt#cloudhub.operator) (`roles/cloudhub.operator`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |