Présentation d'IAM

Identity and Access Management (IAM) vous permet de contrôler l'accès des utilisateurs et des groupes aux ressources Spanner au niveau du projet, de l'instance Spanner, de la base de données Spanner, de la sauvegarde et de la planification de sauvegarde. Par exemple, vous pouvez spécifier qu'un utilisateur dispose d'un contrôle total sur une base de données spécifique dans une instance spécifique de votre projet, mais qu'il ne peut pas créer, modifier ni supprimer d'instances dans votre projet. Le contrôle des accès avec IAM vous permet d'accorder une autorisation à un utilisateur ou à un groupe sans avoir à modifier individuellement chaque autorisation d'instance ou de base de données Spanner.

Ce document se concentre sur les autorisations IAM pertinentes pour Spanner et sur les rôles IAM qui accordent ces autorisations. Pour obtenir une description détaillée d'IAM et de ses fonctionnalités, consultez le guide du développeur IAM. en particulier la section sur la gestion des stratégies IAM.

Autorisations

Les autorisations permettent aux utilisateurs de réaliser des opérations spécifiques sur les ressources Spanner. Par exemple, l'autorisation spanner.databases.read permet à un utilisateur de lire une base de données à l'aide de l'API de lecture de Spanner, tandis que l'autorisation spanner.databases.select permet à un utilisateur d'exécuter une instruction SQL SELECT sur une base de données. Vous n'accordez pas directement d'autorisations aux utilisateurs, mais vous leur attribuez des rôles prédéfinis ou des rôles personnalisés auxquels sont associées une ou plusieurs autorisations.

Les tableaux suivants répertorient les autorisations IAM associées à Spanner.

Configurations d'instance

Les autorisations suivantes s'appliquent aux configurations d'instances Spanner. Pour en savoir plus, consultez les références de configuration d'instance pour les API REST et RPC.

Nom de l'autorisation relative aux configurations d'instance Description
spanner.instanceConfigs.create Créez une configuration d'instance personnalisée.
spanner.instanceConfigs.delete Supprimer une configuration d'instance personnalisée.
spanner.instanceConfigs.get Obtenir une configuration d'instance
spanner.instanceConfigs.list Répertorier l'ensemble des configurations d'instance
spanner.instanceConfigs.update Mettre à jour une configuration d'instance personnalisée.

Opérations de configuration d'instance

Les autorisations suivantes s'appliquent aux opérations de configuration d'instance Spanner. Pour en savoir plus, consultez les documentations de référence des API suivantes :

Nom de l'autorisation associée aux opérations de configuration d'instance Description
spanner.instanceConfigOperations.cancel Annuler une opération de configuration d'instance.
spanner.instanceConfigOperations.delete Supprimez une opération de configuration d'instance.
spanner.instanceConfigOperations.get Obtenir une opération de configuration d'instance.
spanner.instanceConfigOperations.list Répertorier les opérations de configuration d'instance.

Instances

Les autorisations suivantes s'appliquent aux instances Spanner. Pour en savoir plus, consultez les références d'instance pour les API REST et RPC.

Nom de l'autorisation de l'instance Description
spanner.instances.create Créer une instance
spanner.instances.createTagBinding Associer un tag à une instance.
spanner.instances.delete Supprimer une instance
spanner.instances.deleteTagBinding Dissocier un tag d'une instance
spanner.instances.get Obtenir la configuration d'une instance spécifique
spanner.instances.getIamPolicy Obtenir la stratégie IAM d'une instance
spanner.instances.list Répertorier les instances
spanner.instances.listEffectiveTags Répertorier les tags associés à une instance ou dont elle a hérité.
spanner.instances.listTagBindings Répertoriez les tags directement associés à une instance.
spanner.instances.setIamPolicy Définir la stratégie IAM d'une instance
spanner.instances.update Mettre à jour une instance

Opérations d'instance :

Les autorisations suivantes s'appliquent aux opérations sur les instances Spanner. Pour en savoir plus, consultez les références d'instance pour les API REST et RPC.

Nom de l'autorisation relative aux opérations sur les instances Description
spanner.instanceOperations.cancel Annuler une opération sur une instance
spanner.instanceOperations.delete Supprimer une opération sur une instance
spanner.instanceOperations.get Obtenir une opération sur une instance
spanner.instanceOperations.list Répertorier les opérations sur les instances

Partitions d'instance

Les autorisations suivantes s'appliquent aux partitions d'instances Spanner. Pour en savoir plus, consultez les références des partitions d'instance pour les API REST et RPC.

Nom de l'autorisation de la partition d'instance Description
spanner.instancePartitions.create Créer une partition d'instance
spanner.instancePartitions.delete Supprimer une partition d'instance
spanner.instancePartitions.get Obtenez la configuration d'une partition d'instance spécifique.
spanner.instancePartitions.list Lister les partitions d'instance.
spanner.instancePartitions.update Mettre à jour une partition d'instance.

Opérations sur les partitions d'instance

Les autorisations suivantes s'appliquent aux opérations sur les partitions d'instance Spanner. Pour en savoir plus, consultez les documentations de référence des API suivantes :

Nom de l'autorisation associée aux opérations sur les partitions d'instance Description
spanner.instancePartitionOperations.cancel Annuler une opération de partition d'instance.
spanner.instancePartitionOperations.delete Supprimer une opération de partition d'instance.
spanner.instancePartitionOperations.get Récupérer une opération de partition d'instance spécifique.
spanner.instancePartitionOperations.list Répertorier les opérations de partition d'instance.

Bases de données

Les autorisations suivantes s'appliquent aux bases de données Spanner. Pour en savoir plus, consultez les références de base de données pour les API REST et RPC.

Nom de l'autorisation pour la base de données Description
spanner.databases.adapt Permet à l'API Spanner Adapter d'interagir directement avec Spanner. Nécessite également spanner.sessions.create pour créer une session d'adaptateur, et spanner.databases.select ou spanner.databases.write pour lire ou modifier des données via l'adaptateur.
spanner.databases.addSplitPoints Ajoutez des points de division aux tables et aux index d'une base de données.
spanner.databases.beginOrRollbackReadWriteTransaction Commencez ou effectuez un rollback d'une transaction en lecture-écriture sur une base de données Spanner.
spanner.databases.beginPartitionedDmlTransaction Démarrez une transaction LMD partitionnée sur une base de données Spanner. L'exécution de l'instruction UPDATE ou DELETE dans la transaction nécessite également spanner.databases.write.
spanner.databases.beginReadOnlyTransaction Commencez une transaction en lecture seule sur une base de données Spanner.
spanner.databases.changequorum Modifier le quorum d'une base de données dans une configuration d'instance birégionale.
spanner.databases.create Créer une base de données
spanner.databases.createBackup Créer une sauvegarde à partir de la base de données. Nécessite également spanner.backups.create pour créer la ressource de sauvegarde.
spanner.databases.drop Supprimer une base de données
spanner.databases.get Obtenir les métadonnées d'une base de données
spanner.databases.getDdl Obtenir le schéma d'une base de données
spanner.databases.getIamPolicy Obtenir la stratégie IAM d'une base de données.
spanner.databases.list Répertorier les bases de données
spanner.databases.partitionQuery Partitionnez une requête SQL pour pouvoir lire des données en parallèle.
spanner.databases.partitionRead Partitionnez une requête de lecture pour pouvoir lire des données en parallèle.
spanner.databases.read Lire dans une base de données à l'aide de l'API de lecture
spanner.databases.runGraphAlgorithms Exécutez des algorithmes de graphe sur une base de données Spanner Graph.
spanner.databases.select Exécuter une instruction SQL "SELECT" sur une base de données
spanner.databases.setIamPolicy Définir la stratégie IAM d'une base de données.
spanner.databases.update Mettre à jour les métadonnées d'une base de données
spanner.databases.updateDdl Mettre à jour le schéma d'une base de données
spanner.databases.useDataBoost Utilisez les ressources de calcul de Spanner Data Boost pour exécuter des requêtes et des lectures partitionnées.
spanner.databases.useRoleBasedAccess Utilisez le contrôle ultraprécis des accès.
spanner.databases.write Écrire dans une base de données

Rôles de base de données

Les autorisations suivantes s'appliquent aux rôles de base de données Spanner. Pour en savoir plus, consultez les références de base de données pour les API REST et RPC.

Nom de l'autorisation de rôle de base de données Description
spanner.databaseRoles.list Répertorier les rôles de base de données.
spanner.databaseRoles.use Utilisez un rôle de base de données spécifié.

Opérations de base de données

Les autorisations suivantes s'appliquent aux opérations sur les bases de données Spanner. Pour en savoir plus, consultez les documentations de référence des API suivantes :

Nom de l'autorisation relative aux opérations de base de données Description
spanner.databaseOperations.cancel Annuler une opération de base de données
spanner.databaseOperations.get Obtenir une opération de base de données
spanner.databaseOperations.list Répertorier les opérations de base de données et les restaurer

Sauvegardes

Les autorisations suivantes s'appliquent aux sauvegardes Spanner. Pour en savoir plus, consultez les références sur les sauvegardes pour les API REST et RPC.

Nom de l'autorisation de sauvegarde Description
spanner.backups.copy Copier une sauvegarde Nécessite également spanner.backups.create sur l'instance de destination.
spanner.backups.create Créer une sauvegarde (nécessite également spanner.databases.createBackup sur la base de données source)
spanner.backups.delete Supprimer une sauvegarde
spanner.backups.get Obtenir une sauvegarde
spanner.backups.getIamPolicy Obtenir la stratégie IAM d'une sauvegarde
spanner.backups.list Répertorier des sauvegardes
spanner.backups.restoreDatabase Restaurer la base de données à partir d'une sauvegarde. Nécessite également spanner.databases.create pour créer la base de données restaurée sur l'instance cible.
spanner.backups.setIamPolicy Définir la stratégie IAM d'une sauvegarde
spanner.backups.update Mettre à jour une sauvegarde

Opérations de sauvegarde

Les autorisations suivantes s'appliquent aux opérations de sauvegarde Spanner. Pour en savoir plus, consultez les références de base de données pour les API REST et RPC.

Nom de l'autorisation de l'opération de sauvegarde Description
spanner.backupOperations.cancel Annuler une opération de sauvegarde.
spanner.backupOperations.get Obtenir une opération de sauvegarde spécifique.
spanner.backupOperations.list Répertorier les opérations de sauvegarde.

Planifications de sauvegarde

Les autorisations suivantes s'appliquent aux programmations de sauvegarde Spanner. Pour en savoir plus, consultez les références de programmation de sauvegarde pour les API REST et RPC.

Nom de l'autorisation de la programmation de sauvegarde Description
spanner.backupSchedules.create Créez un planning de sauvegardes. (nécessite également spanner.databases.createBackup sur la base de données source)
spanner.backupSchedules.delete Supprimer une planification de sauvegarde.
spanner.backupSchedules.get Obtenir une planification de sauvegarde.
spanner.backupSchedules.getIamPolicy Obtenir la stratégie IAM d'une programmation de sauvegarde.
spanner.backupSchedules.list Répertorier les programmations de sauvegarde.
spanner.backupSchedules.setIamPolicy Définir la stratégie IAM d'une programmation de sauvegarde.
spanner.backupSchedules.update Mettre à jour une planification de sauvegarde.

Sessions

Les autorisations suivantes s'appliquent aux sessions Spanner. Pour en savoir plus, consultez les références de base de données pour les API REST et RPC.

Nom de l'autorisation relative aux sessions Description
spanner.sessions.create Créer une session
spanner.sessions.delete Supprimer une session
spanner.sessions.get Obtenir une session
spanner.sessions.list Répertorier les sessions

Rôles prédéfinis

Un rôle prédéfini correspond à un ensemble contenant une ou plusieurs autorisations. Par exemple, le rôle prédéfini roles/spanner.databaseUser inclut des autorisations telles que spanner.databases.read et spanner.databases.write.

Le tableau suivant répertorie les rôles prédéfinis IAM pour le contrôle des accès, avec les autorisations associées à chaque rôle :

Role Permissions

(roles/spanner.admin)

Has complete access to all Spanner resources in a Google Cloud project. A principal with this role can:

  • Grant and revoke permissions to other principals for all Spanner resources in the project.
  • Allocate and delete chargeable Spanner resources.
  • Issue get/list/modify operations on Cloud Spanner resources.
  • Read from and write to all Cloud Spanner databases in the project.
  • Fetch project metadata.

Lowest-level resources where you can grant this role:

  • Instance
  • Database

cloudkms.keyHandles.*

  • cloudkms.keyHandles.create
  • cloudkms.keyHandles.get
  • cloudkms.keyHandles.list

cloudkms.operations.get

cloudkms.projects.showEffectiveAutokeyConfig

monitoring.timeSeries.*

  • monitoring.timeSeries.create
  • monitoring.timeSeries.list

resourcemanager.projects.get

resourcemanager.projects.list

spanner.*

  • spanner.backupOperations.cancel
  • spanner.backupOperations.get
  • spanner.backupOperations.list
  • spanner.backupSchedules.create
  • spanner.backupSchedules.delete
  • spanner.backupSchedules.get
  • spanner.backupSchedules.getIamPolicy
  • spanner.backupSchedules.list
  • spanner.backupSchedules.setIamPolicy
  • spanner.backupSchedules.update
  • spanner.backups.copy
  • spanner.backups.create
  • spanner.backups.delete
  • spanner.backups.get
  • spanner.backups.getIamPolicy
  • spanner.backups.list
  • spanner.backups.restoreDatabase
  • spanner.backups.setIamPolicy
  • spanner.backups.update
  • spanner.databaseOperations.cancel
  • spanner.databaseOperations.get
  • spanner.databaseOperations.list
  • spanner.databaseRoles.list
  • spanner.databases.adapt
  • spanner.databases.addSplitPoints
  • spanner.databases.beginOrRollbackReadWriteTransaction
  • spanner.databases.beginPartitionedDmlTransaction
  • spanner.databases.beginReadOnlyTransaction
  • spanner.databases.changequorum
  • spanner.databases.create
  • spanner.databases.createBackup
  • spanner.databases.drop
  • spanner.databases.get
  • spanner.databases.getDdl
  • spanner.databases.getIamPolicy
  • spanner.databases.list
  • spanner.databases.partitionQuery
  • spanner.databases.partitionRead
  • spanner.databases.read
  • spanner.databases.runGraphAlgorithms
  • spanner.databases.select
  • spanner.databases.setIamPolicy
  • spanner.databases.update
  • spanner.databases.updateDdl
  • spanner.databases.useDataBoost
  • spanner.databases.useRoleBasedAccess
  • spanner.databases.write
  • spanner.instanceConfigOperations.cancel
  • spanner.instanceConfigOperations.delete
  • spanner.instanceConfigOperations.get
  • spanner.instanceConfigOperations.list
  • spanner.instanceConfigs.create
  • spanner.instanceConfigs.delete
  • spanner.instanceConfigs.get
  • spanner.instanceConfigs.list
  • spanner.instanceConfigs.update
  • spanner.instanceOperations.cancel
  • spanner.instanceOperations.delete
  • spanner.instanceOperations.get
  • spanner.instanceOperations.list
  • spanner.instancePartitionOperations.cancel
  • spanner.instancePartitionOperations.delete
  • spanner.instancePartitionOperations.get
  • spanner.instancePartitionOperations.list
  • spanner.instancePartitions.create
  • spanner.instancePartitions.delete
  • spanner.instancePartitions.get
  • spanner.instancePartitions.list
  • spanner.instancePartitions.update
  • spanner.instances.create
  • spanner.instances.createTagBinding
  • spanner.instances.delete
  • spanner.instances.deleteTagBinding
  • spanner.instances.get
  • spanner.instances.getIamPolicy
  • spanner.instances.list
  • spanner.instances.listEffectiveTags
  • spanner.instances.listTagBindings
  • spanner.instances.setIamPolicy
  • spanner.instances.update
  • spanner.sessions.create
  • spanner.sessions.delete
  • spanner.sessions.get
  • spanner.sessions.list

(roles/spanner.editor)

Editor role for Cloud Spanner

monitoring.timeSeries.list

resourcemanager.projects.get

resourcemanager.projects.list

spanner.backupOperations.*

  • spanner.backupOperations.cancel
  • spanner.backupOperations.get
  • spanner.backupOperations.list

spanner.backupSchedules.create

spanner.backupSchedules.delete

spanner.backupSchedules.get

spanner.backupSchedules.getIamPolicy

spanner.backupSchedules.list

spanner.backupSchedules.update

spanner.backups.copy

spanner.backups.create

spanner.backups.delete

spanner.backups.get

spanner.backups.getIamPolicy

spanner.backups.list

spanner.backups.restoreDatabase

spanner.backups.update

spanner.databaseOperations.*

  • spanner.databaseOperations.cancel
  • spanner.databaseOperations.get
  • spanner.databaseOperations.list

spanner.databaseRoles.list

spanner.databases.adapt

spanner.databases.addSplitPoints

spanner.databases.beginOrRollbackReadWriteTransaction

spanner.databases.beginPartitionedDmlTransaction

spanner.databases.beginReadOnlyTransaction

spanner.databases.changequorum

spanner.databases.create

spanner.databases.createBackup

spanner.databases.drop

spanner.databases.get

spanner.databases.getDdl

spanner.databases.getIamPolicy

spanner.databases.list

spanner.databases.partitionQuery

spanner.databases.partitionRead

spanner.databases.read

spanner.databases.runGraphAlgorithms

spanner.databases.select

spanner.databases.update

spanner.databases.updateDdl

spanner.databases.useDataBoost

spanner.databases.useRoleBasedAccess

spanner.databases.write

spanner.instanceConfigOperations.*

  • spanner.instanceConfigOperations.cancel
  • spanner.instanceConfigOperations.delete
  • spanner.instanceConfigOperations.get
  • spanner.instanceConfigOperations.list

spanner.instanceConfigs.*

  • spanner.instanceConfigs.create
  • spanner.instanceConfigs.delete
  • spanner.instanceConfigs.get
  • spanner.instanceConfigs.list
  • spanner.instanceConfigs.update

spanner.instanceOperations.*

  • spanner.instanceOperations.cancel
  • spanner.instanceOperations.delete
  • spanner.instanceOperations.get
  • spanner.instanceOperations.list

spanner.instancePartitionOperations.*

  • spanner.instancePartitionOperations.cancel
  • spanner.instancePartitionOperations.delete
  • spanner.instancePartitionOperations.get
  • spanner.instancePartitionOperations.list

spanner.instancePartitions.*

  • spanner.instancePartitions.create
  • spanner.instancePartitions.delete
  • spanner.instancePartitions.get
  • spanner.instancePartitions.list
  • spanner.instancePartitions.update

spanner.instances.create

spanner.instances.delete

spanner.instances.get

spanner.instances.getIamPolicy

spanner.instances.list

spanner.instances.listEffectiveTags

spanner.instances.listTagBindings

spanner.instances.update

spanner.sessions.*

  • spanner.sessions.create
  • spanner.sessions.delete
  • spanner.sessions.get
  • spanner.sessions.list

(roles/spanner.viewer)

A principal with this role can:

  • View all Spanner instances (but cannot modify instances).
  • View all Spanner databases (but cannot modify or read from databases).

For example, you can combine this role with the roles/spanner.databaseUser role to grant a user with access to a specific database, but only view access to other instances and databases.

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:

  • Instance
  • Database

monitoring.timeSeries.list

resourcemanager.projects.get

resourcemanager.projects.list

spanner.backupOperations.get

spanner.backupOperations.list

spanner.backupSchedules.get

spanner.backupSchedules.getIamPolicy

spanner.backupSchedules.list

spanner.backups.get

spanner.backups.getIamPolicy

spanner.backups.list

spanner.databaseOperations.get

spanner.databaseOperations.list

spanner.databaseRoles.list

spanner.databases.beginReadOnlyTransaction

spanner.databases.get

spanner.databases.getDdl

spanner.databases.getIamPolicy

spanner.databases.list

spanner.databases.useDataBoost

spanner.instanceConfigOperations.get

spanner.instanceConfigOperations.list

spanner.instanceConfigs.get

spanner.instanceConfigs.list

spanner.instanceOperations.get

spanner.instanceOperations.list

spanner.instancePartitionOperations.get

spanner.instancePartitionOperations.list

spanner.instancePartitions.get

spanner.instancePartitions.list

spanner.instances.get

spanner.instances.getIamPolicy

spanner.instances.list

spanner.instances.listEffectiveTags

spanner.instances.listTagBindings

(roles/spanner.backupAdmin)

A principal with this role can:

  • Create, view, update, and delete backups.
  • View and manage a backup's allow policy.

This role cannot restore a database from a backup.

Lowest-level resources where you can grant this role:

  • Instance
  • Database

monitoring.timeSeries.list

resourcemanager.projects.get

resourcemanager.projects.list

spanner.backupOperations.*

  • spanner.backupOperations.cancel
  • spanner.backupOperations.get
  • spanner.backupOperations.list

spanner.backupSchedules.create

spanner.backupSchedules.delete

spanner.backupSchedules.get

spanner.backupSchedules.list

spanner.backupSchedules.update

spanner.backups.copy

spanner.backups.create

spanner.backups.delete

spanner.backups.get

spanner.backups.getIamPolicy

spanner.backups.list

spanner.backups.setIamPolicy

spanner.backups.update

spanner.databases.createBackup

spanner.databases.get

spanner.databases.list

spanner.instancePartitions.get

spanner.instancePartitions.list

spanner.instances.createTagBinding

spanner.instances.deleteTagBinding

spanner.instances.get

spanner.instances.list

spanner.instances.listEffectiveTags

spanner.instances.listTagBindings

(roles/spanner.backupWriter)

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:

  • Instance
  • Database

spanner.backupOperations.get

spanner.backupOperations.list

spanner.backupSchedules.create

spanner.backupSchedules.get

spanner.backupSchedules.list

spanner.backups.copy

spanner.backups.create

spanner.backups.get

spanner.backups.list

spanner.databases.createBackup

spanner.databases.get

spanner.databases.list

spanner.instancePartitions.get

spanner.instances.get

(roles/spanner.databaseAdmin)

A principal with this role can:

  • Get/list all Spanner instances in the project.
  • Create/list/drop databases in an instance.
  • Grant/revoke access to databases in the project.
  • Read from and write to all Cloud Spanner databases in the project.

Lowest-level resources where you can grant this role:

  • Instance
  • Database

cloudkms.keyHandles.*

  • cloudkms.keyHandles.create
  • cloudkms.keyHandles.get
  • cloudkms.keyHandles.list

cloudkms.operations.get

cloudkms.projects.showEffectiveAutokeyConfig

monitoring.timeSeries.*

  • monitoring.timeSeries.create
  • monitoring.timeSeries.list

resourcemanager.projects.get

resourcemanager.projects.list

spanner.databaseOperations.*

  • spanner.databaseOperations.cancel
  • spanner.databaseOperations.get
  • spanner.databaseOperations.list

spanner.databaseRoles.list

spanner.databases.adapt

spanner.databases.addSplitPoints

spanner.databases.beginOrRollbackReadWriteTransaction

spanner.databases.beginPartitionedDmlTransaction

spanner.databases.beginReadOnlyTransaction

spanner.databases.changequorum

spanner.databases.create

spanner.databases.drop

spanner.databases.get

spanner.databases.getDdl

spanner.databases.getIamPolicy

spanner.databases.list

spanner.databases.partitionQuery

spanner.databases.partitionRead

spanner.databases.read

spanner.databases.runGraphAlgorithms

spanner.databases.select

spanner.databases.setIamPolicy

spanner.databases.update

spanner.databases.updateDdl

spanner.databases.useDataBoost

spanner.databases.useRoleBasedAccess

spanner.databases.write

spanner.instancePartitions.get

spanner.instancePartitions.list

spanner.instances.createTagBinding

spanner.instances.deleteTagBinding

spanner.instances.get

spanner.instances.getIamPolicy

spanner.instances.list

spanner.instances.listEffectiveTags

spanner.instances.listTagBindings

spanner.sessions.*

  • spanner.sessions.create
  • spanner.sessions.delete
  • spanner.sessions.get
  • spanner.sessions.list

(roles/spanner.databaseReader)

A principal with this role can:

  • Read from the Spanner database.
  • Execute SQL queries on the database.
  • View schema for the database.

Lowest-level resources where you can grant this role:

  • Instance
  • Database

monitoring.timeSeries.create

spanner.databases.beginReadOnlyTransaction

spanner.databases.get

spanner.databases.getDdl

spanner.databases.partitionQuery

spanner.databases.partitionRead

spanner.databases.read

spanner.databases.select

spanner.instancePartitions.get

spanner.instances.get

spanner.sessions.*

  • spanner.sessions.create
  • spanner.sessions.delete
  • spanner.sessions.get
  • spanner.sessions.list

(roles/spanner.databaseReaderWithDataBoost)

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:

  • Instance
  • Database

monitoring.timeSeries.create

spanner.databases.beginReadOnlyTransaction

spanner.databases.get

spanner.databases.getDdl

spanner.databases.partitionQuery

spanner.databases.partitionRead

spanner.databases.read

spanner.databases.select

spanner.databases.useDataBoost

spanner.instancePartitions.get

spanner.instances.get

spanner.sessions.*

  • spanner.sessions.create
  • spanner.sessions.delete
  • spanner.sessions.get
  • spanner.sessions.list

(roles/spanner.databaseRoleUser)

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:

  • Instance
  • Database

(roles/spanner.databaseUser)

A principal with this role can:

  • Read from and write to the Spanner database.
  • Execute SQL queries on the database, including DML and Partitioned DML.
  • View and update schema for the database.

Lowest-level resources where you can grant this role:

  • Instance
  • Database

monitoring.timeSeries.create

spanner.databaseOperations.*

  • spanner.databaseOperations.cancel
  • spanner.databaseOperations.get
  • spanner.databaseOperations.list

spanner.databases.adapt

spanner.databases.beginOrRollbackReadWriteTransaction

spanner.databases.beginPartitionedDmlTransaction

spanner.databases.beginReadOnlyTransaction

spanner.databases.changequorum

spanner.databases.get

spanner.databases.getDdl

spanner.databases.partitionQuery

spanner.databases.partitionRead

spanner.databases.read

spanner.databases.select

spanner.databases.updateDdl

spanner.databases.write

spanner.instancePartitions.get

spanner.instances.get

spanner.sessions.*

  • spanner.sessions.create
  • spanner.sessions.delete
  • spanner.sessions.get
  • spanner.sessions.list

(roles/spanner.fineGrainedAccessUser)

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:

  • Instance
  • Database

spanner.databaseRoles.list

spanner.databases.useRoleBasedAccess

(roles/spanner.graphIntelligenceUser)

Access to Graph Intelligence features.

monitoring.timeSeries.create

spanner.databases.beginReadOnlyTransaction

spanner.databases.get

spanner.databases.getDdl

spanner.databases.partitionQuery

spanner.databases.partitionRead

spanner.databases.read

spanner.databases.runGraphAlgorithms

spanner.databases.select

spanner.databases.useDataBoost

spanner.instancePartitions.get

spanner.instances.get

spanner.sessions.*

  • spanner.sessions.create
  • spanner.sessions.delete
  • spanner.sessions.get
  • spanner.sessions.list

(roles/spanner.restoreAdmin)

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:

  • Instance
  • Database

monitoring.timeSeries.list

resourcemanager.projects.get

resourcemanager.projects.list

spanner.backups.get

spanner.backups.list

spanner.backups.restoreDatabase

spanner.databaseOperations.*

  • spanner.databaseOperations.cancel
  • spanner.databaseOperations.get
  • spanner.databaseOperations.list

spanner.databases.create

spanner.databases.get

spanner.databases.list

spanner.instancePartitions.get

spanner.instancePartitions.list

spanner.instances.createTagBinding

spanner.instances.deleteTagBinding

spanner.instances.get

spanner.instances.list

spanner.instances.listEffectiveTags

spanner.instances.listTagBindings

Service agent roles

Service agent roles should only be granted to service agents.

Role Permissions

(roles/spanner.serviceAgent)

Cloud Spanner API Service Agent

aiplatform.endpoints.get

aiplatform.endpoints.list

aiplatform.endpoints.predict

aiplatform.models.get

aiplatform.models.list

compute.disks.create

compute.disks.createTagBinding

compute.disks.use

compute.instances.create

compute.instances.createTagBinding

compute.instances.delete

compute.instances.get

compute.instances.setLabels

compute.instances.setMetadata

compute.instances.setServiceAccount

compute.networks.create

compute.networks.use

compute.networks.useExternalIp

compute.subnetworks.create

compute.subnetworks.use

compute.subnetworks.useExternalIp

discoveryengine.rankingConfigs.rank

logging.logEntries.create

run.jobs.run

run.routes.invoke

spanner.databases.beginOrRollbackReadWriteTransaction

spanner.databases.beginReadOnlyTransaction

spanner.databases.partitionQuery

spanner.databases.select

spanner.databases.useDataBoost

spanner.databases.write

spanner.sessions.create

storage.buckets.create

storage.buckets.get

storage.buckets.list

storage.objects.create

storage.objects.delete

storage.objects.get

storage.objects.list

Rôles de base

Les rôles de base sont des rôles antérieurs à IAM qui sont attribués au niveau du projet. Pour en savoir plus, consultez Rôles de base.

Bien que Spanner soit compatible avec les rôles de base suivants, vous devez utiliser l'un des rôles prédéfinis présentés précédemment, dans la mesure du possible. Les rôles de base incluent des autorisations étendues qui s'appliquent à toutes vos ressources Google Cloud . En revanche, les rôles prédéfinis de Spanner incluent des autorisations précises qui ne s'appliquent qu'à Spanner.

Rôle de base Description
roles/editor Peut faire tout ce qu'un roles/viewer peut faire. Peut également créer, mettre à jour et supprimer des ressources Spanner, y compris des configurations d'instance personnalisées, des instances, des partitions d'instance, des bases de données, des sauvegardes et des planifications de sauvegarde, et écrire des données dans une base de données.
roles/owner Peut effectuer toutes les actions d'un roles/editor. Peut également modifier l'accès aux instances, aux bases de données, aux sauvegardes et aux planifications de sauvegarde, et associer ou dissocier des tags sur les instances.
roles/viewer Permet de répertorier et d'obtenir les métadonnées des schémas et des instances. Permet également de lire dans une base de données et de l'interroger via SQL.

Rôles personnalisés

Si les rôles prédéfinis pour Spanner ne répondent pas aux besoins de votre entreprise, vous pouvez définir vos propres rôles personnalisés en leur associant les autorisations de votre choix.

Avant de créer un rôle personnalisé, vous devez identifier les tâches que vous devez effectuer. Vous pouvez ensuite identifier les autorisations requises pour chaque tâche et les ajouter au rôle personnalisé.

Rôles personnalisés pour les tâches de compte de service

Pour la plupart des tâches, les autorisations que vous devez ajouter à votre rôle personnalisé sont évidentes. Par exemple, si vous souhaitez que votre compte de service puisse créer une base de données, ajoutez l'autorisation spanner.databases.create à votre rôle personnalisé.

Toutefois, lorsque vous lisez ou écrivez des données dans une table Spanner, vous devez ajouter plusieurs autorisations différentes à votre rôle personnalisé. Le tableau suivant indique les autorisations requises pour la lecture et l'écriture de données.

Tâche de compte de service Autorisations requises
Créer une sauvegarde spanner.backups.create
spanner.databases.createBackup
Lire des données à l'aide de requêtes SQL spanner.databases.select
spanner.sessions.create
spanner.sessions.delete
Lire des données à l'aide de l'API de lecture spanner.databases.read
spanner.sessions.create
spanner.sessions.delete
Lire des données dans une transaction en lecture seule spanner.databases.beginReadOnlyTransaction, plus les autorisations de lire des données à l'aide de requêtes SQL ou de l'API Read
Lire des données en parallèle spanner.databases.partitionQuery ou spanner.databases.partitionRead, ainsi que les autorisations de lecture des données dans une transaction en lecture seule
Restaurer une base de données spanner.backups.restoreDatabase
spanner.databases.create
Insérer, mettre à jour ou supprimer des données spanner.databases.beginOrRollbackReadWriteTransaction
spanner.sessions.create
spanner.sessions.delete
spanner.databases.write

Pour lire des données dans la même transaction, ajoutez également spanner.databases.select ou spanner.databases.read.
Mettre à jour ou supprimer des données à l'aide du LMD partitionné spanner.databases.beginPartitionedDmlTransaction
spanner.databases.write
spanner.sessions.create
spanner.sessions.delete

Rôles personnalisés pour les tâches de la console Google Cloud

Pour identifier la liste des autorisations dont vous avez besoin pour une tâche donnée dans la consoleGoogle Cloud , vous devez déterminer le workflow de cette tâche et compiler les autorisations pour ce workflow. Par exemple, pour afficher les données d'une table, procédez comme suit dans la console Google Cloud  :

Étape Autorisations
1. Accéder au projet resourcemanager.projects.get
2. Afficher la liste des instances spanner.instances.list, spanner.instanceConfigs.list
3. Sélectionner une instance spanner.instances.get, spanner.instanceConfigs.list, spanner.databases.list
4. Afficher la liste des bases de données spanner.databases.list
5. Sélectionner une base de données et une table spanner.databases.getDdl, spanner.databases.select, spanner.databases.beginReadOnlyTransaction, spanner.sessions.create
6. Afficher les données d'une table spanner.databases.select, spanner.databases.beginReadOnlyTransaction, spanner.sessions.create, spanner.sessions.delete

Dans cet exemple, les autorisations requises sont les suivantes :

  • resourcemanager.projects.get
  • spanner.databases.beginReadOnlyTransaction
  • spanner.databases.getDdl
  • spanner.databases.list
  • spanner.databases.select
  • spanner.instanceConfigs.list
  • spanner.instances.get
  • spanner.instances.list
  • spanner.sessions.create
  • spanner.sessions.delete

Le tableau suivant recense les autorisations requises pour les actions dans la consoleGoogle Cloud .

Autorisations Action
spanner.databases.setIamPolicy Ajouter des comptes principaux dans l'onglet "Autorisations" de la page "Détails de la base de données"
spanner.instances.setIamPolicy Ajouter des comptes principaux dans l'onglet "Autorisations" de la page "Instances"
spanner.backups.setIamPolicy Ajouter des comptes principaux à une sauvegarde à partir du panneau des autorisations sur la page "Sauvegardes/Restaurations"
spanner.backups.create
spanner.databases.createBackup
spanner.databases.list1
spanner.backupOperations.list1
Créer une sauvegarde
spanner.backupSchedules.create
spanner.databases.createBackup
Créez un planning de sauvegardes
spanner.databases.create
spanner.databases.get
spanner.databaseOperations.get
spanner.databaseOperations.list
Créer une base de données
spanner.instancePartitions.list
spanner.instanceConfigs.list
spanner.instancePartitionOperations.get
spanner.instancePartitions.create
Créer une partition d'instance
spanner.databaseOperations.get
spanner.databaseOperations.list
spanner.databases.updateDdl
Créer une table
Mettre à jour un schéma de table
spanner.instanceConfigs.list
spanner.instanceOperations.get
spanner.instances.create
Créer une instance
spanner.backups.delete Supprimer une sauvegarde
spanner.backupSchedules.delete Supprimer une planification de sauvegarde
spanner.databases.drop Supprimer une base de données
spanner.instancePartitions.list
spanner.instancePartitionOperations.get
spanner.instancePartitions.delete
Supprimer une partition d'instance
spanner.instances.delete Supprimer une instance
spanner.instancePartitions.list
spanner.instanceConfigs.list
spanner.instancePartitionOperations.get
spanner.instancePartitions.update
Modifier une partition d'instance
spanner.instanceOperations.get
spanner.instances.update
Modifier une instance
spanner.databases.beginOrRollbackReadWriteTransaction
spanner.databases.select
spanner.databases.write
spanner.sessions.create
spanner.sessions.delete
Modifier des données dans une table
spanner.instanceConfigs.list
spanner.instances.get
spanner.backups.get
spanner.backups.restoreDatabase
spanner.instances.list
spanner.databases.create
Restaurer une base de données à partir d'une sauvegarde
spanner.databases.get
spanner.databases.getDdl
spanner.databases.select
spanner.databases.beginReadOnlyTransaction
spanner.sessions.create
Sélectionner une base de données dans la liste et afficher son schéma sur la page "Détails de la base de données"
spanner.instances.get
spanner.instanceConfigs.list
spanner.databases.list
Sélectionner une instance dans la liste des instances pour afficher la page "Détails de l'instance"
spanner.backups.get
spanner.backups.update
Mettre à jour une sauvegarde
spanner.backupSchedules.update Mettre à jour une planification de sauvegarde
spanner.databases.select
spanner.databases.beginReadOnlyTransaction
spanner.sessions.create
spanner.sessions.delete
Afficher les données dans l'onglet "Données" de la page d'informations de la base de données
Créer et exécuter une requête
spanner.backups.list
spanner.backups.get
Afficher la page "Sauvegarder/Restaurer"
monitoring.metricDescriptors.get
monitoring.metricDescriptors.list
monitoring.timeSeries.list
spanner.instances.get
Afficher les graphiques présents dans l'onglet "Surveillance" de la page "Détails de l'instance" ou de la page "Détails de la base de données"
spanner.backupOperations.list Afficher la liste des opérations de sauvegarde
spanner.databases.list Afficher la liste des bases de données présente sur la page "Détails de l'instance"
resourcemanager.projects.get
spanner.instances.list
spanner.instanceConfigs.list
Afficher la liste des instances sur la page "Instances"
spanner.backups.getIamPolicy Afficher la liste des comptes principaux pour une sauvegarde dans le panneau des autorisations de la page "Sauvegarde/Restauration"
spanner.databaseOperations.list Afficher la liste des opérations de restauration
spanner.databases.getIamPolicy Afficher la liste présente dans l'onglet "Autorisations" de la page "Détails de la base de données"
spanner.instances.getIamPolicy Afficher la liste présente dans l'onglet "Autorisations" de la page "Instances"
1 Obligatoire si vous créez une sauvegarde à partir de la page Sauvegarde/Restauration au niveau de l'instance plutôt qu'au niveau de la base de données.

Gestion des stratégies IAM Spanner

Vous pouvez obtenir, définir et tester des stratégies IAM à l'aide des API REST ou RPC sur les ressources d'instance, de base de données, de sauvegarde et de planification de sauvegarde Spanner. Vous pouvez également tester les autorisations sur les rôles de base de données.

Instances

API REST API RPC
projects.instances.getIamPolicy GetIamPolicy
projects.instances.setIamPolicy SetIamPolicy
projects.instances.testIamPermissions TestIamPermissions

Bases de données

API REST API RPC
projects.instances.databases.getIamPolicy GetIamPolicy
projects.instances.databases.setIamPolicy SetIamPolicy
projects.instances.databases.testIamPermissions TestIamPermissions

Sauvegardes

API REST API RPC
projects.instances.backups.getIamPolicy GetIamPolicy
projects.instances.backups.setIamPolicy SetIamPolicy
projects.instances.backups.testIamPermissions TestIamPermissions

Planifications de sauvegarde

API REST API RPC
projects.instances.databases.backupSchedules.getIamPolicy GetIamPolicy
projects.instances.databases.backupSchedules.setIamPolicy SetIamPolicy
projects.instances.databases.backupSchedules.testIamPermissions TestIamPermissions

Rôles de base de données

Les rôles de base de données ne sont compatibles qu'avec les autorisations de test. Vous ne pouvez pas obtenir ni définir de stratégie IAM sur un rôle de base de données.

API REST API RPC
projects.instances.databases.databaseRoles.testIamPermissions TestIamPermissions

Étapes suivantes