Autorizzazioni IAM Dataplex

Le autorizzazioni Dataplex consentono agli utenti di eseguire azioni specifiche Servizi, risorse e operazioni Dataplex. Ad esempio: l'autorizzazione dataplex.datascans.create consente a un utente di creare Analisi dei dati Dataplex nel progetto. Non fornisci direttamente agli utenti permissions; devi assegnare loro dei ruoli, che dispongono di una o più autorizzazioni in bundle al loro interno.

Questo documento è incentrato sulle autorizzazioni IAM pertinenti per Dataplex. Per saperne di più sui ruoli Dataplex predefiniti le autorizzazioni di cui dispongono, consulta Ruoli IAM Dataplex.

Prima di iniziare

Leggi la documentazione di IAM.

Set di criteri IAM e ottieni autorizzazioni

La tabella seguente elenca le autorizzazioni necessarie per ottenere e impostare IAM autorizzazioni:

Risorsa	Metodo API	Autorizzazione IAM
Tipi di voci	GetIamPolicy	dataplex.entryTypes.getIamPolicy
Tipi di voci	SetIamPolicy	dataplex.entryTypes.setIamPolicy
Tipi di aspetto	GetIamPolicy	dataplex.aspectTypes.getIamPolicy
Tipi di aspetto	SetIamPolicy	dataplex.aspectTypes.setIamPolicy
Gruppi di voci	GetIamPolicy	dataplex.entryGroups.getIamPolicy
Gruppi di voci	SetIamPolicy	dataplex.entryGroups.setIamPolicy
Lake	GetIamPolicy	dataplex.lakes.getIamPolicy
Lake	SetIamPolicy	dataplex.lakes.setIamPolicy

Autorizzazioni Dataplex Catalog

L'insieme di autorizzazioni necessarie per eseguire operazioni sui tipi di voce, tipi di aspetto, gruppi di voci e voci dipendono dal fatto che le risorse di sistema o di risorse personalizzate. Le risorse di sistema sono definite Dataplex e le risorse personalizzate vengono definiti da te o dal tuo dell'organizzazione.

Per eseguire operazioni correlate a più risorse (ad esempio, creare una voce di un determinato tipo o aggiungere un aspetto un determinato tipo di aspetto a una voce), potresti aver bisogno di più autorizzazioni associate alle risorse.

Tipi di voci

Per creare e gestire i tipi di voce, devi disporre almeno del livello standard Autorizzazioni create, get, list, update e delete.

Quando crei un tipo di voce, devi disporre delle autorizzazioni per utilizzare ogni tipo di aspetto che vuoi contrassegnare come obbligatorio per quel tipo di voce.

Per utilizzare un tipo di voce (ad esempio, per creare voci di un tipo), devi avere ottenuto l'autorizzazione use per il tipo di voce.

La tabella seguente elenca le autorizzazioni necessarie per operare su tipi di voce:

Operazione	Autorizzazioni richieste per i tipi di voce personalizzata
Elenco tipi di voci	dataplex.entryTypes.list
Ottieni tipi di voce	dataplex.entryTypes.get
Crea tipi di voce	dataplex.entryTypes.create dataplex.aspectTypes.use (per ogni tipo di aspetto obbligatorio nel tipo di voce) dataplex.entryGroups.useASPECT_TYPE (per ogni tipo di aspetto di sistema richiesto nel tipo di voce). Consulta le autorizzazioni per i tipi di aspetto del sistema.
Aggiorna tipi di voce	dataplex.entryTypes.update dataplex.aspectTypes.use (per ogni tipo di aspetto obbligatorio nel tipo di voce) dataplex.entryGroups.useASPECT_TYPE (per ogni tipo di aspetto di sistema richiesto nel tipo di voce). Consulta le autorizzazioni per i tipi di aspetto del sistema.
Elimina tipi di voce	dataplex.entryTypes.delete dataplex.aspectTypes.use (per i tipi di aspetto obbligatori nei tipi di voce) dataplex.entryGroups.useASPECT_TYPE (per ogni tipo di aspetto di sistema richiesto nel tipo di voce). Consulta le autorizzazioni per i tipi di aspetto del sistema.
Utilizza i tipi di voce (durante la creazione di voci, l'aggiornamento dei campi di immissione di primo livello e i valori del tipo di aspetto obbligatori)	dataplex.entryTypes.use dataplex.entries.create o dataplex.entries.update dataplex.aspectTypes.use (per ogni aspetto creato o aggiornato)

Tipi di aspetto

Per creare e gestire i tipi di aspetto, devi disporre dello standard create, Autorizzazioni get, list, update e delete.

Per utilizzare un tipo di aspetto (ad esempio, per associarlo come aspetto facoltativo in una ), devi disporre dell'autorizzazione use per il tipo di aspetto.

I tipi di aspetto sono classificati in tipi di aspetto di sistema e tipi di aspetto personalizzati. I tipi di aspetto del sistema vengono creati da Dataplex e dall'aspetto personalizzato vengono creati da te o dalla tua organizzazione. I tipi di aspetto di sistema sono ulteriormente classificati in utilizzabili e di sola lettura. Per ulteriori informazioni, vedi Categorie di tipi di aspetto.

La tabella seguente elenca le autorizzazioni necessarie per operare su personalizzati e di sistema:

Operazione	Autorizzazioni richieste per i tipi di aspetto personalizzato	Autorizzazioni richieste per i tipi di aspetto di sistema utilizzabili	Autorizzazioni richieste per i tipi di aspetto di sistema di sola lettura
Elenca tipi di aspetto	dataplex.aspectTypes.list	Non applicabile (N/A)	N/D
Visualizza tipi di aspetto	dataplex.aspectTypes.get	Concesso a allUsers	Concesso a allUsers
Crea tipi di aspetto	dataplex.aspectTypes.create	N/D	N/D
Aggiorna tipi di aspetto	dataplex.aspectTypes.update	N/D	N/D
Elimina tipi di aspetto	dataplex.aspectTypes.delete	N/D	N/D
Imposta valori facoltativi del tipo di aspetto durante la creazione o l'aggiornamento delle voci	dataplex.aspectTypes.use dataplex.entries.create o dataplex.entries.update	dataplex.entryGroups.useASPECT_TYPE. Consulta le autorizzazioni per i tipi di aspetto di sistema. dataplex.entries.create o dataplex.entries.update	N/D
Imposta i valori del tipo di aspetto obbligatori durante la creazione o l'aggiornamento delle voci	dataplex.aspectTypes.use dataplex.entryTypes.use dataplex.entries.create o dataplex.entries.update	dataplex.entryGroups.useASPECT_TYPE. Consulta le autorizzazioni per i tipi di aspetto di sistema. dataplex.entryTypes.use dataplex.entries.create o dataplex.entries.update	N/D

Gruppi di voci

Per creare e gestire i gruppi di voci, devi disporre dello standard create, Autorizzazioni get, list, update e delete.

Nota: non puoi modificare i gruppi di voci di sistema i cui nomi iniziano con @ come @bigquery. Puoi aggiungere aspetti facoltativi solo alle voci in come gruppi di voci.

I gruppi di voci sono classificati in gruppi di voci di sistema creati Dataplex e gruppi di voci personalizzate, creati da te o dell'organizzazione. Per ulteriori informazioni, vedi Categorie di gruppi di voci.

La tabella seguente elenca le autorizzazioni necessarie per operare su gruppi di voci:

Operazione	Autorizzazioni richieste per i gruppi di voci personalizzate	Autorizzazioni richieste per i gruppi di voci di sistema (che iniziano con @)
Crea gruppi di voci	dataplex.entryGroups.create	N/D
Aggiorna gruppi di voci	dataplex.entryGroups.update	N/D
Elimina gruppi di voci	dataplex.entryGroups.delete	N/D
Elenco gruppi di voci	dataplex.entryGroups.list	dataplex.entryGroups.list
Ottieni gruppi di voci	dataplex.entryGroups.get	dataplex.entryGroups.get

Voci

Per creare e gestire le voci, devi disporre dello standard create, Autorizzazioni get, list, update e delete.

Tieni presente quanto segue:

• Per i metodi di ricerca (LookupEntry) e di ricerca (SearchEntries), il valore è richiesta l'autorizzazione del sistema di origine originale. Per Ad esempio, se l'origine è una tabella BigQuery, devi Autorizzazione bigquery.tables.get.
• Quando crei una voce o aggiorni i relativi campi di primo livello, devi concedere l'autorizzazione use per il tipo di voce.
• Quando crei, aggiorni o elimini un aspetto obbligatorio, devi ricevere l'autorizzazione use per il tipo di voce di una voce, nonché sulla tipo di aspetto sottostante. Questo perché gli aspetti obbligatori vengono applicati il tipo di voce.
• Quando crei, aggiorni o elimini un aspetto facoltativo, devi disporre l'autorizzazione use per il tipo di aspetto di un aspetto.
• Quando esegui l'upsert di una voce (UpdateEntry con allow_missing = True), devi concedere l'autorizzazione create.

Per ulteriori informazioni sui tipi di voce su cui si basano le voci, consulta Categorie di tipi di voce.

La tabella seguente elenca le autorizzazioni necessarie per operare su voci:

Operazione	Voce basata sul tipo di voce personalizzata	Voce basata sul tipo di voce di sistema utilizzabile	Voce basata sul tipo di voce di sistema di sola lettura
Crea voci	dataplex.entries.create dataplex.entryTypes.use dataplex.aspectTypes.use (per ogni aspetto creato) dataplex.entryGroups.useASPECT_TYPE (per creato ogni aspetto di un tipo di aspetto di sistema utilizzabile). Consulta le autorizzazioni per i tipi di aspetto del sistema.	dataplex.entries.create dataplex.entryGroups.useENTRY_TYPE. Consulta le autorizzazioni per i tipi di voci di sistema. dataplex.entryGroups.useASPECT_TYPE (per ogni aspetto di sistema creato). Consulta le autorizzazioni per i tipi di aspetto del sistema. dataplex.aspectTypes.use (per ogni aspetto personalizzato creato)	N/D
Aggiornamento voci	dataplex.entries.update dataplex.entryTypes.use (per aggiornare i campi di primo livello o gli aspetti obbligatori) dataplex.aspectTypes.utilizzo (per ogni aspetto aggiornato) dataplex.entryGroups.useASPECT_TYPE (per ogni aspetto di sistema aggiornato). Consulta le autorizzazioni per i tipi di aspetto del sistema. dataplex.entries.create (se allow_missing è True)	dataplex.entries.update dataplex.entryGroups.useENTRY_TYPE (per l'aggiornamento campi di primo livello o aspetti obbligatori). Consulta le autorizzazioni per i tipi di voci di sistema. dataplex.aspectTypes.use (per ogni aspetto personalizzato aggiornato) dataplex.entryGroups.useASPECT_TYPE (per ogni aspetto che appartiene ai tipi di aspetto del sistema). Consulta le autorizzazioni per i tipi di aspetto del sistema. dataplex.entries.create (se allow_missing è True)	dataplex.entries.update dataplex.aspectTypes.use (per ogni aspetto personalizzato aggiornato) dataplex.entryGroups.useASPECT_TYPE (per aggiornato ogni aspetto di un tipo di aspetto di sistema utilizzabile). Consulta le autorizzazioni per i tipi di aspetto del sistema. I campi di primo livello e gli aspetti obbligatori non possono essere modificati.
Elenco voci	dataplex.entries.list	dataplex.entries.list	dataplex.entries.list
Ottieni voci	dataplex.entries.get	dataplex.entries.get	dataplex.entries.get
Cerca voci	Autorizzazione di lettura del sistema di origine originale. Per le voci personalizzate, questo valore è dataplex.entries.get, perché Dataplex viene considerato il sistema di origine originale.	Autorizzazione di lettura del sistema di origine originale. Per le voci personalizzate, questo valore è dataplex.entries.get, perché Dataplex viene considerato il sistema di origine originale.	Autorizzazione di lettura del sistema di origine originale. Per le voci personalizzate, questo valore è dataplex.entries.get, perché Dataplex viene considerato il sistema di origine originale.
Cerca voci	Autorizzazione di lettura del sistema di origine originale. Per le voci personalizzate, questo valore è dataplex.entries.get, perché Dataplex viene considerato il sistema di origine originale.	Autorizzazione di lettura del sistema di origine originale. Per le voci personalizzate, questo valore è dataplex.entries.get, perché Dataplex viene considerato il sistema di origine originale.	Autorizzazione di lettura del sistema di origine originale. Per le voci personalizzate, questo valore è dataplex.entries.get, perché Dataplex viene considerato il sistema di origine originale.

Tipi di aspetto del sistema e tipi di voce

Ogni tipo di aspetto definito dal sistema e tipo di voce definito dal sistema ha il proprio IAM autorizzazioni aggiuntive. Queste autorizzazioni usano un formato come dataplex.entryGroups.useASPECT_TYPE o dataplex.entryGroups.useENTRY_TYPE. Ad esempio, l'autorizzazione per il tipo di aspetto di sistema overview è dataplex.entryGroups.useOverviewAspect.

La tabella seguente elenca le autorizzazioni che si applicano all'aspetto definito dal sistema e i tipi di voce.

Risorsa	Autorizzazioni IAM
schema (tipo di aspetto di sistema)	dataplex.entryGroups.useSchemaAspect
contacts (tipo di aspetto di sistema)	dataplex.entryGroups.useContactsAspect
overview (tipo di aspetto di sistema)	dataplex.entryGroups.useOverviewAspect
generic (tipo di aspetto di sistema)	dataplex.entryGroups.useGenericAspect
generic (tipo di voce di sistema)	dataplex.entryGroups.useGenericEntry

Autorizzazioni per lake, zone e asset

La tabella seguente elenca le autorizzazioni necessarie per operare su lake, zone e asset:

Metodo API	Autorizzazione 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

Autorizzazioni attività

La tabella seguente elenca le autorizzazioni necessarie per operare su attività:

Metodo API	Autorizzazione 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

Autorizzazioni per l'ambiente

La tabella seguente elenca le autorizzazioni necessarie per operare su ambienti:

Metodo API	Autorizzazione 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

Autorizzazioni dei metadati

La tabella seguente elenca le autorizzazioni necessarie per operare su entità e partizioni:

Metodo API	Autorizzazione 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

Autorizzazioni per la scansione dei dati

La tabella seguente elenca le autorizzazioni necessarie per operare su scansioni dei dati:

Metodo API	Autorizzazione IAM
CreateDataScan	dataplex.datascans.create
UpdateDataScan	dataplex.datascans.update
DeleteDataScan	dataplex.datascans.delete
ListDataScans	dataplex.datascans.list
GetDataScan (visualizzazione di base)	dataplex.datascans.get
GetDataScan (visualizzazione completa)	dataplex.datascans.getData
ListDataScanJobs	dataplex.datascans.get
GetDataScanJob (visualizzazione di base)	dataplex.datascans.get
GetDataScanJob (visualizzazione completa)	dataplex.datascans.getData
RunDataScan	dataplex.datascans.run