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:

Features of the tenancy explorer

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.

Supported resources
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 sourceType attribute are not supported.

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

See DetectorRecipe Reference.

Cloud Guard cloudguardmanagedlist

See ManagedList Reference.

Cloud Guard cloudguardresponderrecipe

See ResponderRecipe Reference.

Cloud Guard cloudguardtarget

See Target Reference.

Compute autoscalingconfiguration

See AutoScalingConfiguration Reference.

Note: Queries for the policies attribute are not supported.

Compute clusternetwork

See ClusterNetwork Reference.

Note: Queries for the primarySubnetId, secondaryVnicSubnets, and timeUpdated attributes are not supported.

Compute consolehistory See ConsoleHistory Reference.
Compute dedicatedvmhost

See DedicatedVmHost Reference.

Compute image See Image Reference.
Compute instance

See Instance Reference.

Note: Queries for the privateIp or publicIp attribute of a vnic will include the related instance, if one exists, and is running, in the query results.

Compute instanceconfiguration See InstanceConfiguration Reference.
Compute instancepool

See InstancePool Reference.

Note: Queries for the primarySubnetId, faultDomains, secondaryVnicSubnets, and loadBalancers attributes are not supported.

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 privateIp or publicIp attribute of a vnic will include the related instance, if one exists and is running, in the query results.

NoSQL Database Cloud table See Table Reference.
Notifications onssubscription

See Subscription Reference.

Note: Queries for the endpoint attribute are not supported.

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:

  1. Locate the resource in the list.
  2. 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.
  3. 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.

Important

Ensure that you understand the impact of moving a resource before you perform this action. See the resource's service documentation for details.
To move a single resource to a different compartment
  1. Locate the resource in the list.
  2. Click the the Actions icon (three dots) and select Move Resource.
  3. In the dialog, choose the destination compartment from the list.
  4. Click Move Resource.
To move multiple resources to a different compartment

To move multiple resources, the resources must be in the same compartment.

  1. Locate and select the resources in the list.
  2. Click Move Selected.
  3. In the dialog, choose the destination compartment from the list.
  4. 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.

To delete a single resource
  1. Locate the resource in the list.
  2. Click the the Actions icon (three dots) and select Delete.
  3. In the confirmation dialog, click Delete.
  4. You are taken to the details page for the deleted resource.
To delete multiple resources

To delete multiple resources, the resources must be in the same compartment.

  1. Locate and select the resources in the list.
  2. Click Delete Selected.
  3. 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