Políticas do Serviço Data Catalog

Crie políticas para controlar quem tem acesso ao serviço Data Catalog e o tipo de acesso para cada grupo de usuários.

Por padrão, somente os usuários do grupo Administrators têm acesso a todos os recursos do serviço Data Catalog. Para todos os demais envolvidos com o serviço Data Catalog, crie políticas que designem a eles os direitos corretos aos recursos do serviço Data Catalog.

Para obter uma lista completa de políticas do Oracle Cloud Infrastructure, consulte referência de políticas.

Tipos de Recursos

O serviço Data Catalog oferece tipos de recursos agregados e individuais para gravação de políticas.

Você pode usar tipos de recursos agregados para gravar menos políticas. Por exemplo, em vez de permitir que um grupo gerencie data-catalogs e data-catalog-data-assets, você pode ter uma política que permita ao grupo gerenciar o tipo de recurso agregado, data-catalog-family.


Tipo de recurso agregado	Resource-Types Individuais
`data-catalog-family`	`data-catalogs` `data-catalog-private-endpoints` `data-catalog-metastores` `data-catalog-data-assets` `data-catalog-glossaries` `data-catalog-namespaces`

As APIs incluídas no tipo de recurso de agregação data-catalog-family abrangem as APIs para data-catalogs, data-catalog-private-endpoints, data-catalog-metastores, data-catalog-data-assets, data-catalog-glossaries e data-catalog-namespaces.

Por exemplo,

allow group catalog-admins to manage data-catalog-family in compartment x

é o mesmo que gravar as duas seguintes políticas:

allow group catalog-admins to manage data-catalogs in compartment x
allow group catalog-admins to manage data-catalog-private-endpoints in compartment x
allow group catalog-admins to manage data-catalog-metastores in compartment x
allow group catalog-admins to manage data-catalog-data-assets in compartment x
allow group catalog-admins to manage data-catalog-glossaries in compartment x
allow group catalog-admins to manage data-catalog-namespaces in compartment x

Tipos de Recursos para Grupos Dinâmicos

Use Grupos Dinâmicos para agrupar os recursos do catálogo de dados. Para obter mais informações, consulte Criando Grupos Dinâmicos.

Para definir um Grupo Dinâmico para recursos do catálogo de dados, use os seguintes tipos de recursos:

datacatalog
datacatalogprivateendpoint
datacatalogmetastore

O exemplo a seguir mostra uma regra de correspondência que inclui todos os catálogos em um compartimento:

Any{resource.type='datacatalog', resource.compartment.id = '<OCID of data catalog compartment>'}

Variáveis Suportadas

Para adicionar condições a suas políticas, você pode usar as variáveis gerais ou de serviço específico do Oracle Cloud Infrastructure.


Operações para Este Tipo de Recurso...	Podem Usar Essas Variáveis...	Tipo de Variável	Comentários
`data-catalog-family`	`target.catalog.id`	Entidade (OCID)	Não disponível para uso com `CreateCatalog` ou operações de solicitação de serviço.
`data-catalog-family`	`target.metastore.id`	Entidade (OCID)	Disponível para uso somente com operações de metastore.
`data-catalogs`	`target.catalog.id`	Entidade (OCID)	Não disponível para uso com `CreateCatalog` ou operações de solicitação de serviço.
`data-catalog-data-assets`	`target.catalog.id`	Entidade (OCID)	Não disponível para uso com operações de solicitação de serviço.
`data-catalog-data-assets`	`target.data-asset.key`	A chave é o Identificador Exclusivo Universal (UUID) para o ativo de dados, em um formato de string. Este ID não é um OCID.	Disponível para uso somente com operações de ativos de dados, exceto para `CreateDataAsset`.
`data-catalog-glossaries`	`target.catalog.id`	Entidade (OCID)	Não disponível para uso com operações de solicitação de serviço.
`data-catalog-glossaries`	`target.glossary.key`	String A chave é o Identificador Exclusivo Universal (UUID) para o glossário, em um formato de string. Este ID não é um OCID.	Disponível para uso somente com operações do glossário, exceto para `CreateGlossary`.
`data-catalog-namespaces`	`target.catalog.id`	Entidade (OCID)	Não disponível para uso com operações de solicitação de serviço.
`data-catalog-namespaces`	`target.namespace.key`	A chave é o Identificador Exclusivo Universal (UUID) para o namespace, em formato de string. Este ID não é um OCID.	Disponível para uso somente com operações de namespace.
`data-catalog-metastores`	`target.metastore.id`	Entidade (OCID)	Disponível para uso somente com operações de metastore.
`data-catalog-metastore-assets`	`target.metastore.id`	Entidade (OCID)	Disponível para uso somente com operações de ativos de metastore.
`data-catalog-metastore-assets`	`target.metastore.catalog.key` `target.metastore.database.key` `target.metastore.table.key`	Entidade (OCID)	Disponível para uso somente com operações de ativos de metastore.
`data-catalog-metastore-assets`	`target.metastore.catalog.name` `target.metastore.database.name` `target.metastore.table.name`	String	Disponível para uso somente com operações de ativos de metastore.

Detalhes para Combinações de Verbos + Tipo de Recurso

As tabelas a seguir mostram as permissões e operações de API abrangidas por cada verbo do serviço Data Catalog. O nível de acesso é cumulativo à medida que você vai de inspect > read > use > manage. Um sinal de mais (+) em uma célula da tabela indica o acesso incremental comparado à célula diretamente acima dela, enquanto "sem extra" indica que não há acesso incremental.

data-catalogs

As APIs cobertas para o tipo de recurso data-catalogs são listadas aqui. As APIs são exibidas em ordem alfabética para cada permissão.


INSPECT
Permissões	APIs Completas	APIs Parcialmente Cobertas
CATALOG_INSPECT	`ListCatalogs`	nenhuma
CATALOG_JOB_DEFINITION_INSPECT	`ListJobDefinitions`
CATALOG_JOB_INSPECT	`ListJobs`
CATALOG_JOB_INSPECT	`ListWorkRequests`
READ
Permissões	APIs Completas	APIs Parcialmente Cobertas
INSPECT +	INSPECT +	nenhuma
CATALOG_JOB_DEFINITION_READ	`GetJobDefinition`
CATALOG_JOB_DEFINITION_READ	`ListJobDefinitionPermissions`
CATALOG_JOB_READ	`GetJob`
	`GetJobExecution`
	`GetJobLog`
	`GetJob`
	`GetJobExecution`
	`GetJobLog`
	`ListJobMetrics`
CATALOG_READ	`GetCatalog`
	`GetType`
	`ListCatalogPermissions`
	`ListDataAssetPermissions`
	`ListGlossaries`
	`ListTypes`
	`ListSearchResults`
	`SuggestMatches`
CATALOG_WORK_REQUEST_READ	`GetWorkRequest`
	`ListWorkRequestErrors`
	`ListWorkRequestLogs`
USAR
Permissões	APIs Completas	APIs Parcialmente Cobertas
READ +	READ +	nenhuma
CATALOG_UPDATE	`UpdateCatalog`
CATALOG_JOB_DEFINITION_CREATE	`CreateJobDefinition`
CATALOG_JOB_DEFINITION_UPDATE	`UpdateJobDefinition`
CATALOG_JOB_DEFINITION_DELETE	`DeleteJobDefinition`
CATALOG_JOB_CREATE	`CreateJob`
CATALOG_JOB_UPDATE	`UpdateJob`
CATALOG_JOB_DELETE	`DeleteJobDefinition`
CATALOG_ATTACH_CATALOG_PRIVATE_ENDPOINT	`AttachCatalogPrivateEndpoint`
CATALOG_DETACH_CATALOG_PRIVATE_ENDPOINT	`DetachCatalogPrivateEndpoint`
MANAGE
Permissões	APIs Completas	APIs Parcialmente Cobertas
USE +	USE +	nenhuma
CATALOG_CREATE	`CreateCatalog`
CATALOG_DELETE	`DeleteCatalog`
CATALOG_MOVE	`ChangeCatalogCompartment`

data-catalog-private-endpoints

As APIs abrangidas para o tipo de recurso data-catalog-private-endpoints são listadas aqui. As APIs são exibidas em ordem alfabética para cada permissão.


INSPECT
Permissões	APIs Completas	APIs Parcialmente Cobertas
CATALOG_PRIVATE_ENDPOINT_INSPECT	`ListCatalogPrivateEndpoints`	nenhuma
READ
Permissões	APIs Completas	APIs Parcialmente Cobertas
INSPECT +	INSPECT +	nenhuma
CATALOG_PRIVATE_ENDPOINT_READ	`GetCatalogPrivateEndpoint`	nenhuma
USAR
Permissões	APIs Completas	APIs Parcialmente Cobertas
READ +	READ +	nenhuma
CATALOG_PRIVATE_ENDPOINT_MOVE	`AttachCatalogPrivateEndpoint`
	`DetachCatalogPrivateEndpoint`
	`UpdateCatalogPrivateEndpoint`
MANAGE
Permissões	APIs Completas	APIs Parcialmente Cobertas
USE +	USE +	nenhuma
CATALOG_PRIVATE_ENDPOINT_MOVE	`ChangeCatalogPrivateEndpointCompartment`
CATALOG_PRIVATE_ENDPOINT_CREATE	`CreateCatalogPrivateEndpoint`
CATALOG_PRIVATE_ENDPOINT_DELETE	`DeleteCatalogPrivateEndpoint`

data-catalog-data-assets

As APIs abrangidas para o tipo de recurso data-catalog-data-assets são listadas aqui. As APIs são exibidas em ordem alfabética para cada permissão.


INSPECT
Permissões	APIs Completas	APIs Parcialmente Cobertas
CATALOG_DATA_ASSET_INSPECT	`ListDataAssets`	nenhuma
CATALOG_DATA_ASSET_TAG_INSPECT	`ListAttributeTags`
	`ListDataAssetTags`
	`ListEntityTags`
	`ListFolderTags`
READ
Permissões	APIs Completas	APIs Parcialmente Cobertas
INSPECT +	INSPECT +	nenhuma
CATALOG_DATA_ASSET_READ	`GetAttribute`
	`GetConnection`
	`GetDataAsset`
	`GetEntity`
	`GetFolder`
	`GetPattern`
	`ListAttributes`
	`ListConnections`
	`ListEntities`
	`ListDerivedLogicalEntities`
	`ListFolders`
	`ListPattern`
	`ParseConnection`
	`ValidatePattern`
CATALOG_DATA_ASSET_TAG_READ	`GetAttributeTag`
	`GetDataAssetTag`
	`GetEntityTag`
	`GetFolderTag`
USAR
Permissões	APIs Completas	APIs Parcialmente Cobertas
READ +	READ +	nenhuma
CATALOG_DATA_ASSET_UPDATE	`AddDataSelectorPatterns`
	`CreateAttribute`
	`CreateConnection`
	`CreateEntity`
	`CreateFolder`
	`CreatePattern`
	`DeleteAttribute`
	`DeleteConnection`
	`DeleteEntity`
	`DeleteFolder`
	`DeletePattern`
	`ImportConnection`
	`RemoveDataSelectorPatterns`
	`TestConnection`
	`UpdateAttribute`
	`UpdateConnection`
	`UpdateDataAsset`
	`UpdateEntity`
	`UpdateFolder`
	`UpdatePattern`
	`ValidateConnection`
CATALOG_DATA_ASSET_TAG_CREATE	`CreateAttributeTag`
	`CreateDataAssetTag`
	`CreateEntityTag`
	`CreateFolderTag`
CATALOG_DATA_ASSET_TAG_DELETE	`DeleteDataAssetTag`
	`DeleteAttributeTag`
	`DeleteEntityTag`
	`DeleteFolderTag`
CATALOG_DATA_ASSET_TAG_UPDATE	não utilizado
MANAGE
Permissões	APIs Completas	APIs Parcialmente Cobertas
USE +	USE +	nenhuma
CATALOG_DATA_ASSET_CREATE	`CreateDataAsset`
CATALOG_DATA_ASSET_DELETE	`DeleteDataAsset`

data-catalog-glossaries

As APIs cobertas para o tipo de recurso data-catalog-glossaries são listadas aqui. As APIs são exibidas em ordem alfabética para cada permissão.


INSPECT
Permissões	APIs Completas	APIs Parcialmente Cobertas
CATALOG_GLOSSARY_INSPECT	`ListGlossaries`	nenhuma
READ
Permissões	APIs Completas	APIs Parcialmente Cobertas
INSPECT +	INSPECT +	nenhuma
CATALOG_GLOSSARY_READ	`ExpandTreeForGlossary`
	`ExportGlossary`
	`GetGlossary`
	`GetTerm`
	`GetTermRelationship`
	`ListGlossaryTermRelationships`
	`ListGlossaryTerms`
USAR
Permissões	APIs Completas	APIs Parcialmente Cobertas
READ +	READ +	nenhuma
CATALOG_GLOSSARY_UPDATE	`CreateTerm`
	`CreateTermRelationship`
	`UpdateTerm`
	`DeleteTerm`
	`UpdateTermRelationship`
	`DeleteTermRelationship`
	`UpdateGlossary`
	`ImportGlossary`
MANAGE
Permissões	APIs Completas	APIs Parcialmente Cobertas
USE +	USE +	nenhuma
CATALOG_GLOSSARY_CREATE	`CreateGlossary`
CATALOG_GLOSSARY_DELETE	`DeleteGlossary`

data-catalog-namespaces

As APIs incluídas no tipo de recurso data-catalog-namespaces são listadas aqui. As APIs são exibidas em ordem alfabética para cada permissão.


INSPECT
Permissões	APIs Completas	APIs Parcialmente Cobertas
CATALOG_NAMESPACE_INSPECT	`ListNamespaces`	nenhuma
READ
Permissões	APIs Completas	APIs Parcialmente Cobertas
INSPECT +	INSPECT +	nenhuma
CATALOG_NAMESPACE_READ	`GetCustomProperty`
	`GetNamespace`
	`ListCustomProperties`
USAR
Permissões	APIs Completas	APIs Parcialmente Cobertas
READ +	READ +	nenhuma
CATALOG_NAMESPACE_UPDATE	`AssociateCustomProperty`
	`CreateCustomProperty`
	`DeleteCustomProperty`
	`DisassociateCustomProperty`
	`UpdateCustomProperty`
	`UpdateNamespace`
MANAGE
Permissões	APIs Completas	APIs Parcialmente Cobertas
USE +	USE +	nenhuma
CATALOG_NAMESPACE_CREATE	`CreateNamespace`
CATALOG_NAMESPACE_DELETE	`DeleteNamespace`

data-catalog-metastores

As APIs abrangidas para o tipo de recurso data-catalog-metastores são listadas aqui. As APIs são exibidas em ordem alfabética para cada permissão.


INSPECT
Permissões	APIs Completas	APIs Parcialmente Cobertas
CATALOG_METASTORE_INSPECT	`ListMetastores`	nenhuma
READ
Permissões	APIs Completas	APIs Parcialmente Cobertas
INSPECT +	INSPECT +	nenhuma
CATALOG_METASTORE_READ	`GetMetastore`	nenhuma
USAR
Permissões	APIs Completas	APIs Parcialmente Cobertas
READ +	READ +	nenhuma
CATALOG_METASTORE_UPDATE	`UpdateMetastore`	nenhuma
MANAGE
Permissões	APIs Completas	APIs Parcialmente Cobertas
USE +	USE +	nenhuma
CATALOG_METASTORE_CREATE	`CreateMetastore`
CATALOG_METASTORE_DELETE	`DeleteMetastore`
CATALOG_METASTORE_MOVE	`ChangeMetastoreCompartment`

data-catalog-metastore-assets

As APIs abrangidas para o tipo de recurso data-catalog-metastore-assets são listadas aqui.


INSPECT
Permissões	APIs Completas	APIs Parcialmente Cobertas
CATALOG_METASTORE_CATALOG_INSPECT	`MetastoreExecute`	nenhuma
CATALOG_METASTORE_DATABASE_INSPECT	`MetastoreExecute`
CATALOG_METASTORE_TABLE_INSPECT	`MetastoreExecute`
READ
Permissões	APIs Completas	APIs Parcialmente Cobertas
INSPECT +	INSPECT +	nenhuma
CATALOG_METASTORE_CATALOG_READ	`MetastoreExecute`
CATALOG_METASTORE_DATABASE_READ	`MetastoreExecute`
CATALOG_METASTORE_TABLE_READ	`MetastoreExecute`
USAR
Permissões	APIs Completas	APIs Parcialmente Cobertas
READ +	READ +	nenhuma
CATALOG_METASTORE_CATALOG_UPDATE	`MetastoreExecute`
CATALOG_METASTORE_DATABASE_UPDATE	`MetastoreExecute`
CATALOG_METASTORE_TABLE_UPDATE	`MetastoreExecute`
MANAGE
Permissões	APIs Completas	APIs Parcialmente Cobertas
USE +	USE +	nenhuma
CATALOG_METASTORE_CATALOG_CREATE	`MetastoreExecute`
CATALOG_METASTORE_CATALOG_DELETE	`MetastoreExecute`
CATALOG_METASTORE_DATABASE_CREATE	`MetastoreExecute`
CATALOG_METASTORE_DATABASE_DELETE	`MetastoreExecute`
CATALOG_METASTORE_TABLE_CREATE	`MetastoreExecute`
CATALOG_METASTORE_TABLE_DELETE	`MetastoreExecute`

Permissões Exigidas para Cada Operação de API

A tabela a seguir lista as operações de API em uma ordem lógica, agrupadas por tipo de recurso. Os tipos de recursos são data-catalogs, data-catalog-private-endpoints, data-catalog-data-assets, data-catalog-glossaries e data-catalog-namespaces.

Para obter informações sobre permissões, consulte permissões.