Skip to main content

GCP Permissions

To enable CloudYali to access and analyze your Google Cloud resources, you must grant specific permissions to the service account or user that will be used for integration.

Required GCP Permissions

Below is a list of the main permissions needed for CloudYali functionality:

Cost Management Permissions

PermissionScopeDescription
bigquery.datasets.createProjectCreate BigQuery datasets for billing export and recommendations.
bigquery.tables.createProjectCreate tables in BigQuery datasets.
bigquery.tables.getProjectRead tables in BigQuery datasets.
bigquery.jobs.createProjectRun queries on BigQuery datasets.
bigquery.dataViewerProjectView data in BigQuery datasets.
recommender.resources.exportOrganizationAllows you to export recommendations to BigQuery. (Required at the organization level corresponding to the export setup)

Resource Inventory & Organization Detection Permissions

The following permissions are required for GCP Resource Inventory and organization-wide project discovery:

PermissionScopeDescription
cloudasset.assets.listResourceOrganization/ProjectList all resources in the specified scope.
cloudasset.assets.searchAllResourcesOrganization/ProjectSearch for resources across the organization or project.
resourcemanager.projects.getOrganizationRead project metadata for organization detection.
resourcemanager.projects.listOrganizationList all projects in the organization.
resourcemanager.folders.getOrganizationTraverse folder hierarchy.
resourcemanager.folders.listOrganizationList folders in the organization.

The cloudasset.* permissions are included in the predefined Cloud Asset Viewer role (roles/cloudasset.viewer). The resourcemanager.* permissions are included in the predefined Browser role (roles/browser).

Organization-Level Required

For organization-wide cost and inventory collection, these roles must be granted at the organization level, not just at the project level. This allows CloudYali to discover all projects and resources across your entire organization.

Note: These permissions should be assigned to the service account used by CloudYali for GCP integration.


For AWS permissions, see AWS Permissions.