Autorisations IAM de Dataplex

Les autorisations Dataplex permettent aux utilisateurs d'effectuer des actions spécifiques sur les services, ressources et opérations Dataplex. Par exemple, l'autorisation dataplex.datascans.create permet à un utilisateur de créer des analyses de données Dataplex dans votre projet. Vous n'accordez pas directement des autorisations aux utilisateurs, mais vous leur attribuez des rôles auxquels sont associées une ou plusieurs autorisations.

Ce document porte sur les autorisations IAM pertinentes pour Dataplex. Pour en savoir plus sur les rôles Dataplex prédéfinis et les autorisations qu'ils contiennent, consultez la page Rôles IAM Dataplex.

Avant de commencer

Consultez la documentation IAM.

Définir et obtenir des autorisations de stratégie IAM

Le tableau suivant répertorie les autorisations requises pour obtenir et définir des autorisations IAM:

Ressource Méthode API Autorisation IAM
Types d'entrées GetIamPolicy dataplex.entryTypes.getIamPolicy
Types d'entrées SetIamPolicy dataplex.entryTypes.setIamPolicy
Types d'aspects GetIamPolicy dataplex.aspectTypes.getIamPolicy
Types d'aspects SetIamPolicy dataplex.aspectTypes.setIamPolicy
Groupes d'entrées GetIamPolicy dataplex.entryGroups.getIamPolicy
Groupes d'entrées SetIamPolicy dataplex.entryGroups.setIamPolicy
Lacs GetIamPolicy dataplex.lakes.getIamPolicy
Lacs SetIamPolicy dataplex.lakes.setIamPolicy

Autorisations du catalogue Dataplex

L'ensemble des autorisations requises pour effectuer des opérations sur les types d'entrées, les types d'aspects, les groupes d'entrées et les entrées varie selon qu'il s'agit de ressources système ou de ressources personnalisées. Les ressources système sont définies par Dataplex, tandis que les ressources personnalisées sont définies par vous ou votre organisation.

Pour effectuer des opérations liées à plusieurs ressources (par exemple, créer une entrée d'un type d'entrée particulier ou ajouter un aspect d'un type d'aspect particulier à une entrée), vous devrez peut-être disposer de plusieurs autorisations associées aux ressources.

Types d'entrées

Pour créer et gérer des types d'entrées, vous devez disposer au minimum des autorisations standards create, get, list, update et delete.

Lorsque vous créez un type d'entrée, vous devez disposer des autorisations nécessaires pour utiliser chaque type d'aspect que vous souhaitez marquer comme requis pour ce type d'entrée.

Pour utiliser un type d'entrée (par exemple, pour créer des entrées d'un type spécifique), vous devez disposer de l'autorisation use sur le type d'entrée.

Le tableau suivant répertorie les autorisations requises pour les opérations sur les types d'entrées:

Opération Autorisations requises pour les types d'entrées personnalisées
Types d'entrées de liste dataplex.entryTypes.list
Obtenir les types d'entrées dataplex.entryTypes.get
Créer des types d'entrées

dataplex.entryTypes.create

dataplex.aspectTypes.use (pour chaque type d'aspect requis dans le type d'entrée)

dataplex.entryGroups.useASPECT_TYPE (pour chaque type d'aspect système requis dans le type d'entrée). Consultez les autorisations pour les types d'aspects système.
Mettre à jour les types d'entrées

dataplex.entryTypes.update

dataplex.aspectTypes.use (pour chaque type d'aspect requis dans le type d'entrée)

dataplex.entryGroups.useASPECT_TYPE (pour chaque type d'aspect système requis dans le type d'entrée). Consultez les autorisations pour les types d'aspects système.
Supprimer des types d'entrées

dataplex.entryTypes.delete

dataplex.aspectTypes.use (pour les types d'aspects obligatoires dans les types d'entrées)

dataplex.entryGroups.useASPECT_TYPE (pour chaque type d'aspect système requis dans le type d'entrée). Consultez les autorisations pour les types d'aspects système.

Utiliser des types d'entrées

(lors de la création d'entrées, de la mise à jour des champs d'entrée de premier niveau et des valeurs de type d'aspect requises)

dataplex.entryTypes.use

dataplex.entries.create ou dataplex.entries.update

dataplex.aspectTypes.use (pour chaque aspect créé ou mis à jour)

Types d'aspects

Pour créer et gérer des types d'aspects, vous devez disposer des autorisations standards create, get, list, update et delete.

Pour utiliser un type d'aspect (par exemple, pour l'associer en tant qu'aspect facultatif à une entrée), vous devez disposer de l'autorisation use sur le type d'aspect.

Les types d'aspects sont classés en types d'aspect système et types d'aspect personnalisés. Les types d'aspects système sont créés par Dataplex, et les types d'aspect personnalisés sont créés par vous ou votre organisation. Les types d'aspects système sont davantage catégorisés dans les catégories "Utilisable" et "Lecture seule". Pour en savoir plus, consultez la section Catégories de types d'aspects.

Le tableau suivant répertorie les autorisations requises pour les types d'aspects personnalisés et système:

Opération Autorisations requises pour les types d'aspects personnalisés Autorisations requises pour les types d'aspects du système utilisables Autorisations requises pour les types d'aspects système en lecture seule
Lister les types d'aspects dataplex.aspectTypes.list Non applicable (N/A) Non disponible
Obtenir les types d'aspects dataplex.aspectTypes.get Accordé à allUsers Accordé à allUsers
Créer des types d'aspects dataplex.aspectTypes.create Non disponible Non disponible
Mettre à jour les types d'aspects dataplex.aspectTypes.update Non disponible Non disponible
Supprimer des types d'aspects dataplex.aspectTypes.delete Non disponible Non disponible
Définir des valeurs de type d'aspect facultatives lors de la création ou de la mise à jour des entrées

dataplex.aspectTypes.use

dataplex.entries.create ou dataplex.entries.update

dataplex.entryGroups.useASPECT_TYPE. Consultez la section Autorisations pour les types d'aspects système.

dataplex.entries.create ou dataplex.entries.update

 Non disponible
Définir les valeurs de type d'aspect requises lors de la création ou de la mise à jour des entrées

dataplex.aspectTypes.use

dataplex.entryTypes.use

dataplex.entries.create ou dataplex.entries.update

dataplex.entryGroups.useASPECT_TYPE. Consultez la section Autorisations pour les types d'aspects système.

dataplex.entryTypes.use

dataplex.entries.create ou dataplex.entries.update

 Non disponible

Groupes d'entrées

Pour créer et gérer des groupes d'entrées, vous devez disposer des autorisations standards create, get, list, update et delete.

Les groupes d'entrées sont classés en groupes d'entrées système, créés par Dataplex, et en groupes d'entrées personnalisés, créés par vous ou votre organisation. Pour en savoir plus, consultez la section Catégories de groupes d'entrées.

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur des groupes d'entrées:

Opération Autorisations requises pour les groupes d'entrées personnalisés Autorisations requises pour les groupes d'entrées système (commençant par @)
Créer des groupes d'entrées dataplex.entryGroups.create Non disponible
Mettre à jour les groupes d'entrées dataplex.entryGroups.update Non disponible
Supprimer les groupes d'entrées dataplex.entryGroups.delete Non disponible
Lister les groupes d'entrée dataplex.entryGroups.list dataplex.entryGroups.list
Obtenir les groupes d'entrées dataplex.entryGroups.get dataplex.entryGroups.get

Entrées

Pour créer et gérer des entrées, vous devez disposer des autorisations standards create, get, list, update et delete.

Veuillez noter les points suivants :

  • Pour les méthodes de recherche (LookupEntry) et de recherche (SearchEntries), l'autorisation du système source d'origine est requise sur l'entrée. Par exemple, si la source est une table BigQuery, vous devez disposer de l'autorisation bigquery.tables.get.
  • Lorsque vous créez une entrée ou mettez à jour les champs de premier niveau d'une entrée, vous devez disposer de l'autorisation use pour le type d'entrée.
  • Lorsque vous créez, mettez à jour ou supprimez un aspect requis, vous devez obtenir l'autorisation use sur le type d'entrée d'une entrée, ainsi que sur le type d'aspect sous-jacent. En effet, les aspects requis sont appliqués par le type d'entrée.
  • Lorsque vous créez, mettez à jour ou supprimez un aspect facultatif, vous devez obtenir l'autorisation use sur le type d'aspect d'un aspect.
  • Lorsque vous insérez une entrée (UpdateEntry avec allow_missing = True), vous devez disposer de l'autorisation create.

Pour en savoir plus sur les types d'entrées sur lesquels sont basées les entrées, consultez la section Catégories de types d'entrées.

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur des entrées:

Opération Entrée basée sur le type d'entrée personnalisé Entrée basée sur le type d'entrée du système utilisable Entrée basée sur le type d'entrée système en lecture seule
Créer des entrées

dataplex.entries.create

dataplex.entryTypes.use

dataplex.aspectTypes.use (pour chaque aspect créé)

dataplex.entryGroups.useASPECT_TYPE (pour chaque aspect d'un type d'aspect système utilisable créé). Consultez les autorisations pour les types d'aspects système.

dataplex.entries.create

dataplex.entryGroups.useENTRY_TYPE. Consultez la section Autorisations pour les types d'entrées système.

dataplex.entryGroups.useASPECT_TYPE (pour chaque aspect système créé) Consultez les autorisations pour les types d'aspects système.

dataplex.aspectTypes.use (pour chaque aspect personnalisé créé)

 Non disponible
Mettre à jour les entrées

dataplex.entries.update

dataplex.entryTypes.use (pour mettre à jour les champs de premier niveau ou les aspects obligatoires)

dataplex.aspectTypes.d'utilisation (pour chaque aspect mis à jour)

dataplex.entryGroups.useASPECT_TYPE (pour chaque aspect du système mis à jour). Consultez les autorisations pour les types d'aspects système.

dataplex.entries.create (si allow_missing est défini sur True)

dataplex.entries.update

dataplex.entryGroups.useENTRY_TYPE (pour mettre à jour les champs de premier niveau ou les aspects requis). Consultez la section Autorisations pour les types d'entrées système.

dataplex.aspectTypes.use (pour chaque aspect personnalisé mis à jour)

dataplex.entryGroups.useASPECT_TYPE (pour chaque aspect qui appartient aux types d'aspects système) Consultez les autorisations pour les types d'aspects système.

dataplex.entries.create (si allow_missing est défini sur True)

dataplex.entries.update

dataplex.aspectTypes.use (pour chaque aspect personnalisé mis à jour)

dataplex.entryGroups.useASPECT_TYPE (mis à jour pour chaque aspect d'un type d'aspect système utilisable). Consultez les autorisations pour les types d'aspects système.

Les champs de premier niveau et les aspects requis ne peuvent pas être modifiés.
Répertorier les entrées dataplex.entries.list dataplex.entries.list dataplex.entries.list
Obtenir des entrées dataplex.entries.get dataplex.entries.get dataplex.entries.get
Rechercher des entrées

Autorisation de lecture du système source d'origine.

Pour les entrées personnalisées, il s'agit de dataplex.entries.get, car Dataplex est le système source d'origine.

Autorisation de lecture du système source d'origine.

Pour les entrées personnalisées, il s'agit de dataplex.entries.get, car Dataplex est le système source d'origine.

Autorisation de lecture du système source d'origine.

Pour les entrées personnalisées, il s'agit de dataplex.entries.get, car Dataplex est le système source d'origine.
Rechercher des entrées

Autorisation de lecture du système source d'origine.

Pour les entrées personnalisées, il s'agit de dataplex.entries.get, car Dataplex est le système source d'origine.

Autorisation de lecture du système source d'origine.

Pour les entrées personnalisées, il s'agit de dataplex.entries.get, car Dataplex est le système source d'origine.

Autorisation de lecture du système source d'origine.

Pour les entrées personnalisées, il s'agit de dataplex.entries.get, car Dataplex est le système source d'origine.

Types d'aspects système et types d'entrées

Chaque type d'aspect et d'entrée défini par le système possède ses propres autorisations IAM. Ces autorisations utilisent un format tel que dataplex.entryGroups.useASPECT_TYPE ou dataplex.entryGroups.useENTRY_TYPE. Par exemple, l'autorisation pour le type d'aspect système overview est dataplex.entryGroups.useOverviewAspect.

Le tableau suivant répertorie les autorisations qui s'appliquent aux types d'aspects et aux types d'entrées définis par le système.

Ressource Autorisation IAM
schema (type d'aspect système) dataplex.entryGroups.useSchemaAspect
contacts (type d'aspect système) dataplex.entryGroups.useContactsAspect
overview (type d'aspect système) dataplex.entryGroups.useOverviewAspect
generic (type d'aspect système) dataplex.entryGroups.useGenericAspect
generic (type d'entrée système) dataplex.entryGroups.useGenericEntry

Autorisations sur les lacs, les zones et les éléments

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur des lacs, des zones et des éléments:

Méthode API Autorisation IAM
CreateLake dataplex.lakes.create
UpdateLake dataplex.lakes.update
DeleteLake dataplex.lakes.delete
ListLakes dataplex.lakes.list
GetLake dataplex.lakes.get
ListLakeActions dataplex.lakeActions.list
CreateZone dataplex.zones.create
UpdateZone dataplex.zones.update
DeleteZone dataplex.zones.delete
ListZones dataplex.zones.list
GetZone dataplex.zones.get
ListZoneActions dataplex.zoneActions.list
CreateAsset dataplex.assets.create
UpdateAsset dataplex.assets.update
DeleteAsset dataplex.assets.delete
ListAssets dataplex.assets.list
GetAsset dataplex.assets.get
ListAssetActions dataplex.assetActions.list

Autorisations liées aux tâches

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur des tâches:

Méthode API Autorisation IAM
CreateTask dataplex.tasks.create
UpdateTask dataplex.tasks.update
DeleteTask dataplex.tasks.delete
ListTasks dataplex.tasks.list
GetTask dataplex.tasks.get
ListJobs dataplex.tasks.get
GetJob dataplex.tasks.get
CancelJob dataplex.tasks.cancel

Autorisations concernant l'environnement

Le tableau suivant répertorie les autorisations requises pour l'exploitation dans des environnements:

Méthode API Autorisation IAM
CreateEnvironment dataplex.environments.create
UpdateEnvironment dataplex.environments.update
DeleteEnvironment dataplex.environments.delete
ListEnvironments dataplex.environments.list
GetEnvironment dataplex.environments.get
CreateContent dataplex.content.create
UpdateContent dataplex.content.update
DeleteContent dataplex.content.delete
ListContent dataplex.content.list
GetContent dataplex.content.get
ListSessions dataplex.environments.get

Autorisations d'accès aux métadonnées

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur des entités et des partitions:

Méthode API Autorisation IAM
CreateEntity dataplex.entities.create
UpdateEntity dataplex.entities.update
DeleteEntity dataplex.entities.delete
GetEntity dataplex.entities.get
ListEntities dataplex.entities.list
CreatePartition dataplex.partitions.create
UpdatePartition dataplex.partitions.update
DeletePartition dataplex.partitions.delete
GetPartition dataplex.partitions.get
ListPartitions dataplex.partitions.list

Autorisations d'analyse de données

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur les analyses de données:

Méthode API Autorisation IAM
CreateDataScan dataplex.datascans.create
UpdateDataScan dataplex.datascans.update
DeleteDataScan dataplex.datascans.delete
ListDataScans dataplex.datascans.list
GetDataScan (vue de base) dataplex.datascans.get
GetDataScan (affichage complet) dataplex.datascans.getData
ListDataScanJobs dataplex.datascans.get
GetDataScanJob (vue de base) dataplex.datascans.get
GetDataScanJob (affichage complet) dataplex.datascans.getData
RunDataScan dataplex.datascans.run