This page lists the IAM roles and permissions for Spanner. To search through all roles and permissions, see the role and permission index.
Spanner roles
| Role | Permissions |
|---|---|
Cloud Spanner Admin( Has complete access to all Spanner resources in a Google Cloud project. A principal with this role can:
Lowest-level resources where you can grant this role:
|
|
Spanner Editor( Editor role for spanner |
|
Cloud Spanner Viewer( A principal with this role can:
For example, you can combine this role with the This role is recommended at the Google Cloud project level for users interacting with Cloud Spanner resources in the Google Cloud console. Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Backup Admin( A principal with this role can:
This role cannot restore a database from a backup. Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Backup Writer( This role is intended to be used by scripts that automate backup creation. A principal with this role can create backups, but cannot update or delete them. Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Database Admin( A principal with this role can:
Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Database Reader( A principal with this role can:
Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Database Reader with DataBoost( Includes all permissions in the spanner.databaseReader role enabling access to read and/or query a Cloud Spanner database using instance resources, as well as the permission to access the database with Data Boost, a fully managed serverless service that provides independent compute resources. Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Database Role User( In conjunction with the IAM role Cloud Spanner Fine-grained Access User, grants permissions to individual Spanner database roles. Add a condition for each desired Spanner database role that includes the resource type of `spanner.googleapis.com/DatabaseRole` and the resource name ending with `/YOUR_SPANNER_DATABASE_ROLE`. Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Database User( A principal with this role can:
Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Fine-grained Access User( Grants permissions to use Spanner's fine-grained access control framework. To grant access to specific database roles, also add the `roles/spanner.databaseRoleUser` IAM role and its necessary conditions. Lowest-level resources where you can grant this role:
|
|
Cloud Spanner Database Graph Intelligence features user( Access to Graph Intelligence features. |
|
Cloud Spanner Restore Admin( A principal with this role can restore databases from backups. If you need to restore a backup to a different instance, apply this role at the project level or to both instances. This role cannot create backups. Lowest-level resources where you can grant this role:
|
|
Service agent roles
Service agent roles should only be granted to service agents.
| Role | Permissions |
|---|---|
Cloud Spanner API Service Agent( Cloud Spanner API Service Agent |
|
Spanner permissions
| Permission | Included in roles |
|---|---|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Security Admin (
Cloud Spanner Admin (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer (
Cloud Spanner Restore Admin ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Backup Admin ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer (
Cloud Spanner Restore Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Restore Admin ( |
|
Owner (
Security Admin (
Cloud Spanner Admin (
Databases Admin (
Cloud Spanner Backup Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database User (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database User (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database User (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Fine-grained Access User ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database User ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database User ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database User ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database User ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Data Scientist (
Databases Admin (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Database Admin ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Databases Admin (
Security Auditor (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database Graph Intelligence features user ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Security Admin (
Cloud Spanner Admin (
Databases Admin (
Cloud Spanner Database Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database User ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Fine-grained Access User ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Cloud Spanner Database Admin (
Cloud Spanner Database User ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Databases Admin (
Site Reliability Engineer (
Support User ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Databases Admin (
Security Auditor (
Site Reliability Engineer (
Support User ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Support User ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Data Scientist (
Databases Admin (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Databases Admin (
Security Auditor (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( Service agent roles
|
|
Owner (
Tag User (
Cloud Spanner Admin (
DLP Organization Data Profiles Driver (
DLP Project Data Profiles Driver (
Databases Admin (
Cloud Spanner Backup Admin (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( Service agent roles
|
|
Owner (
Tag User (
Cloud Spanner Admin (
DLP Organization Data Profiles Driver (
DLP Project Data Profiles Driver (
Databases Admin (
Cloud Spanner Backup Admin (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( |
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Data Scientist (
Databases Admin (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Backup Writer (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Database Admin ( |
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
Databases Admin (
Security Auditor (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Tag User (
Tag Viewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
DLP Organization Data Profiles Driver (
DLP Project Data Profiles Driver (
Databases Admin (
Security Auditor (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Tag User (
Tag Viewer (
Cloud Spanner Admin (
Spanner Editor (
Cloud Spanner Viewer (
DLP Organization Data Profiles Driver (
DLP Project Data Profiles Driver (
Databases Admin (
Security Auditor (
Site Reliability Engineer (
Support User (
Cloud Spanner Backup Admin (
Cloud Spanner Database Admin (
Cloud Spanner Restore Admin ( Service agent roles
|
|
Owner (
Security Admin (
Cloud Spanner Admin (
Databases Admin ( |
|
Owner (
Editor (
Cloud Spanner Admin (
Spanner Editor (
Databases Admin ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|
|
Owner (
Editor (
Viewer (
Security Admin (
Security Reviewer (
Cloud Spanner Admin (
Spanner Editor (
Data Scientist (
Databases Admin (
Security Auditor (
Support User (
Cloud Spanner Database Admin (
Cloud Spanner Database Reader (
Cloud Spanner Database Reader with DataBoost (
Cloud Spanner Database User (
Cloud Spanner Database Graph Intelligence features user ( Service agent roles
|