Autorisations IAM de Dataplex

Les autorisations Dataplex permettent aux utilisateurs d'effectuer des actions spécifiques sur les services, les ressources et les 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 ne donnez pas directement aux utilisateurs autorisations ; vous leur accordez des rôles, qui disposent d'une ou plusieurs autorisations regroupés.

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, 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 IAM autorisations:

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 d'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 dépend de la nature des ressources (système ou personnalisées). Les ressources système sont définies par Dataplex et les ressources personnalisées sont définis 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 Autorisations 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 obligatoire 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 nécessaires pour fonctionner sur types d'entrées:

Operation Autorisations requises pour les types d'entrées personnalisées
Répertorier les types d'entrées 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 le 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 obligatoire 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 le 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 le 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 pour ce 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, tandis que les types d'aspects personnalisés sont créés par vous ou votre organisation. Les types d'aspects système sont ensuite classés en deux catégories : utilisables et en lecture seule. Pour en savoir plus, consultez Catégories de types d'aspects.

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

Operation Autorisations requises pour les types d'aspects personnalisés Autorisations requises pour les types d'aspects système utilisables Autorisations requises pour les types d'aspects système en lecture seule
Répertorier les types d'aspects dataplex.aspectTypes.list Non applicable (N/A) N/A
Obtenir les types d'aspects dataplex.aspectTypes.get Accordée à allUsers Accordé à allUsers
Créer des types d'aspects dataplex.aspectTypes.create N/A N/A
Mettre à jour les types d'aspects dataplex.aspectTypes.update N/A N/A
Supprimer des types d'aspects dataplex.aspectTypes.delete N/A N/A
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 les autorisations pour les types d'aspects système.

dataplex.entries.create ou dataplex.entries.update

 N/A
Définir les valeurs de type d'aspect requises lors de la création ou de la mise à jour d'enregistrements

dataplex.aspectTypes.use

dataplex.entryTypes.use

dataplex.entries.create ou dataplex.entries.update

dataplex.entryGroups.useASPECT_TYPE. Consultez les autorisations pour les types d'aspects système.

dataplex.entryTypes.use

dataplex.entries.create ou dataplex.entries.update

 N/A

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, qui sont créés par Dataplex et les groupes d'entrées personnalisés, que vous ou votre organisation. Pour en savoir plus, consultez Catégories de groupes d'entrées.

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

Operation 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 N/A
Mettre à jour les groupes d'entrées dataplex.entryGroups.update N/A
Supprimer des groupes d'entrées dataplex.entryGroups.delete N/A
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 create standards, Autorisations 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 pour l'entrée. Pour Par exemple, si la source est une table BigQuery, 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 disposer l'autorisation use sur le type d'entrée d'une entrée, ainsi que sur type d'aspect sous-jacent. En effet, les aspects requis sont appliqués le type d'entrée.
  • Lorsque vous créez, modifiez ou supprimez un aspect facultatif, vous devez disposer de l'autorisation use sur le type d'aspect.
  • Lorsque vous insérez une entrée (UpdateEntry avec allow_missing = True), vous doit disposer de l'autorisation create.

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

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

Operation Entrée basée sur un type d'entrée personnalisé Entrée en fonction du type d'entrée 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 de système utilisable créé). Consultez le autorisations pour les types d'aspects système.

dataplex.entries.create

dataplex.entryGroups.useENTRY_TYPE. Consultez les autorisations pour les types d'entrée système.

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

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

 N/A
Entrées de mise à jour

dataplex.entries.update

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

dataplex.aspectTypes.use (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 True)

dataplex.entries.update

dataplex.entryGroups.useENTRY_TYPE (pour mettre à jour les champs de premier niveau ou les aspects obligatoires). Consultez le 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 appartenant aux types d'aspects système). Consultez les autorisations pour les types d'aspects système.

dataplex.entries.create (si allow_missing est True)

dataplex.entries.update

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

dataplex.entryGroups.useASPECT_TYPE (pour tous les aspects d'un type d'aspect de système utilisable mis à jour). Consultez le 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 traité comme 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 traité comme 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 traité comme 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 traité comme 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 traité comme 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 traité comme le système source d'origine.

Autorisations des tâches de métadonnées

Le tableau suivant répertorie les autorisations requises pour travailler avec Jobs de métadonnées:

Operation Autorisation IAM
Créer des tâches de métadonnées

dataplex.metadataJobs.create

dataplex.entryTypes.use (pour les types d'entrées personnalisés dans du champ d'application du job)

dataplex.entryTypes.useENTRY_TYPE (pour chaque type d'entrée système dans le champ d'application du job). Consultez les autorisations pour les types d'entrées système.

dataplex.aspectTypes.use (pour les types d'aspects personnalisés dans du champ d'application du job)

dataplex.aspectTypes.useASPECT_TYPE (pour chaque type d'aspect système dans le champ d'application de la tâche). Consultez les autorisations pour les types d'aspects système.

dataplex.entryGroups.import (pour les groupes d'entrées dans du champ d'application du job)

Obtenir des tâches de métadonnées

dataplex.metadataJobs.get
Répertorier les tâches de métadonnées

dataplex.metadataJobs.list
Annuler des tâches de métadonnées

dataplex.metadataJobs.cancel

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

Chaque type d'aspect et de saisie 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'aspect et de saisie 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 composants :

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 des tâches

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur les 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 fonctionner dans les 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 nécessaires pour fonctionner sur entités et 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 des données

Le tableau suivant répertorie les autorisations requises pour 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 standard) dataplex.datascans.get
GetDataScan (vue complète) dataplex.datascans.getData
ListDataScanJobs dataplex.datascans.get
GetDataScanJob (vue de base) dataplex.datascans.get
GetDataScanJob (vue complète) dataplex.datascans.getData
RunDataScan dataplex.datascans.run