What is Amazon Resource Explorer? - Amazon Resource Explorer
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

What is Amazon Resource Explorer?

Amazon Resource Explorer is a resource search and discovery service. With Resource Explorer, you can explore your resources, such as Amazon Elastic Compute Cloud instances, Amazon Kinesis streams, or Amazon DynamoDB tables, using an internet search engine-like experience. You can search for your resources using resource metadata like names, tags, and IDs. Resource Explorer works across Amazon Web Services Regions in your account to simplify your cross-Region workloads.

Resource Explorer provides fast responses to your search queries by using indexes that are created and maintained by the Amazon Resource Explorer service. Resource Explorer uses a variety of data sources to gather information about resources in your Amazon Web Services account. Resource Explorer stores that information in the indexes for Resource Explorer to search.

We want your feedback about this documentation

Our goal is to help you get everything you can from Resource Explorer. If this guide helps you to do that, then let us know. If the guide isn't helping you, then we want to hear from you so we can address the issue. Use the Feedback link that's in the upper-right corner of every page. That sends your comments directly to the writers of this guide. We review every submission, looking for opportunities to improve the documentation. Thank you in advance for your help!

Are you a first-time Resource Explorer user?

If you're a first-time user of Resource Explorer, we recommend that you begin by reading the following topics in the Getting started section:

Features of Resource Explorer

Resource Explorer provides the following features:

  • Users can search for resources in their Amazon Web Services Region or across Regions in their Amazon Web Services account.

  • Users can use keywords, search operators, and attributes like tags to filter the search results to only matching resources.

  • When users find a resource in the search results, they can immediately go to the resource's native console to work with that resource.

  • Administrators can create views that define which resources are available in search results. Administrators can create different views for different groups of users based on their tasks, and grant permissions to views to only those users who need them.

  • Resource Explorer, like many other Amazon Web Services, is eventually consistent. Resource Explorer achieves high availability by replicating data across multiple servers within Amazon data centers around the world. If a request to change some data is successful, the change is committed and safely stored. However, then the change must be replicated across Resource Explorer, which can take some time. As an example, this includes Resource Explorer finding a resource in one Region, and replicating that to the Region that contains the aggregator index for the account.

The following are the other Amazon Web Services whose primary purpose is to help you manage your Amazon resources:

Amazon Resource Access Manager (Amazon RAM)

Share the resources in one Amazon Web Services account with other Amazon Web Services accounts. If your account is managed by Amazon Organizations, you can use Amazon RAM to share resources with the accounts in an organizational unit, or all of the accounts in the organization. The shared resources work for users in those accounts just like they would if they were created in the local account.

Amazon Resource Groups

Create groups for your Amazon resources. Then, you can use and manage each group as a unit instead of having to reference every resource individually. Your groups can consist of resources that are part of the same Amazon CloudFormation stack, or that are tagged with the same tags. Some resource types also support applying a configuration to a resource group to affect all relevant resources in that group.

Tag editor and the Amazon Resource Groups Tagging API

Tags are customer-defined metadata that you can attach to your resources. You can categorize your resources for purposes like cost allocation and attribute-based access control.

Accessing Resource Explorer

You can interact with Resource Explorer in the following ways:

Resource Explorer console

Resource Explorer provides a web-based user interface, the Resource Explorer console. If you signed up for an Amazon Web Services account, you can access the Resource Explorer console by signing into the Amazon Web Services Management Console and choosing Resource Explorer from the console home page.

You can also navigate in your browser directly to the Resource Explorer dashboard page, or to the Resource search page. If you aren't already signed in, then you're asked to do so before the console appears.

Note

The Resource Explorer console is a global console, meaning that you don't have to select an Amazon Web Services Region to work in. However, when you use Resource Explorer to create an index or a view, you need to specify which Region the index or view is stored in. When you use Resource Explorer to search, you can choose any view you have access to. The results automatically come from the Region associated with the selected view. If the view is from the Region that contains the aggregator index, the results include resources from all Regions where you created Resource Explorer indexes.

Amazon Web Services Management Console unified search

At the top of every page in the Amazon Web Services Management Console, there is a search bar. You can configure Resource Explorer to participate in unified search. Then, your users can use Resource Explorer search query syntax in the unified search text box, and see matching resources in those search results. By turning this feature on, users can search for resources from the console of any Amazon Web Service without having to first switch to the Resource Explorer console.

Important

Unified search always searches using the default view in the Amazon Web Services Region that contains the aggregator index.

Resource Explorer commands in the Amazon CLI and Tools for Windows PowerShell

The Amazon CLI and Tools for PowerShell provide direct access to the Resource Explorer public API operations. These tools work on Windows, macOS, and Linux. For more information about getting started, see the Amazon Command Line Interface User Guide, or the Amazon Tools for Windows PowerShell User Guide. For more information about the commands for Resource Explorer, see the Amazon CLI Command Reference or the Amazon Tools for Windows PowerShell Cmdlet Reference.

Resource Explorer operations in the Amazon SDKs

Amazon provides API commands for a broad set of programming languages. For more information about getting started, see Using Amazon Resource Explorer with an Amazon SDK.

Query API

If you don't use one of the supported programming languages, the Resource Explorer HTTPS Query API gives you programmatic access to Resource Explorer. With the Resource Explorer API, you can issue HTTPS requests directly to the service. When you use the Resource Explorer API, you must include code that can digitally sign your requests using your Amazon credentials. For more information, see the Amazon Resource Explorer API Reference.

Pricing

There are no charges to search for resources by using Amazon Resource Explorer, including creating views or searching for resources. However, interacting with the resources that you find in your search results can result in usage charges that vary depending on the resource type and its Amazon Web Service. For more information about how Amazon bills for the use of a specific resource type, refer to the documentation for that resource type's owning service.