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 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 section Rôles IAM Dataplex.

Pour une description détaillée d'IAM et de ses fonctionnalités, consultez la documentation IAM.

Autorisations de stratégie IAM Set et Get

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 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é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 moins 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 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 d'entrée), vous devez disposer de l'autorisation use pour ce type d'entrée.

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

Operation	Autorisations requises pour les types d'entrées personnalisés
Répertorier les types d'entrées	dataplex.entryTypes.list
Obtenir des 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 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 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 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 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é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.
Utiliser les types d'entrée (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'aspects système et types d'aspects 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 : "utilisable" et "en lecture seule". Pour en savoir plus, consultez la section Catégories de types d'aspects.

Le tableau suivant répertorie les autorisations requises pour travailler sur les 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 des types d'aspects	dataplex.aspectTypes.get	Accordée à allUsers	Accordée à 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 facultatives pour le type d'aspect lors de la création ou de la mise à jour d'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, créés par Dataplex, et en groupes d'entrées personnalisés, créés par vous ou par 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 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 des 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 pour l'entrée. Par exemple, si la source est une table BigQuery, vous avez besoin 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 obligatoire, vous devez disposer de 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 obligatoires sont appliqués par 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 effectuez une mise à jour incrémentielle d'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 les entrées sont basé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 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 système utilisable créé). Consultez les 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 les 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 les 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 chaque aspect d'un type d'aspect système utilisable mis à jour). Consultez les autorisations pour les types d'aspects système. Les champs de premier niveau et les aspects obligatoires 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
Entrées de recherche	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 utiliser les tâches 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ée personnalisés dans le champ d'application de la tâche) dataplex.entryTypes.useENTRY_TYPE (pour chaque type d'entrée système dans le champ d'application de la tâche). Consultez les autorisations pour les types d'entrées système. dataplex.aspectTypes.use (pour les types d'aspects personnalisés dans le champ d'application de la tâche) 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 le champ d'application de la tâche)
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 de 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'aspects 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 pour les lacs, les zones et les éléments

Le tableau suivant répertorie les autorisations requises pour effectuer des opérations sur les lacs, les zones et les 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 de l'environnement

Le tableau suivant répertorie les autorisations requises pour fonctionner dans les environnements suivants:

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 liées 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 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 (affichage standard)	dataplex.datascans.get
GetDataScan (vue complète)	dataplex.datascans.getData
ListDataScanJobs	dataplex.datascans.get
GetDataScanJob (vue standard)	dataplex.datascans.get
GetDataScanJob (vue complète)	dataplex.datascans.getData
RunDataScan	dataplex.datascans.run