Turning off Resource Explorer in an Amazon Web Services Region - 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.

Turning off Resource Explorer in an Amazon Web Services Region

When you no longer need to search for resources in a specific Amazon Web Services Region, you can turn off Amazon Resource Explorer in only that Region by deleting its index. When you do this, Resource Explorer stops scanning for new or updated resources in that Region. If your account contains an aggregator index, then replication from the deleted index stops, and the information from the deleted index is removed from the aggregator index and stops appearing in search results. It can take up to 24 hours for all resources from the deleted index to disappear from search results in the Region with the aggregator index.

Note

When you register the first Amazon Web Services Region, Resource Explorer creates a service linked role (SLR) named AWSServiceRoleForResourceExplorer in the Amazon Web Services account. Resource Explorer doesn't delete this SLR automatically. After you delete the Resource Explorer index in every Region in the account, you can use the IAM console to delete the SLR if you won't use Resource Explorer in the future. If you do delete the role and you then choose to turn on Resource Explorer again in at least one Amazon Web Services Region, Resource Explorer re-creates the service-linked role automatically.

You can turn off Resource Explorer in an Amazon Web Services Region by using the Amazon Web Services Management Console, by using commands in the Amazon Command Line Interface (Amazon CLI), or by using API operations in an Amazon SDK.

Amazon Web Services Management Console

If you no longer want to support searching for resources in one or more of the Amazon Web Services Regions in your account, perform the steps in the following procedure.

Note

If the index you delete is the aggregator index for the Amazon Web Services account, you must wait 24 hours before you can promote another local index to be the aggregator index for the account. Users can't perform account-wide searches using Resource Explorer until another aggregator index is configured.

To delete the Resource Explorer index in an Amazon Web Services Region

  1. Open the Resource Explorer Settings page.

  2. In the Indexes section, select the check boxes next to the Amazon Web Services Regions with the indexes that you want to delete, and then choose Delete.

  3. On the Delete indexes page, verify that you selected only indexes that you want to delete. Type delete in the Confirm text box, and then choose Delete indexes.

    Resource Explorer displays a green banner at the top of the page to indicate success, or a red banner if there is an error with one or more of the selected Regions.

Amazon CLI

To delete the Resource Explorer index in an Amazon Web Services Region

If you no longer want to support searching for resources in one or more of the Amazon Web Services Regions in your account, run the following commands.

Run the following command for each Region with the indexes that you want to delete. You must run the command in the Region with the index you want to delete. The following example command deletes the Resource Explorer index in the US West (Oregon) (us-west-2).

$ aws resource-explorer-2 delete-index \ --arn arn:aws:resource-explorer-2:us-west-2:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd22222222 \ --region us-west-2 { "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd22222222", "State": "DELETING" }

Because Resource Explorer performs some of the deletion cleanup work as asynchronous tasks in the background, the response might indicate that the operation is DELETING. This status indicates that the background processes are not yet complete. You can check for final completion by running the following command, and checking for the State to change to DELETED.

$ aws resource-explorer-2 get-index \ --region us-west-2 { "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111", "CreatedAt": "2022-07-12T18:59:10.503000+00:00", "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00", "ReplicatingFrom": [], "State": "DELETED", "Tags": {}, "Type": "LOCAL" }