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.

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 IAM Policies Overview. 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  and select Governance & Administration. Under Tenancy Management, select 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 menu (Actions Menu) 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.

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.

Using the API

For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

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