Learn about resource-types you can use in your policies.
An aggregate resource-type covers the list of individual resource-types that directly
follow. For example, writing one policy to allow a group to have access to the
database-family is equivalent to writing separate policies for the
group that would grant access to the cloud-exadata-infrastructures,
cloud-vmclusters, db-nodes,
db-homes, databases,
database-software-image, and backups
resource-types. For more information, see Resource-Types.
The level of access is cumulative as you go from inspect >
read > use > manage. A plus sign
(+) in a table cell indicates incremental access compared to the cell directly above it,
whereas "no extra" indicates no incremental access.
For example, the read verb for the vmclusters
resource-type covers no extra permissions or API operations compared to the
inspect verb. However, the use verb includes one
more permission, fully covers one more operation, and partially covers another
additional operation.
Permissions and API operation details for VM Clusters 🔗
The table below lists permissions and API operations for cloud-vmclusters.
Verbs
Permissions
APIs Fully Covered
APIs Partially Covered
inspect
CLOUD_VM_CLUSTER_INSPECT
ListCloudVmClusters
GetCloudVmCluster
ListCloudVmClusterUpdates
ListCloudVmClusterUpdateHistoryEntries
GetCloudVmClusterUpdate
GetCloudVmClusterUpdateHistoryEntry
none
read
no extra
no extra
none
use
READ +
CLOUD_VM_CLUSTER_UPDATE
CLOUD_VM_CLUSTER_UPDATE_TAGS
CLOUD_VM_CLUSTER_UPDATE_COMPARTMENT
CLOUD_VM_CLUSTER_UPDATE_SSH_KEY
CLOUD_VM_CLUSTER_UPDATE_LICENSE
CLOUD_VM_CLUSTER_UPDATE_CPU
CLOUD_VM_CLUSTER_UPDATE_MEMORY
CLOUD_VM_CLUSTER_UPDATE_LOCAL_STORAGE
CLOUD_VM_CLUSTER_UPDATE_EXADATA_STORAGE
CLOUD_VM_CLUSTER_UPDATE_GI_SOFTWARE
CLOUD_VM_CLUSTER_UPDATE_GUEST_OS_SOFTWARE
CLOUD_VM_CLUSTER_UPDATE_FILE_SYSTEM
CLOUD_VM_CLUSTER_UPDATE_DIAGNOSTIC_LOGS
CLOUD_VM_CLUSTER_UPDATE_IORM
no extra
ChangeCloudVmClusterCompartment (also needs use db-homes, use databases, and inspect db-backups)
manage
USE +
CLOUD_VM_CLUSTER_CREATE
CLOUD_VM_CLUSTER_DELETE
UpdateCloudVmCluster
CreateCloudVmCluster, DeleteCloudVmCluster (both also need manage db-homes, manage databases, use vnics, and use subnets) ; RemoveVmFromCloudVmCluster, AddVmToCloudVmCluster (both also need use cloud_exadata_infrastructure_update
Note
The CLOUD_VM_CLUSTER_UPDATE_SSH_KEY permission is a highly privileged permission that allows the user to be a root user on the guest VM and gives them the ability to run other cluster update operations on the guest VM using dbaascli.
Using fine-grained permissions, you can write policies as follows:
To allow any update operations:
allow group abc to use cloud-vmclusters in compartment comp1
To allow only scale CPU:
allow group abc to use cloud-vmclusters in compartment comp1 where request.permission = 'CLOUD_VM_CLUSTER_UPDATE_CPU'
To allow GI update and any scale operations:
allow group abc to use cloud-vmclusters in compartment comp1
where any
{ request.permission = 'CLOUD_VM_CLUSTER_UPDATE_CPU', request.permission = 'CLOUD_VM_CLUSTER_UPDATE_EXADATA_STORAGE',
request.permission = 'CLOUD_VM_CLUSTER_UPDATE_MEMORY', request.permission = 'CLOUD_VM_CLUSTER_UPDATE_LOCAL_STORAGE'', request.permission = 'CLOUD_VM_CLUSTER_UPDATE_GI_SOFTWARE'}
To allow any operations except add SSH key:
allow group abc to use cloud-vmclusters in compartment comp1 where all { request.permission != 'CLOUD_VM_CLUSTER_UPDATE_SSH_KEY' , request.permission != 'CLOUD_VM_CLUSTER_UPDATE' }
Permissions and API operation details for DB Homes 🔗
The table below lists permissions and API operations for db-homes.
Verbs
Permissions
APIs Fully Covered
APIs Partially Covered
inspect
DB_HOME_INSPECT
ListDBHome
GetDBHome
ListDbHomePatches
ListDbHomePatchHistoryEntries
GetDbHomePatch
GetDbHomePatchHistoryEntry
none
read
no extra
no extra
none
use
DB_HOME_UPDATE
UpdateDBHome
ChangeCloudVmClusterCompartment (also needs
use cloud-vmclusters, use databases, and
inspect backups)
manage
USE +
DB_HOME_CREATE
DB_HOME_DELETE
no extra
CreateCloudVmCluster, DeleteCloudVmCluster (both
also need manage cloud-vmclusters, manage databases, use
vnics, and use subnets). If automatic
backups are enabled on the default database, also needs
manage backups
CreateDbHome, (also needs use
cloud-vmclusters and manage
databases). If creating the Database Home by restoring from
a backup, also needs read backups
DeleteDbHome, (also needs use
cloud-vmclusters and manage
databases). If automatic backups are enabled on the default
database, also needs manage backups. If the
performFinalBackup option is selected, also
needs manage backups and read
databases.
CLOUD_VM_CLUSTER_CREATE and
CLOUD_EXADATA_INFRASTRUCTURE_UPDATE and
VNIC_CREATE and VNIC_ATTACH and
SUBNET_ATTACH and (needed if Private DNS is
used: DNS_ZONE_READ,
DNS_RECORD_UPDATE,
DNS_ZONE_CREATEDNS_VIEW_INSPECT)
ChangeCloudVmClusterCompartment
CLOUD_VM_CLUSTER_UPDATE
UpdateCloudVmCluster
CLOUD_VM_CLUSTER_UPDATE and
CLOUD_EXADATA_INFRASTRUCTURE_UPDATE
GetCloudVmClusterIormConfig
CLOUD_VM_CLUSTER_INSPECT
UpdateCloudVmClusterIormConfig
CLOUD_VM_CLUSTER_UPDATE
DeleteCloudVmCluster
CLOUD_VM_CLUSTER_DELETE and
CLOUD_EXADATA_INFRASTRUCTURE_UPDATE and
DB_HOME_DELETE and VNIC_DELETE
and SUBNET_DETACH and VNIC_DETACH
and (needed if Private DNS is used: DNS_ZONE_READ,
DNS_RECORD_UPDATE,
DNS_ZONE_DELETE)
AddVmToCloudVmCluster
CLOUD_VM_CLUSTER_UPDATE and
CLOUD_EXADATA_INFRASTRUCTURE_UPDATE and (needed
if Private DNS is used: DNS_ZONE_READ,
DNS_RECORD_UPDATE,
DNS_ZONE_CREATE,
DNS_VIEW_INSPECT)
RemoveVmFromCloudVmCluster
CLOUD_VM_CLUSTER_UPDATE and
CLOUD_EXADATA_INFRASTRUCTURE_UPDATE and (needed
if Private DNS is used: DNS_ZONE_READ,
DNS_RECORD_UPDATE,
DNS_ZONE_DELETE)
Table 6-8 Cloud VM Cluster Maintenance
Updates and Update History
API Operation
Permissions Required to Use the Operation
ListCloudVmClusterUpdates
CLOUD_VM_CLUSTER_INSPECT
GetCloudVmClusterUpdate
CLOUD_VM_CLUSTER_INSPECT
ListCloudVmClusterUpdateHistoryEntries
CLOUD_VM_CLUSTER_INSPECT
GetCloudVmClusterUpdateHistoryEntry
CLOUD_VM_CLUSTER_INSPECT
Table 6-9 Virtual Machines / Nodes
API Operation
Permissions Required to Use the Operation
ListDbNodes
DB_NODE_INSPECT
GetDbNode
DB_NODE_INSPECT
DbNodeAction
DB_NODE_POWER_ACTIONS
Table 6-10 Database Homes
API Operation
Permissions Required to Use the Operation
ListDbHomes
DB_HOME_INSPECT
GetDbHome
DB_HOME_INSPECT
ListDbHomePatches
DB_HOME_INSPECT
ListDbHomePatchHistoryEntries
DB_HOME_INSPECT
GetDbHomePatch
DB_HOME_INSPECT
GetDbHomePatchHistoryEntry
DB_HOME_INSPECT
CreateDbHome
DB_SYSTEM_INSPECT and
DB_SYSTEM_UPDATE and
DB_HOME_CREATE and
DATABASE_CREATE
To enable automatic backups for the database, also
need DB_BACKUP_CREATE and
DATABASE_CONTENT_READ
UpdateDbHome
DB_HOME_UPDATE
DeleteDbHome
DB_SYSTEM_UPDATE and
DB_HOME_DELETE and
DATABASE_DELETE
If automatic backups are enabled, also need
DELETE_BACKUP
If performing a final backup on termination, also
need DB_BACKUP_CREATE and
DATABASE_CONTENT_READ
Table 6-11 Databases (CDB)
API Operation
Permissions Required to Use the Operation
ListDatabases
DATABASE_INSPECT
GetDatabase
DATABASE_INSPECT
CreateDatabase
DATABASE_UPDATE
To enable automatic backups, also need
DB_BACKUP_CREATE and
DATABASE_CONTENT_READ
UpdateDatabase
DATABASE_UPDATE
To enable automatic backups, also need
DB_BACKUP_CREATE and
DATABASE_CONTENT_READ
DeleteDatabase
For new resource model using VM cluster resource:
CLOUD_VM_CLUSTER_INSPECT and
DB_HOME_UPDATE and
DATABASE_DELETE
enableDatabaseManagement
DATABASE_INSPECT and
DATABASE_UPDATE
disableDatabaseManagement
DATABASE_INSPECT and
DATABASE_UPDATE
disableDatabaseManagement
DATABASE_INSPECT and
DATABASE_UPDATE
Table 6-12 Pluggable Databases (PBDs)
API Operation
Permissions Required to Use the Operation
ListPluggableDatabase
PLUGGABLE_DATABASE_INSPECT
GetPluggableDatabase
PLUGGABLE_DATABASE_INSPECT
CreatePluggableDatabase
PLUGGABLE_DATABASE_CREATE and
DATABASE_INSPECT and
DATABASE_UPDATE
UpdatePluggableDatabase
PLUGGABLE_DATABASE_INSPECT and
PLUGGABLE_DATABASE_UPDATE
StartPluggableDatabase
PLUGGABLE_DATABASE_INSPECT and
PLUGGABLE_DATABASE_UPDATE
StopPluggableDatabase
PLUGGABLE_DATABASE_INSPECT and
PLUGGABLE_DATABASE_UPDATE
DeletePluggableDatabase
PLUGGABLE_DATABASE_DELETE and
DATABASE_INSPECT and
DATABASE_UPDATE
LocalClonePluggableDatabase
PLUGGABLE_DATABASE_INSPECT and
PLUGGABLE_DATABASE_UPDATE and
PLUGGABLE_DATABASE_CONTENT_READ and
PLUGGABLE_DATABASE_CONTENT_WRITE and
PLUGGABLE_DATABASE_CREATE and
DATABASE_INSPECT and
DATABASE_UPDATE
RemoteClonePluggableDatabase
PLUGGABLE_DATABASE_INSPECT and
PLUGGABLE_DATABASE_UPDATE and
PLUGGABLE_DATABASE_CONTENT_READ and
PLUGGABLE_DATABASE_CONTENT_WRITE and
PLUGGABLE_DATABASE_CREATE and
DATABASE_INSPECT and
DATABASE_UPDATE
enableDatabaseManagement
DATABASE_INSPECT and
DATABASE_UPDATE
disableDatabaseManagement
DATABASE_INSPECT and
DATABASE_UPDATE
disableDatabaseManagement
DATABASE_INSPECT and
DATABASE_UPDATE
Table 6-13 System Shapes and Database
Versions
API Operation
Permissions Required to Use the Operation
ListDbSystemShapes
(no permissions required; available to
anyone)
ListDbVersions
(no permissions required; available to
anyone)
Table 6-14 Oracle Data Guard
Associations
API Operation
Permissions Required to Use the Operation
GetDataGuardAssociation
DATABASE_INSPECT
ListDataGuardAssociations
DATABASE_INSPECT
CreateDataGuardAssociation
DB_SYSTEM_UPDATE and
DB_HOME_CREATE and
DB_HOME_UPDATE and
DATABASE_CREATE and
DATABASE_UPDATE
SwitchoverDataGuardAssociation
DATABASE_UPDATE
FailoverDataGuardAssociation
DATABASE_UPDATE
ReinstateDataGuardAssociation
DATABASE_UPDATE
Table 6-15 Backups and Database
Restore
API Operation
Permissions Required to Use the Operation
GetBackup
DB_BACKUP_INSPECT
ListBackups
DB_BACKUP_INSPECT
CreateBackup
DB_BACKUP_CREATE and
DATABASE_CONTENT_READ
DeleteBackup
DB_BACKUP_DELETE and
DB_BACKUP_INSPECT
RestoreDatabase
DB_BACKUP_INSPECT and
DB_BACKUP_CONTENT_READ and
DATABASE_CONTENT_WRITE
Table 6-16 Application VIP
API Operation
Permissions Required to Use the Operation
CreateApplicationVip
APPLICATION_VIP_CREATE and
CLOUD_VM_CLUSTER_UPDATE and
PRIVATE_IP_CREATE and
PRIVATE_IP_ASSIGN and
VNIC_ASSIGN and
SUBNET_ATTACH
DeleteApplicationVip
APPLICATION_VIP_DELETE and
CLOUD_VM_CLUSTER_UPDATE and
PRIVATE_IP_DELETE and
PRIVATE_IP_UNASSIGN and
VNIC_UNASSIGN and
SUBNET_DETACH
ListApplicationVips
APPLICATION_VIP_INSPECT
ListApplicationVips
APPLICATION_VIP_INSPECT
Table 6-17 Serial Console Access to VM
API Operation
Permissions Required to Use the Operation
AddVirtualMachineToVmCluster
VM_CLUSTER_UPDATE and
EXADATA_INFRASTRUCTURE_UPDATE
RemoveVirtualMachineFromVmCluster
VM_CLUSTER_UPDATE and
EXADATA_INFRASTRUCTURE_UPDATE
CreateDbNodeConsoleConnection
DBNODE_CONSOLE_CONNECTION_CREATE
and DBNODE_CONSOLE_CONNECTION_INSPECT