Permisos de Identity and Access Management de Knowledge Catalog

Los permisos de Identity and Access Management (IAM) te permiten controlar el acceso detallado a los recursos de Knowledge Catalog (anteriormente, Dataplex Universal Catalog) en la administración de metadatos, los análisis de datos, los data lakes, las zonas, los recursos, las tareas y los entornos. Como no otorgas permisos directamente a las principales, puedes asignar roles predefinidos para casos de uso comunes o agrupar permisos específicos en roles personalizados para aplicar el principio de privilegio mínimo.

En este documento, se enumeran los permisos de IAM necesarios para ejecutar operaciones y métodos de API específicos en Knowledge Catalog. Para obtener más información sobre los roles predefinidos, consulta Roles de IAM de Knowledge Catalog. Para obtener más información sobre IAM, consulta Descripción general de IAM.

Permisos para configurar y obtener políticas de IAM

En la siguiente tabla, se enumeran los permisos necesarios para obtener y establecer permisos de IAM:

Recurso	Método de la API	Permisos de IAM
Tipos de aspecto	GetIamPolicy	dataplex.aspectTypes.getIamPolicy
Tipos de aspecto	SetIamPolicy	dataplex.aspectTypes.setIamPolicy
Grupos de entrada	GetIamPolicy	dataplex.entryGroups.getIamPolicy
Grupos de entrada	SetIamPolicy	dataplex.entryGroups.setIamPolicy
Tipos de entrada	GetIamPolicy	dataplex.entryTypes.getIamPolicy
Tipos de entrada	SetIamPolicy	dataplex.entryTypes.setIamPolicy
Lakes	GetIamPolicy	dataplex.lakes.getIamPolicy
Lakes	SetIamPolicy	dataplex.lakes.setIamPolicy

Permisos de administración de metadatos

El conjunto de permisos que se requiere para realizar operaciones en tipos de entrada, tipos de vínculos de entrada, tipos de aspectos, grupos de entradas, entradas y vínculos de entrada depende de si los recursos son del sistema o personalizados. Los recursos del sistema los define Knowledge Catalog, y los recursos personalizados los defines tú o tu organización.

Para enriquecer las entradas y los vínculos de entrada con información adicional, puedes adjuntar aspectos.

Para realizar operaciones relacionadas con varios recursos (por ejemplo, crear una entrada de un tipo de entrada específico o agregar un aspecto de un tipo de aspecto específico a una entrada o un vínculo de entrada), es posible que necesites varios permisos asociados con los recursos.

Tipos de entrada

Para crear y administrar tipos de entradas, se te deben otorgar, al menos, los permisos estándar create, get, list, update y delete.

Cuando creas un tipo de entrada, se te deben otorgar permisos para usar cada tipo de aspecto que quieras marcar como obligatorio para ese tipo de entrada.

Para usar un tipo de entrada (por ejemplo, para crear entradas de un tipo de entrada), se te debe otorgar el permiso use en el tipo de entrada.

En la siguiente tabla, se enumeran los permisos necesarios para operar con tipos de entradas:

Operación	Permisos de IAM
Create entry types	dataplex.entryTypes.create dataplex.aspectTypes.use (para cada tipo de aspecto obligatorio en el tipo de entrada) dataplex.entryGroups.useASPECT_TYPE (para cada tipo de aspecto del sistema obligatorio en el tipo de entrada). Consulta los permisos para los tipos de aspectos del sistema.
Delete entry types	dataplex.entryTypes.delete dataplex.aspectTypes.use (para los tipos de aspectos obligatorios en los tipos de entradas) dataplex.entryGroups.useASPECT_TYPE (para cada tipo de aspecto del sistema obligatorio en el tipo de entrada). Consulta los permisos para los tipos de aspectos del sistema.
Get entry types	dataplex.entryTypes.get
List entry types	dataplex.entryTypes.list
Update entry types	dataplex.entryTypes.update dataplex.aspectTypes.use (para cada tipo de aspecto obligatorio en el tipo de entrada) dataplex.entryGroups.useASPECT_TYPE (para cada tipo de aspecto del sistema obligatorio en el tipo de entrada). Consulta los permisos para los tipos de aspectos del sistema.
Usa tipos de entrada (cuando se crean entradas, se actualizan los campos de entrada de nivel superior y los valores de tipo de aspecto obligatorios)	dataplex.entryTypes.use dataplex.entries.create o dataplex.entries.update dataplex.aspectTypes.use (por cada aspecto creado o actualizado)

Tipos de aspecto

Para crear y administrar tipos de aspectos, se te deben otorgar los permisos estándar create, get, list, update y delete.

Para usar un tipo de aspecto (por ejemplo, para adjuntarlo como un aspecto opcional en una entrada o actualizar el aspecto requerido en el vínculo de entrada), se te debe otorgar el permiso use en el tipo de aspecto.

Los tipos de aspectos se clasifican en tipos de aspectos del sistema y tipos de aspectos personalizados. Knowledge Catalog crea los tipos de aspectos del sistema, y tú o tu organización crean los tipos de aspectos personalizados. Los tipos de aspectos del sistema se clasifican en utilizables y de solo lectura. Para obtener más información, consulta Categorías de tipos de aspectos.

En la siguiente tabla, se enumeran los permisos necesarios para operar en los tipos de aspectos personalizados y del sistema:

Operación	Permisos necesarios para los tipos de aspectos personalizados	Permisos necesarios para los tipos de aspectos del sistema que se pueden usar	Permisos necesarios para los tipos de aspectos del sistema de solo lectura
Create aspect types	dataplex.aspectTypes.create	No aplicable	No aplicable
Delete aspect types	dataplex.aspectTypes.delete	No aplicable	No aplicable
Get aspect types	dataplex.aspectTypes.get	Se otorgó a allUsers	Se otorgó a allUsers
List aspect types	dataplex.aspectTypes.list	No aplicable	No aplicable
Cuando crees o actualices entradas, establece valores de tipo de aspecto opcionales	dataplex.aspectTypes.use dataplex.entries.create o dataplex.entries.update	dataplex.entryGroups.useASPECT_TYPE. Consulta los permisos para los tipos de aspectos del sistema. dataplex.entries.create o dataplex.entries.update	No aplicable
Cuando crees o actualices entradas, establece los valores de tipo de aspecto requeridos	dataplex.aspectTypes.use dataplex.entryTypes.use dataplex.entries.create o dataplex.entries.update	dataplex.entryGroups.useASPECT_TYPE. Consulta los permisos para los tipos de aspectos del sistema. dataplex.entryTypes.use dataplex.entries.create o dataplex.entries.update	No aplicable
Update aspect types	dataplex.aspectTypes.update	N/A	N/A
Establece los valores de tipo de aspecto requeridos cuando crees o actualices el vínculo de entrada	N/A	dataplex.entryGroups.useASPECT_TYPE. Consulta los permisos para los tipos de aspectos del sistema. dataplex.entryLinkTypes.useENTRY_LINK_TYPE. Consulta los permisos para los tipos de vínculos de entrada del sistema. dataplex.entries.link Se otorga en los grupos de entradas que contienen entradas vinculadas. Solo se verifica durante la creación del vínculo de entrada. dataplex.entryLinks.create o dataplex.entryLinks.update	N/A

Grupos de entrada

Para crear y administrar grupos de entradas, se te deben otorgar los permisos estándar create, get, list, update y delete.

Los grupos de entradas se clasifican en grupos de entradas del sistema, que crea Knowledge Catalog, y grupos de entradas personalizados, que creas tú o tu organización. Para obtener más información, consulta Categorías de grupos de entradas.

En la siguiente tabla, se enumeran los permisos necesarios para operar en grupos de entradas:

Operación	Permisos necesarios para los grupos de entradas personalizados	Permisos necesarios para los grupos de entradas del sistema (que comienzan con @)
Create entry groups	dataplex.entryGroups.create	No aplicable
Delete entry groups	dataplex.entryGroups.delete	No aplicable
Get entry groups	dataplex.entryGroups.get	dataplex.entryGroups.get
List entry groups	dataplex.entryGroups.list	dataplex.entryGroups.list
Update entry groups	dataplex.entryGroups.update	No aplicable

Entradas

Para crear y administrar entradas, se te deben otorgar los permisos estándar create, get, list, update y delete.

Ten en cuenta lo siguiente:

• Para los métodos de búsqueda (<code>LookupEntry</code>) y búsqueda (<code>SearchEntries</code>), se requiere el permiso del sistema de origen original en la entrada. Por ejemplo, si la fuente es una tabla de BigQuery, necesitas el permiso bigquery.tables.get para ver los metadatos y bigquery.tables.getData para ver los aspectos de los datos.
• Si no tienes permiso para ver los aspectos de los datos, las entradas seguirán siendo visibles, pero el contenido de los aspectos de los datos estará oculto.
• Cuando creas una entrada o actualizas los campos de nivel superior de una entrada, se te debe otorgar el permiso use en el tipo de entrada.
• Cuando creas o actualizas un aspecto obligatorio, se te debe otorgar el permiso use en el tipo de entrada de una entrada, así como en el tipo de aspecto subyacente. Esto se debe a que el tipo de entrada aplica de manera forzosa los aspectos obligatorios.
• Cuando creas, actualizas o borras un aspecto opcional, se te debe otorgar el permiso use en el tipo de aspecto de un aspecto.
• Cuando actualizas o insertas una entrada (<code>UpdateEntry</code> con <code>allow_missing = True</code>), se te debe otorgar el permiso create.

Para obtener más información sobre los tipos de entradas en los que se basan las entradas, consulta Categorías de tipos de entradas.

En la siguiente tabla, se enumeran los permisos necesarios para operar con entradas:

Operación	Entrada basada en un tipo de entrada personalizado	Entrada basada en el tipo de entrada del sistema que se puede usar	Entrada basada en el tipo de entrada del sistema de solo lectura
Create entries	dataplex.entries.create dataplex.entryTypes.use dataplex.aspectTypes.use (por cada aspecto personalizado creado) dataplex.entryGroups.useASPECT_TYPE (por cada aspecto de un tipo de aspecto del sistema utilizable que se cree). Consulta los permisos para los tipos de aspectos del sistema.	dataplex.entries.create dataplex.entryGroups.useENTRY_TYPE. Consulta los permisos para los tipos de entradas del sistema. dataplex.entryGroups.useASPECT_TYPE (para cada aspecto del sistema creado) Consulta los permisos para los tipos de aspectos del sistema. dataplex.aspectTypes.use (por cada aspecto personalizado creado)	No aplicable
Get entries	dataplex.entries.get Para ver los aspectos de los datos, también se requiere dataplex.entries.getData.	dataplex.entries.get Para ver los aspectos de los datos, también se requiere dataplex.entries.getData.	dataplex.entries.get Para ver los aspectos de los datos, también se requiere dataplex.entries.getData.
List entries	dataplex.entries.list	dataplex.entries.list	dataplex.entries.list
Lookup entries	Requiere permiso de lectura de metadatos del sistema de origen. Se requiere permiso para leer datos del sistema de origen para ver los aspectos de los datos. En el caso de las entradas personalizadas, en las que Knowledge Catalog se trata como el sistema de origen, estos permisos son dataplex.entries.get y dataplex.entries.getData, respectivamente.	Requiere permiso de lectura de metadatos del sistema de origen. Se requiere permiso para leer datos del sistema de origen para ver los aspectos de los datos. En el caso de las entradas personalizadas, en las que Knowledge Catalog se trata como el sistema de origen, estos permisos son dataplex.entries.get y dataplex.entries.getData, respectivamente.	Requiere permiso de lectura de metadatos del sistema de origen. Se requiere permiso para leer datos del sistema de origen para ver los aspectos de los datos. En el caso de las entradas personalizadas, en las que Knowledge Catalog se trata como el sistema de origen, estos permisos son dataplex.entries.get y dataplex.entries.getData, respectivamente.
Search entries	Permiso de lectura del sistema de origen original. Para las entradas personalizadas, este es dataplex.entries.get, ya que Knowledge Catalog se trata como el sistema de origen original.	Permiso de lectura del sistema de origen original. Para las entradas personalizadas, este es dataplex.entries.get, ya que Knowledge Catalog se trata como el sistema de origen original.	Permiso de lectura del sistema de origen original. Para las entradas personalizadas, este es dataplex.entries.get, ya que Knowledge Catalog se trata como el sistema de origen original.
Update entries	dataplex.entries.update dataplex.entryTypes.use (para actualizar campos de nivel superior o aspectos obligatorios) dataplex.aspectTypes.use (por cada aspecto actualizado) dataplex.entryGroups.useASPECT_TYPE (por cada aspecto del sistema que se actualice) Consulta los permisos para los tipos de aspectos del sistema. dataplex.entries.create (si allow_missing es True)	dataplex.entries.update dataplex.entryGroups.useENTRY_TYPE (para actualizar campos de nivel superior o aspectos obligatorios) Consulta los permisos para los tipos de entrada del sistema. dataplex.aspectTypes.use (por cada aspecto personalizado actualizado) dataplex.entryGroups.useASPECT_TYPE (para cada aspecto que pertenezca a los tipos de aspectos del sistema). Consulta los permisos para los tipos de aspectos del sistema. dataplex.entries.create (si allow_missing es True)	dataplex.entries.update dataplex.aspectTypes.use (por cada aspecto personalizado actualizado) dataplex.entryGroups.useASPECT_TYPE (para cada aspecto de un tipo de aspecto del sistema utilizable que se actualizó). Consulta los permisos para los tipos de aspectos del sistema. Los campos de nivel superior y los aspectos obligatorios no se pueden editar.

Vínculos de entrada

Para crear y administrar vínculos de entrada, se te deben otorgar los permisos create, get, list y delete en dataplex.entryLinks.

Ten en cuenta lo siguiente:

• La creación de vínculos de entrada (CreateEntryLink) también requiere permisos en el tipo de vínculo de entrada y permisos para las entradas específicas del vínculo.
• Cuando creas un vínculo de entrada con un aspecto obligatorio, necesitas los permisos para usar el tipo de aspecto.
• Cuando actualizas o insertas un vínculo de entrada (UpdateEntryLink con allow_missing = True), también debes tener los mismos permisos necesarios para CreateEntryLink.

En la siguiente tabla, se enumeran los permisos necesarios para operar en los vínculos de entrada:

Operación	Permisos de IAM
Crea vínculos de entrada	dataplex.entryLinks.create (en el grupo de entradas) Permisos necesarios según el tipo de vínculo de entrada: Sinónimo: dataplex.glossaryTerms.use (en ambas entradas de términos) Definición: dataplex.glossaryTerms.use (en la entrada del término) y dataplex.entries.link (en la entrada de destino) Otro: dataplex.entries.link (en ambas entradas) Permiso para usar el tipo de vínculo de entrada: Para los tipos de sistema: dataplex.entryGroups.useENTRY_LINK_TYPE (en el grupo de entradas). Consulta los permisos para los tipos de vínculos de entrada del sistema. Permisos para cualquier aspecto obligatorio que especifique el tipo de vínculo de entrada: Para los tipos de sistema: dataplex.entryGroups.useASPECT_TYPE (en el grupo de entradas). Consulta los permisos para los tipos de aspectos del sistema.
Borra vínculos de entrada	dataplex.entryLinks.delete (en el grupo de entradas)
Obtén vínculos de entrada	dataplex.entryLinks.get (en el grupo de entradas)
Vínculos de entrada de búsqueda	Requiere permiso de lectura de metadatos del sistema de origen en la entrada para la que se buscan los vínculos de entrada. Para las entradas personalizadas vinculadas, en las que Knowledge Catalog se trata como el sistema de origen, los permisos son dataplex.entries.get. En el caso de las entradas del sistema vinculadas, el permiso es el permiso de lectura del sistema de origen de la entrada vinculada.
Actualizar el vínculo de entrada	dataplex.entryLinks.update (en el grupo de entradas) Permiso para usar el tipo de vínculo de entrada: Para los tipos de sistema: dataplex.entryGroups.useENTRY_LINK_TYPE (en el grupo de entradas). Consulta los permisos para los tipos de vínculos de entrada del sistema. Permisos para cualquier aspecto obligatorio que especifique el tipo de vínculo de entrada: Para los tipos de sistema: dataplex.entryGroups.useASPECT_TYPE (en el grupo de entradas). Consulta los permisos para los tipos de aspectos del sistema. Si allow_missing es True, además, se aplican todos los permisos de Create entry link.

Limitaciones de los aspectos en los vínculos de entrada

Las siguientes limitaciones se aplican al uso de aspectos con vínculos de entrada.

Conjuntos de contextos

Los conjuntos de contexto son contenedores limitados de recursos de datos de destino y metadatos que se usan para fundamentar los modelos de IA en tu lógica empresarial patentada. Si bien pueden contener información específica de la base de datos, como plantillas de consulta en SQL o consultas de búsqueda de valores para herramientas de texto a SQL como QueryData, Knowledge Studio también usa conjuntos de contexto para alojar glosarios de terminología, descripciones generales de tablas estructuradas y asignaciones de datos empresariales.

Para obtener más información sobre cómo se usan los conjuntos de contexto en Google Cloud, consulta la descripción general de los conjuntos de contexto para Knowledge Studio, AlloyDB para PostgreSQL, Bigtable, Cloud SQL para MySQL, Cloud SQL para PostgreSQL, Firestore con compatibilidad con MongoDB o Spanner.

Para ver, crear y administrar conjuntos de contexto de bases de datos para QueryData (dataplex.contextSetGroups.*, dataplex.contextSets.* y dataplex.context.*), otorga los siguientes roles de IAM:

• Visualizador del catálogo de Dataplex (roles/dataplex.catalogViewer): Acceso de solo lectura para ver y enumerar conjuntos de contexto de bases de datos, grupos de conjuntos de contexto, contexto y ubicaciones, y para descargar conjuntos de contexto y contexto.
• Editor del catálogo de Dataplex (roles/dataplex.catalogEditor): Acceso para crear, ver, enumerar, actualizar y borrar conjuntos de contexto de bases de datos y grupos de conjuntos de contexto; subir y descargar conjuntos de contexto; ver, enumerar, actualizar, borrar y descargar contexto; y ver y enumerar ubicaciones.
• Administrador de Dataplex Catalog (roles/dataplex.catalogAdmin): Acceso de administrador completo a los conjuntos de contexto de la base de datos, los grupos de conjuntos de contexto y el contexto, y acceso para ver y enumerar ubicaciones.

Para crear y administrar conjuntos de contexto de grupos de entradas de Knowledge Studio (dataplex.entryGroups.*ContextSet, dataplex.entryGroups.requestContextChanges y dataplex.entries.*Context), otorga los siguientes roles de IAM:

• Creador de contenido de Dataplex (roles/dataplex.contentCreator): Acceso para crear y enumerar conjuntos de contexto en un proyecto (dataplex.entryGroups.createContextSet, dataplex.entryGroups.list). La creación de un conjunto de contexto no requiere dataplex.entryGroups.setIamPolicy.
• Visualizador de contenido de Dataplex (roles/dataplex.contentViewer): Acceso de solo lectura para descubrir contenedores de conjuntos de contexto (dataplex.entryGroups.getContextSet).
• Usuario de contenido de Dataplex (roles/dataplex.contentUser): Acceso para ver conjuntos de contexto, leer y enumerar entradas de contexto, y solicitar cambios de contexto.
• Editor de contenido de Dataplex (roles/dataplex.contentEditor): Acceso para ver y actualizar conjuntos de contexto, solicitar cambios de contexto y crear, leer, enumerar, actualizar y borrar entradas de contexto.
• Administrador de contenido de Dataplex (roles/dataplex.contentAdmin): Acceso de administrador completo a un conjunto de contexto existente, incluidos todos los permisos de Editor de contenido de Dataplex (roles/dataplex.contentEditor), borrar el conjunto de contexto (dataplex.entryGroups.deleteContextSet) y administrar las políticas de IAM en el conjunto de contexto (dataplex.entryGroups.setIamPolicy). Este rol no otorga dataplex.entryGroups.createContextSet; para crear un conjunto de contexto nuevo en un proyecto, otorga Creador de contenido de Dataplex (roles/dataplex.contentCreator).

En la siguiente tabla, se enumeran los permisos de IAM necesarios para operar en conjuntos de contexto:

Operación	Permisos de IAM
Crea conjuntos de información contextual (Knowledge Studio)	dataplex.entryGroups.createContextSet
Borra conjuntos de información contextual (Knowledge Studio)	dataplex.entryGroups.deleteContextSet
Leer conjuntos de información contextual (Knowledge Studio)	dataplex.entryGroups.getContextSet
Actualiza conjuntos de información contextual (Knowledge Studio)	dataplex.entryGroups.updateContextSet
Solicita cambios de contexto (Knowledge Studio)	dataplex.entryGroups.requestContextChanges
Crea entradas de contexto (Knowledge Studio)	dataplex.entries.createContext
Borra entradas de contexto (Knowledge Studio)	dataplex.entries.deleteContext
Leer entradas de contexto (Knowledge Studio)	dataplex.entries.getContext
Enumera las entradas de contexto (Knowledge Studio)	dataplex.entries.listContext
Actualiza las entradas de contexto (Knowledge Studio)	dataplex.entries.updateContext
Crea grupos de conjuntos de información contextual (QueryData)	dataplex.contextSetGroups.create
Borra grupos de conjuntos de contextos (QueryData)	dataplex.contextSetGroups.delete
Leer grupos de conjuntos de contexto (QueryData)	dataplex.contextSetGroups.get
Enumera los grupos de conjuntos de contexto (QueryData)	dataplex.contextSetGroups.list
Actualizar grupos de conjuntos de contextos (QueryData)	dataplex.contextSetGroups.update
Crea conjuntos de información contextual (QueryData)	dataplex.contextSets.create
Borrar conjuntos de información contextual (QueryData)	dataplex.contextSets.delete
Descargar el contexto de un conjunto de información contextual (QueryData)	dataplex.contextSets.download
Leer conjuntos de contexto (QueryData)	dataplex.contextSets.get
Enumera conjuntos de información contextual (QueryData)	dataplex.contextSets.list
Actualiza conjuntos de contexto (QueryData)	dataplex.contextSets.update
Sube contexto a un conjunto de contextos (QueryData)	dataplex.contextSets.upload
Borrar contexto (QueryData)	dataplex.context.delete
Descargar contexto (QueryData)	dataplex.context.download
Leer contexto (QueryData)	dataplex.context.get
Enumera el contexto (QueryData)	dataplex.context.list
Actualizar contexto (QueryData)	dataplex.context.update

Para obtener más información, consulta Roles de IAM de Knowledge Catalog.

Permisos de trabajos de metadatos

En la siguiente tabla, se enumeran los permisos necesarios para trabajar con trabajos de importación de metadatos y trabajos de exportación de metadatos.

Operación	Permisos de IAM
Accede a los resultados exportados de los trabajos de exportación de metadatos	storage.objects.get
Cancel metadata jobs	dataplex.metadataJobs.cancel
Create metadata export jobs	dataplex.metadataJobs.create dataplex.entryGroups.export dataplex.entryGroups.get resourcemanager.projects.get resourcemanager.projects.list
Create metadata import jobs	dataplex.metadataJobs.create dataplex.entryTypes.use (para tipos de entrada personalizados en el alcance del trabajo) dataplex.entryTypes.useENTRY_TYPE (para cada tipo de entrada del sistema en el alcance del trabajo). Consulta los permisos para los tipos de entrada del sistema. Sin embargo, este permiso no es necesario para modificar aspectos opcionales cuando se ejecuta un trabajo de importación de metadatos solo de aspectos. dataplex.aspectTypes.use (para tipos de aspectos personalizados en el alcance del trabajo) dataplex.aspectTypes.useASPECT_TYPE (para cada tipo de aspecto del sistema en el alcance del trabajo). Consulta los permisos para los tipos de aspectos del sistema. dataplex.entryGroups.import (para grupos de entradas en el alcance del trabajo)
Get metadata jobs	dataplex.metadataJobs.get
List metadata jobs	dataplex.metadataJobs.list

Tipos de aspectos, tipos de entradas y tipos de vínculos de entrada del sistema

Cada tipo de aspecto, tipo de entrada y tipo de vínculo de entrada definidos por el sistema tiene sus propios permisos de IAM. Estos permisos usan un formato como dataplex.entryGroups.useASPECT_TYPE, dataplex.entryGroups.useENTRY_TYPE o dataplex.entryGroups.useENTRY_LINK_TYPE. Por ejemplo, el permiso para el tipo de aspecto del sistema overview es dataplex.entryGroups.useOverviewAspect.

En la siguiente tabla, se enumeran los permisos que se aplican a los tipos de aspectos, de entradas y de vínculos de entradas definidos por el sistema.

Recurso	Permisos de IAM
contacts (tipo de aspecto del sistema)	dataplex.entryGroups.useContactsAspect
data-profile (tipo de aspecto del sistema)	dataplex.entryGroups.useDataProfileAspect
data-quality-rule-template (tipo de aspecto del sistema)	dataplex.entryGroups.useDataQualityRuleTemplateAspect
data-quality-scorecard (tipo de aspecto del sistema)	dataplex.entryGroups.useDataQualityScorecardAspect
data-rules (tipo de aspecto del sistema)	dataplex.entryGroups.useDataRulesAspect
generic (tipo de aspecto del sistema)	dataplex.entryGroups.useGenericAspect
guidelines (tipo de aspecto del sistema)	dataplex.entryGroups.useGuidelinesAspect
overview (tipo de aspecto del sistema)	dataplex.entryGroups.useOverviewAspect
schema (tipo de aspecto del sistema)	dataplex.entryGroups.useSchemaAspect
schema-join (tipo de aspecto del sistema)	dataplex.entryGroups.useSchemaJoinAspect
generic (tipo de entrada del sistema)	dataplex.entryGroups.useGenericEntry
definition (tipo de vínculo de entrada del sistema)	dataplex.entryGroups.useDefinitionEntryLink
related (tipo de vínculo de entrada del sistema)	dataplex.entryGroups.useRelatedEntryLink
synonym (tipo de vínculo de entrada del sistema)	dataplex.entryGroups.useSynonymEntryLink
schema-join (tipo de vínculo de entrada del sistema)	dataplex.entryGroups.useSchemaJoinEntryLink

Permisos de lake, zona y recurso

En la siguiente tabla, se enumeran los permisos necesarios para operar en los lakes, las zonas y los recursos:

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

Permisos de tareas

En la siguiente tabla, se enumeran los permisos necesarios para operar en las tareas:

Método de la API	Permisos de IAM
CancelJob	dataplex.tasks.cancel
CreateTask	dataplex.tasks.create
DeleteTask	dataplex.tasks.delete
GetJob	dataplex.tasks.get
GetTask	dataplex.tasks.get
ListJobs	dataplex.tasks.get
ListTasks	dataplex.tasks.list
UpdateTask	dataplex.tasks.update

Permisos de metadatos

En la siguiente tabla, se enumeran los permisos necesarios para operar en entidades y particiones:

Método de la API	Permisos de IAM
CreateEntity	dataplex.entities.create
CreatePartition	dataplex.partitions.create
DeleteEntity	dataplex.entities.delete
DeletePartition	dataplex.partitions.delete
GetEntity	dataplex.entities.get
GetPartition	dataplex.partitions.get
ListEntities	dataplex.entities.list
ListPartitions	dataplex.partitions.list

Permisos de análisis de datos

En la siguiente tabla, se enumeran los permisos necesarios para operar en los análisis de datos:

Método de la API	Permisos de IAM
CancelDataScanJob	dataplex.datascans.cancel
CreateDataScan	dataplex.datascans.create
DeleteDataScan	dataplex.datascans.delete
GetDataScan (vista básica)	dataplex.datascans.get
GetDataScan (vista completa)	dataplex.datascans.getData
GetDataScanJob (vista básica)	dataplex.datascans.get
GetDataScanJob (vista completa)	dataplex.datascans.getData
ListDataScanJobs	dataplex.datascans.get
ListDataScans	dataplex.datascans.list
RunDataScan	dataplex.datascans.run
UpdateDataScan	dataplex.datascans.update

Tareas de enriquecimiento de Knowledge Studio

Se requieren los siguientes permisos para crear y administrar tareas de enriquecimiento de Knowledge Studio:

Operación	Permisos de IAM
Crea tareas de enriquecimiento	dataplex.agentTasks.create
Borra tareas de enriquecimiento	dataplex.agentTasks.delete
Lee los detalles de la tarea de enriquecimiento	dataplex.agentTasks.get
Lee y recupera los resultados de los datos subyacentes	dataplex.agentTasks.getData
Enumera las tareas de enriquecimiento	dataplex.agentTasks.list
Actualiza las tareas de enriquecimiento	dataplex.agentTasks.update
Ejecuta tareas de enriquecimiento	dataplex.agentTasks.run
Solicitar cambios en los grupos de entradas o los conjuntos de contexto (propuestas)	dataplex.entryGroups.requestContextChanges (conjuntos de información contextual) o dataplex.entryGroups.requestChanges (grupos de entradas)
Aprobar solicitudes de cambio de metadatos	dataplex.changeRequests.use

Permisos de proveedores de autenticación de terceros

Cuando configuras conectores externos, necesitas los siguientes permisos de identidad del agente para administrar los proveedores de autenticación:

Operación	Permisos de IAM
Crea proveedores de autenticación	agentidentity.authProviders.create
Ver detalles del proveedor de autenticación	agentidentity.authProviders.get
Borra proveedores de autenticación	agentidentity.authProviders.delete
Actualiza los proveedores de autenticación	agentidentity.authProviders.update
Configura políticas de IAM en proveedores de autenticación	agentidentity.authProviders.setIamPolicy

Permisos de generación de perfiles de BigQuery

Para permitir que el agente de enriquecimiento tome muestras de los datos de la tabla de BigQuery y ejecute verificaciones de validación, otorga los siguientes roles a la cuenta de servicio administrada por el cliente de la tarea de enriquecimiento:

• Visualizador de datos de BigQuery (roles/bigquery.dataViewer) en los conjuntos de datos y las tablas de destino, y en cualquier tabla de seguimiento de estadísticas de agentes.
• Usuario de trabajo de BigQuery (roles/bigquery.jobUser) en el proyecto de la tarea y en el proyecto de la tabla de seguimiento, si es diferente.

Para permitir que el agente también analice el historial de consultas de la tabla de BigQuery, otorga a la cuenta de servicio administrada por el cliente el rol de visualizador de recursos de BigQuery (roles/bigquery.resourceViewer) en los proyectos que contienen el historial de consultas.