Viewing All Resources in a Compartment

This topic describes how you can use the compartment explorer to get a cross-region view of all resources in a compartment.

Compartment Explorer Highlights

  • The compartment 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 compartment explorer. You can delete or move a single or multiple resources at a time. The compartment 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 compartment explorer

When using the compartment explorer, be aware of the following:

  • If you recently created a resource, it might not show up in the compartment 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 compartment 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

Compartment 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 Compartment Explorer

The compartment 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.
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.
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.

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.

Data Catalog datacatalog See Catalog Reference.
Data Flow application See Application Reference.
Data Flow run See Run Reference.
Data Integration workspace 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.
Data Science datasciencenotebooksession See NotebookSession Reference.
Data Science datasciencemodel See Model Reference.
Data Transfer datatransferappliance See DataTransferAppliance.
Data Transfer datatransferdevice See DataTransferDevice.
Data Transfer datatransferjob See DataTransferJob.
Data Transfer datatransferpackage See DataTransferPackage.
Database autonomouscontainerdatabase See AutonomousContainerDatabase Reference.
Database autonomousdatabase See AutonomousDatabase Reference.
Database autonomousexadatainfrastructure See AutonomousExadataInfrastructure Reference.
Database backupdestination See BackupDestination Reference.
Database database See Database Reference.
Database dbhome See DbHome Reference.
Database dbsystem See DbSystem Reference.
Database exadatainfrastructure See ExadataInfrastructure 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.
Monitoring alarm See Search-Supported Attributes for Alarms.
MySQL Database dbsystem See DBSystem Reference.
Networking cpe See Cpe Reference.
Networking crossconnect See CrossConnect Reference.
Networking crossconnectgroup See CrossConnectGroup Reference.
Networking ipsecconnection See IPSecConnection Reference.
Networking ipv6 See IPv6 Reference.
Networking natgateway See NatGateway 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 virtualcircuit See VirtualCircuit Reference.
Networking vcn See Vcn 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.
Resource Manager ormjob See Job Reference.
Resource Manager ormstack See Stack 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.
WAF waascertificate See WaasCertificate Reference.
WAF waaspolicy See WaasPolicy Reference.

Required IAM Policy to Work with Resources in the Compartment Explorer

The resources that you see in the compartment 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 compartment 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 Compartment Explorer and Viewing Resources

Open the navigation menu. Under Governance and Administration, go to Governance and click Compartment Explorer.

The compartment 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 compartment 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 compartment 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