Dataplex-IAM-Berechtigungen

Mit Dataplex-Berechtigungen können Nutzer bestimmte Aktionen für Dataplex-Dienste, -Ressourcen und -Vorgänge ausführen. Mit der Berechtigung dataplex.datascans.create kann ein Nutzer beispielsweise Dataplex-Datenscans in Ihrem Projekt erstellen. Sie erteilen Nutzern keine direkten Berechtigungen, sondern weisen ihnen Rollen zu, die eine oder mehrere Berechtigungen enthalten.

In diesem Dokument werden die für Dataplex relevanten IAM-Berechtigungen beschrieben. Weitere Informationen zu vordefinierten Dataplex-Rollen und den zugehörigen Berechtigungen finden Sie unter Dataplex-IAM-Rollen.

Eine ausführliche Beschreibung von IAM und den entsprechenden Funktionen finden Sie in der IAM-Dokumentation.

IAM-Richtlinien: Berechtigungen festlegen und abrufen

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die zum Abrufen und Festlegen von IAM-Berechtigungen erforderlich sind:

Ressource API-Methode IAM-Berechtigung
Eintragstypen GetIamPolicy dataplex.entryTypes.getIamPolicy
Eintragstypen SetIamPolicy dataplex.entryTypes.setIamPolicy
Aspekttypen GetIamPolicy dataplex.aspectTypes.getIamPolicy
Aspekttypen SetIamPolicy dataplex.aspectTypes.setIamPolicy
Eintragsgruppen GetIamPolicy dataplex.entryGroups.getIamPolicy
Eintragsgruppen SetIamPolicy dataplex.entryGroups.setIamPolicy
Lakes GetIamPolicy dataplex.lakes.getIamPolicy
Lakes SetIamPolicy dataplex.lakes.setIamPolicy

Berechtigungen für Dataplex Catalog

Welche Berechtigungen für Vorgänge auf Eintragstypen, Aspekttypen, Eintragsgruppen und Einträgen erforderlich sind, hängt davon ab, ob es sich um System- oder benutzerdefinierte Ressourcen handelt. Systemressourcen werden von Dataplex definiert, benutzerdefinierte Ressourcen von Ihnen oder Ihrer Organisation.

Wenn Sie Vorgänge ausführen möchten, die sich auf mehrere Ressourcen beziehen (z. B. einen Eintrag eines bestimmten Eintragstyps erstellen oder einem Eintrag einen Aspekt eines bestimmten Aspekttyps hinzufügen), benötigen Sie möglicherweise mehrere Berechtigungen, die mit den Ressourcen verknüpft sind.

Eintragstypen

Damit Sie Eintragstypen erstellen und verwalten können, müssen Sie mindestens die Standardberechtigungen create, get, list, update und delete haben.

Wenn Sie einen Eintragstyp erstellen, müssen Sie Berechtigungen für jeden Aspekttyp haben, den Sie für diesen Eintragstyp als erforderlich kennzeichnen möchten.

Wenn Sie einen Eintragstyp verwenden möchten (z. B. Einträge dieses Typs erstellen), benötigen Sie die Berechtigung use für den Eintragstyp.

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Bearbeitung von Eintragstypen erforderlich sind:

Vorgang Für benutzerdefinierte Eintragstypen erforderliche Berechtigungen
Eintragstypen auflisten dataplex.entryTypes.list
Eintragstypen abrufen dataplex.entryTypes.get
Eintragstypen erstellen

dataplex.entryTypes.create

dataplex.aspectTypes.use (für jeden erforderlichen Aspekttyp im Eintragstyp)

dataplex.entryGroups.useASPECT_TYPE (für jeden erforderlichen Systemaspekttyp im Eintragstyp) Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.
Eintragstypen aktualisieren

dataplex.entryTypes.update

dataplex.aspectTypes.use (für jeden erforderlichen Aspekttyp im Eintragstyp)

dataplex.entryGroups.useASPECT_TYPE (für jeden erforderlichen Systemaspekttyp im Eintragstyp) Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.
Eintragstypen löschen

dataplex.entryTypes.delete

dataplex.aspectTypes.use (für erforderliche Aspekttypen in den Eintragstypen)

dataplex.entryGroups.useASPECT_TYPE (für jeden erforderlichen Systemaspekttyp im Eintragstyp) Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

Eintragstypen verwenden

(beim Erstellen von Einträgen, Aktualisieren von Eintragsfeldern der obersten Ebene und erforderlichen Werten für den Aspekttyp)

dataplex.entryTypes.use

dataplex.entries.create oder dataplex.entries.update

dataplex.aspectTypes.use (für jeden erstellten oder aktualisierten Aspekt)

Aspekttypen

Zum Erstellen und Verwalten von Aspekttypen müssen Sie die Standardberechtigungen create, get, list, update und delete haben.

Wenn Sie einen Aspekttyp verwenden möchten, z. B. als optionalen Aspekt an einen Eintrag anhängen, benötigen Sie die Berechtigung use für den Aspekttyp.

Aspekttypen werden in Systemaspekttypen und benutzerdefinierte Aspekttypen unterteilt. Systemaspekttypen werden von Dataplex erstellt, benutzerdefinierte Aspekttypen von Ihnen oder Ihrer Organisation. Systemaspekttypen werden weiter in „verwendbar“ und „schreibgeschützt“ unterteilt. Weitere Informationen finden Sie unter Kategorien von Aspekttypen.

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Bearbeitung benutzerdefinierter und systemeigener Aspekttypen erforderlich sind:

Vorgang Erforderliche Berechtigungen für benutzerdefinierte Aspekttypen Für nutzbare Systemaspekttypen erforderliche Berechtigungen Erforderliche Berechtigungen für Systemaspekttypen vom Typ „Lesezugriff“
Aspekttypen auflisten dataplex.aspectTypes.list Nicht zutreffend (N/A) –
Aspekttypen abrufen dataplex.aspectTypes.get Gewährt an allUsers Gewährt an allUsers
Aspekttypen erstellen dataplex.aspectTypes.create – –
Aspekttypen aktualisieren dataplex.aspectTypes.update – –
Aspekttypen löschen dataplex.aspectTypes.delete – –
Optionale Werte für den Aspekttyp beim Erstellen oder Aktualisieren von Einträgen festlegen

dataplex.aspectTypes.use

dataplex.entries.create oder dataplex.entries.update

dataplex.entryGroups.useASPECT_TYPE. Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

dataplex.entries.create oder dataplex.entries.update

 –
Erforderliche Werte für den Aspekttyp beim Erstellen oder Aktualisieren von Einträgen festlegen

dataplex.aspectTypes.use

dataplex.entryTypes.use

dataplex.entries.create oder dataplex.entries.update

dataplex.entryGroups.useASPECT_TYPE. Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

dataplex.entryTypes.use

dataplex.entries.create oder dataplex.entries.update

 –

Eintragsgruppen

Damit Sie Eintragsgruppen erstellen und verwalten können, müssen Sie die Standardberechtigungen create, get, list, update und delete haben.

Eintragsgruppen werden in Systemeintragsgruppen, die von Dataplex erstellt werden, und benutzerdefinierte Eintragsgruppen, die von Ihnen oder Ihrer Organisation erstellt werden, unterteilt. Weitere Informationen finden Sie unter Kategorien von Eintragsgruppen.

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Bearbeitung von Eingangsgruppen erforderlich sind:

Vorgang Erforderliche Berechtigungen für benutzerdefinierte Eintragsgruppen Erforderliche Berechtigungen für Systemeintragsgruppen (beginnend mit @)
Eintragsgruppen erstellen dataplex.entryGroups.create –
Eintragsgruppen aktualisieren dataplex.entryGroups.update –
Eintragsgruppen löschen dataplex.entryGroups.delete –
Eintragsgruppen auflisten dataplex.entryGroups.list dataplex.entryGroups.list
Eintragsgruppen abrufen dataplex.entryGroups.get dataplex.entryGroups.get

Einträge

Zum Erstellen und Verwalten von Einträgen müssen Sie die Standardberechtigungen create, get, list, update und delete haben.

Wichtige Hinweise:

  • Für die Methoden „Lookup“ (LookupEntry) und „Search“ (SearchEntries) ist die Berechtigung für den Eintrag vom ursprünglichen Quellsystem erforderlich. Wenn die Quelle beispielsweise eine BigQuery-Tabelle ist, benötigen Sie die Berechtigung bigquery.tables.get.
  • Wenn Sie einen Eintrag erstellen oder die Felder der obersten Ebene eines Eintrags aktualisieren, müssen Sie für den Eintragstyp die Berechtigung use haben.
  • Wenn Sie einen erforderlichen Aspekt erstellen, aktualisieren oder löschen, müssen Sie die Berechtigung use für den Eintragstyp eines Eintrags sowie für den zugrunde liegenden Aspekttyp haben. Das liegt daran, dass die erforderlichen Aspekte durch den Eintragstyp erzwungen werden.
  • Wenn Sie einen optionalen Aspekt erstellen, aktualisieren oder löschen möchten, benötigen Sie die Berechtigung use für den Aspekttyp.
  • Wenn Sie einen Eintrag aktualisieren (UpdateEntry mit allow_missing = True), benötigen Sie die Berechtigung create.

Weitere Informationen zu den Eintragstypen, auf denen Einträge basieren, finden Sie unter Kategorien von Eintragstypen.

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Bearbeitung von Einträgen erforderlich sind:

Vorgang Eintrag basierend auf benutzerdefiniertem Eintragstyp Eintrag basierend auf dem nutzbaren Systemeintragstyp Eintrag basierend auf schreibgeschütztem Systemeintragstyp
Einträge erstellen

dataplex.entries.create

dataplex.entryTypes.use

dataplex.aspectTypes.use (für jeden erstellten Aspekt)

dataplex.entryGroups.useASPECT_TYPE (für jeden Aspekt eines erstellten nutzbaren Systemaspekttyps) Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

dataplex.entries.create

dataplex.entryGroups.useENTRY_TYPE. Weitere Informationen finden Sie unter Berechtigungen für Systemeintragstypen.

dataplex.entryGroups.useASPECT_TYPE (für jeden erstellten Systemaspekt). Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

dataplex.aspectTypes.use (für jeden erstellten benutzerdefinierten Aspekt)

 –
Einträge aktualisieren

dataplex.entries.update

dataplex.entryTypes.use (zum Aktualisieren von Feldern der obersten Ebene oder erforderlichen Aspekten)

dataplex.aspectTypes.use (für jeden aktualisierten Aspekt)

dataplex.entryGroups.useASPECT_TYPE (für jeden aktualisierten Systemaspekt). Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

dataplex.entries.create (wenn allow_missing = True)

dataplex.entries.update

dataplex.entryGroups.useENTRY_TYPE (zum Aktualisieren von Feldern der obersten Ebene oder erforderlichen Aspekten) Weitere Informationen finden Sie unter Berechtigungen für Systemeintragstypen.

dataplex.aspectTypes.use (für jeden aktualisierten benutzerdefinierten Aspekt)

dataplex.entryGroups.useASPECT_TYPE (für jeden Aspekt, der zu den Systemaspekttypen gehört) Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

dataplex.entries.create (wenn allow_missing = True)

dataplex.entries.update

dataplex.aspectTypes.use (für jeden aktualisierten benutzerdefinierten Aspekt)

dataplex.entryGroups.useASPECT_TYPE (für jeden Aspekt eines nutzbaren Systemaspekttyps aktualisiert) Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

Felder der obersten Ebene und erforderliche Aspekte können nicht bearbeitet werden.
Einträge auflisten dataplex.entries.list dataplex.entries.list dataplex.entries.list
Einträge abrufen dataplex.entries.get dataplex.entries.get dataplex.entries.get
Sucheinträge

Leseberechtigung des ursprünglichen Quellsystems.

Bei benutzerdefinierten Einträgen ist das dataplex.entries.get, da Dataplex als ursprüngliches Quellsystem behandelt wird.

Leseberechtigung des ursprünglichen Quellsystems.

Bei benutzerdefinierten Einträgen ist das dataplex.entries.get, da Dataplex als ursprüngliches Quellsystem behandelt wird.

Leseberechtigung des ursprünglichen Quellsystems.

Bei benutzerdefinierten Einträgen ist das dataplex.entries.get, da Dataplex als ursprüngliches Quellsystem behandelt wird.
Einträge suchen

Leseberechtigung des ursprünglichen Quellsystems.

Bei benutzerdefinierten Einträgen ist das dataplex.entries.get, da Dataplex als ursprüngliches Quellsystem behandelt wird.

Leseberechtigung des ursprünglichen Quellsystems.

Bei benutzerdefinierten Einträgen ist das dataplex.entries.get, da Dataplex als ursprüngliches Quellsystem behandelt wird.

Leseberechtigung des ursprünglichen Quellsystems.

Bei benutzerdefinierten Einträgen ist das dataplex.entries.get, da Dataplex als ursprüngliches Quellsystem behandelt wird.

Berechtigungen für Metadatenjobs

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Arbeit mit Metadatenjobs erforderlich sind.

Vorgang IAM-Berechtigung
Metadatenjobs erstellen

dataplex.metadataJobs.create

dataplex.entryTypes.use (für benutzerdefinierte Eintragstypen im Umfang des Jobs)

dataplex.entryTypes.useENTRY_TYPE (für jeden Systemeintragstyp im Umfang des Jobs) Weitere Informationen finden Sie unter Berechtigungen für Systemeintragstypen. Diese Berechtigung ist jedoch nicht erforderlich, um optionale Aspekte zu ändern, wenn ein Metadatenimportjob nur für Aspekte ausgeführt wird.

dataplex.aspectTypes.use (für benutzerdefinierte Aspekttypen im Umfang des Jobs)

dataplex.aspectTypes.useASPECT_TYPE (für jeden Systemaspekttyp im Umfang der Stelle) Weitere Informationen finden Sie unter Berechtigungen für Systemaspekttypen.

dataplex.entryGroups.import (für Eintragsgruppen im Umfang der Stelle)

Metadatenjobs abrufen

dataplex.metadataJobs.get
Metadatenjobs auflisten

dataplex.metadataJobs.list
Metadatenjobs abbrechen

dataplex.metadataJobs.cancel

Systemaspekttypen und Eintragstypen

Für jeden systemdefinierten Aspekttyp und jeden systemdefinierten Eintragstyp gelten eigene IAM-Berechtigungen. Diese Berechtigungen haben ein Format wie dataplex.entryGroups.useASPECT_TYPE oder dataplex.entryGroups.useENTRY_TYPE. Die Berechtigung für den Systemaspekttyp overview ist beispielsweise dataplex.entryGroups.useOverviewAspect.

In der folgenden Tabelle sind die Berechtigungen für systemdefinierte Aspekt- und Eintragstypen aufgeführt.

Ressource IAM-Berechtigung
schema (Systemaspekttyp) dataplex.entryGroups.useSchemaAspect
contacts (Systemaspekttyp) dataplex.entryGroups.useContactsAspect
overview (Systemaspekttyp) dataplex.entryGroups.useOverviewAspect
generic (Systemaspekttyp) dataplex.entryGroups.useGenericAspect
generic (Systemeintragstyp) dataplex.entryGroups.useGenericEntry

Berechtigungen für Datenlakes, Zonen und Assets

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Bearbeitung von Seen, Zonen und Assets erforderlich sind:

API-Methode IAM-Berechtigung
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

Aufgabenberechtigungen

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Bearbeitung von Aufgaben erforderlich sind:

API-Methode IAM-Berechtigung
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

Berechtigungen für die Umgebung

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Ausführung in Umgebungen erforderlich sind:

API-Methode IAM-Berechtigung
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

Berechtigungen für Metadaten

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Ausführung von Vorgängen auf Entitäten und Partitionen erforderlich sind:

API-Methode IAM-Berechtigung
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

Berechtigungen für Datenscans

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Ausführung von Datenscans erforderlich sind:

API-Methode IAM-Berechtigung
CreateDataScan dataplex.datascans.create
UpdateDataScan dataplex.datascans.update
DeleteDataScan dataplex.datascans.delete
ListDataScans dataplex.datascans.list
GetDataScan (einfache Ansicht) dataplex.datascans.get
GetDataScan (Vollständige Ansicht) dataplex.datascans.getData
ListDataScanJobs dataplex.datascans.get
GetDataScanJob (einfache Ansicht) dataplex.datascans.get
GetDataScanJob (Vollständige Ansicht) dataplex.datascans.getData
RunDataScan dataplex.datascans.run