Viewing All Resources in a Compartment
This topic describes how you can use the tenancy explorer to get a cross-region view of all resources in a compartment.
Tenancy Explorer Highlights
- The tenancy explorer lets you view all your resources in a compartment, across all regions in your tenancy.
- You can choose to view just the resources that reside in the selected compartment, or you can choose to view all the resources in all the subcompartments as well, to get a full view of the compartment tree.
- You can take actions on resources from the tenancy explorer. You can delete or move a single or multiple resources at a time. The tenancy explorer is a convenient option when you need to perform bulk delete or move actions on multiple resources.
The following image highlights these features:
When using the tenancy explorer, be aware of the following:
- If you recently created a resource, it might not show up in the tenancy explorer immediately. Similarly, if you recently updated a resource, your changes might not immediately appear.
- You must be in the same region as the resource to navigate to its details page. The tenancy explorer displays the resource's region. Use the region selector at the top of the Console to change to the same region as the resource to enable these actions.
- When taking bulk actions, you can monitor progress on the Work Requests page.
Work Requests
Tenancy explorer is one of the Oracle Cloud Infrastructure features that is integrated with the Work Requests API. For general information on using work requests in Oracle Cloud Infrastructure, see Work Requests in the user guide, and the Work Requests API.
Resources Supported by the Tenancy Explorer
The tenancy explorer is powered by the Search service and supports the same resource types. Most resources are supported.
Service | Resource Type | Attributes |
---|---|---|
Application Migration | amsmigration
|
See Migration Reference |
Application Migration | amssource
|
See Source Reference. |
Analytics Cloud | analyticsinstance
|
See AnalyticsInstance Reference. |
API Gateway | apideployment
|
See Deployment Reference. |
API Gateway | apigateway
|
See Gateway Reference. |
API Gateway | apigatewayapi
|
See Api Reference. |
API Gateway | apigatewaycertificate
|
See Certificate Reference. |
Big Data | bigdataservice
|
See BdsInstance Reference. |
Block Volume | bootvolume
|
See BootVolume Reference. |
Block Volume | bootvolumebackup
|
See BootVolumeBackup Reference. |
Block Volume | volume
|
See Volume Reference. |
Block Volume | volumebackup
|
See VolumeBackup
Reference. Note: Queries for the
|
Block Volume | volumebackuppolicy
|
See VolumeBackupPolicy Reference. |
Block Volume | volumegroup
|
See VolumeGroup Reference. |
Block Volume | volumegroupbackup
|
See VolumeGroupBackup Reference. |
Blockchain Platform | blockchainplatforms
|
See BlockchainPlatform Reference. |
Budgets | budget
|
See Budget Reference. |
Cloud Guard | cloudguarddetectorrecipe
|
|
Cloud Guard | cloudguardmanagedlist
|
|
Cloud Guard | cloudguardresponderrecipe
|
|
Cloud Guard | cloudguardtarget
|
See Target Reference. |
Compute | autoscalingconfiguration
|
See AutoScalingConfiguration Reference. Note: Queries for the |
Compute | clusternetwork
|
Note: Queries for the |
Compute | consolehistory
|
See ConsoleHistory Reference. |
Compute | dedicatedvmhost
|
|
Compute | image
|
See Image Reference. |
Compute | instance
|
See Instance Reference. Note: Queries for the |
Compute | instanceconfiguration
|
See InstanceConfiguration Reference. |
Compute | instancepool
|
Note: Queries for the |
Content and Experience | oceinstance |
See OceInstance Reference. |
Data Catalog | datacatalog
|
See Catalog Reference. |
Data Catalog | datacatalogprivateendpoint
|
See CatalogPrivateEndpoint Reference. |
Data Flow | application
|
See Application Reference. |
Data Flow | run
|
See Run Reference. |
Data Integration | disworkspace
|
See Workspace Reference. |
Data Safe | datasafeprivateendpoint
|
See DataSafePrivateEndpoint Reference. |
Data Science | datasciencemodel
|
See Model Reference. |
Data Science | datasciencenotebooksession
|
See NotebookSession Reference. |
Data Science | datascienceproject
|
See Project Reference. |
Database | autonomouscontainerdatabase
|
See AutonomousContainerDatabase Reference. |
Database | autonomousdatabase
|
See AutonomousDatabase Reference. |
Database | autonomousexadatainfrastructure
|
See AutonomousExadataInfrastructure Reference. |
Database | autonomousvmcluster
|
See AutonomousVmCluster Reference. |
Database | backupdestination
|
See BackupDestination Reference. |
Database | cloudexadatainfrastructure
|
See CloudExadataInfrastructure Reference. |
Database | cloudvmcluster
|
See CloudVmCluster Reference. |
Database | database
|
See Database Reference. |
Database | dbhome
|
See DbHome Reference. |
Database | dbsystem
|
See DbSystem Reference. |
Database | exadatainfrastructure
|
See ExadataInfrastructure Reference. |
Database | externalcontainerdatabase
|
See ExternalContainerDatabase Reference. |
Database | externaldatabaseconnector
|
See ExternalDatabaseConnector Reference. |
Database | externalnoncontainerdatabase
|
See ExternalNonContainerDatabase Reference. |
Database | externalpluggabledatabase
|
See ExternalPluggableDatabase Reference. |
Database | vmcluster
|
See VmCluster Reference. |
Database | vmclusternetwork
|
See VmClusterNetwork Reference. |
Digital Assistant | odainstance
|
See OdaInstance Reference. |
Email Delivery | emailsender
|
See Sender Reference. |
Events | eventrule
|
See Rule Reference. |
File Storage | filesystem
|
See FileSystem Reference. |
File Storage | mounttarget
|
See MountTarget Reference. |
Functions | functionsapplication
|
See Application Reference. |
Functions | functionsfunction
|
See Function Reference. |
IAM | compartment
|
See Compartment Reference. |
IAM | group
|
See Group Reference. |
IAM | identityprovider
|
See IdentityProvider Reference. |
IAM | policy
|
See Policy Reference. |
IAM | tagdefault
|
See TagDefault Reference. |
IAM | tagnamespace
|
See TagNamespace Reference. |
IAM | user
|
See User Reference. |
Integration Cloud | integrationinstance
|
See IntegrationInstance Reference. |
Load Balancing | loadbalancer
|
See LoadBalancer Reference. |
Management Agent | management-agents |
See ManagementAgent Reference. |
Management Agent | management-agent-install-keys |
See ManagementAgentInstallKey Reference. |
Monitoring | alarm
|
See Search-Supported Attributes for Alarms. |
MySQL Database | dbsystem
|
See DBSystem Reference. |
Networking | byoiprange
|
See ByoipRange Reference. |
Networking | cpe
|
See Cpe Reference. |
Networking | crossconnect
|
See CrossConnect Reference. |
Networking | crossconnectgroup
|
See CrossConnectGroup Reference. |
Networking | dhcpoptions |
See DhcpOptions Reference. |
Networking | drg
|
See Drg Reference. |
Networking | internetgateway |
See InternetGateway Reference. |
Networking | ipsecconnection
|
See IPSecConnection Reference. |
Networking | ipv6
|
See IPv6 Reference. |
Networking | localpeeringgateway |
See LocalPeeringGateway Reference. |
Networking | natgateway
|
See NatGateway Reference. |
Networking | networksecuritygroup
|
See NetworkSecurityGroup Reference. |
Networking | publicip
|
See PublicIp Reference. |
Networking | publicippool
|
See PublicIpPool Reference. |
Networking | privateip
|
See PrivateIp Reference. |
Networking | remotepeeringconnection
|
See RemotePeeringConnection Reference. |
Networking | routetable
|
See RouteTable Reference. |
Networking | securitylist
|
See SecurityList Reference. |
Networking | servicegateway
|
See ServiceGateway Reference. |
Networking | subnet
|
See Subnet Reference. |
Networking | vcn
|
See Vcn Reference. |
Networking | virtualcircuit
|
See VirtualCircuit Reference. |
Networking | vlan |
See Vlan Reference. |
Networking | vnic
|
See Vnic Reference. Note: Queries for the |
NoSQL Database Cloud | table
|
See Table Reference. |
Notifications | onssubscription
|
Note: Queries for the |
Notifications | onstopic
|
See NotificationTopic Reference. |
Object Storage | bucket
|
See Bucket Reference. |
OS Management | osmsmanagedinstancegroup
|
See ManagedInstanceGroup Reference. |
OS Management | osmsscheduledjob
|
See ScheduledJob Reference. |
OS Management | osmssoftwaresource
|
See SoftwareSource Reference. |
Registry | containerimage
|
See ContainerImage Reference. |
Registry | containerrepository
|
See ContainerRepository Reference. |
Resource Manager | ormconfigsourceprovider
|
See ConfigurationSourceProvider Reference. |
Resource Manager | ormjob
|
See Job Reference. |
Resource Manager | ormstack
|
See Stack Reference. |
Resource Manager | ormtemplate |
See Template Reference. |
Service Connector Hub | serviceconnector |
See ServiceConnector Reference. |
Service Limits | quota
|
See Quota Reference. |
Streaming | connectharness
|
See ConnectHarness Reference. |
Streaming | stream
|
See Stream Reference. |
Vault | key
|
See Key Reference. |
Vault | vault
|
See Vault Reference. |
Vault | vaultsecret
|
See Secret Reference. |
VMware solution | vmwareesxihost
|
See EsxiHost Reference. |
VMware solution | vmwaresddc
|
See Sddc Reference. |
WAF | httpredirect
|
See HttpRedirect Reference. |
WAF | waasaddresslist
|
See AddressList Reference. |
WAF | waascertificate
|
See Certificate Reference. |
WAF | waascustomprotectionrule
|
See CustomProtectionRule Reference. |
WAF | waaspolicy
|
See WaasPolicy Reference. |
Required IAM Policy to Work with Resources in the Tenancy Explorer
The resources that you see in the tenancy explorer depend on the permissions you have in place for the resource type.
You do not necessarily see results for everything in the compartment. For example, if
your user account is not associated with a policy that grants you the ability to, at a
minimum, inspect
the instance
resource type, then you
can't view instances in the tenancy explorer. For more information about policies, see
How Policies Work. For information about the
permissions required for the list API operation for a specific resource type, see the
Policy Reference for the appropriate
service.
Required Permissions to View Work Requests
Work requests inherit the permissions of the operation that spawns the work request. So if you have the permissions to move or delete a resource, you also have permission to see the work requests associated with this action.
To enable users to list all work requests in a tenancy, use a policy like the following:
Allow group <My_Group> to inspect work-requests in tenancy
Navigating to the Tenancy Explorer and Viewing Resources
Open the navigation menu. Under Governance and Administration, go to Governance and click Tenancy Explorer.
The tenancy explorer opens with a view of the root compartment. Select the compartment you want to explore from the compartment picker on the left side of the Console. After you select a compartment, the resources that you have permission to view are displayed. The Name and Description of the compartment you are viewing are displayed at the top of the page.To also list all resources in the subcompartments of the selected compartment, select Show resources in subcompartments. When viewing resources in all subcompartments, it is helpful to use the Compartment column in the results list to see the compartment hierarchy where the resource resides.Filtering Displayed Resources
To view only specific resource types, select the resource types you are interested in from the Filter by resource type menu. You can select multiple resources to include in the filtered list. You can also filter the list by tags.
Opening the Resource Details Page
Detail page navigation is not supported for all resource types. If detail page navigation is not supported, the resource name does not display as a link and the option is grayed out on the Actions menu.
To open the details page for a resource:
- Locate the resource in the list.
- Verify that you are in the same region as the resource. The resource's region is listed in the tenancy explorer results. If it is not the same as the region you are currently in (shown at the top of the Console), then select the appropriate region from the Regions menu.
-
To open the details page, you can either:
- Click the name.
- Click the the Actions icon (three dots) and select View Details.
Moving Resources to a Different Compartment
Not all resource-types can be moved to a different compartment. If the resource cannot be moved, the option is not selectable on the Actions menu. You must have the appropriate permissions for the resources you want to move in both the original and destination compartments.
Ensure that you understand the impact of moving a resource before you perform this action. See the resource's service documentation for details.
- Locate the resource in the list.
- Click the the Actions icon (three dots) and select Move Resource.
- In the dialog, choose the destination compartment from the list.
- Click Move Resource.
To move multiple resources, the resources must be in the same compartment.
- Locate and select the resources in the list.
- Click Move Selected.
- In the dialog, choose the destination compartment from the list.
- Click Move Resource.
The Work Request page launches to show you the status of the work request to move the resources.
Deleting Resources
Not all resource-types can be deleted using the tenancy explorer. If delete is not supported, the option is not selectable on the Actions menu.
Also, if a resource is in use by another resource, you can't delete it. For example, to delete a VCN, it must first be empty and have no related resources or attached gateways.
- Locate the resource in the list.
- Click the the Actions icon (three dots) and select Delete.
- In the confirmation dialog, click Delete.
- You are taken to the details page for the deleted resource.
To delete multiple resources, the resources must be in the same compartment.
- Locate and select the resources in the list.
- Click Delete Selected.
- In the confirmation dialog, click Delete.
The Work Request page launches to show you the status of the work request to move the resources.
Using the API
For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.
Use these API operations to move or delete multiple resources at once:
- ListBulkActionResourceTypes - use this API to help you provide the correct resource-type information to the BulkDeleteResources and BulkMoveResources operations. The returned list of resource-types provides the appropriate resource-type name to use as input and the required identifying information for each resource-type. Most resource-types only require the OCID to identity a specific resource, but some resources, such as buckets, require you to provide other identifying information.
- BulkDeleteResources
- BulkMoveResources