Promoting a local index to be the aggregator index for the account - 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 (PDF).

Promoting a local index to be the aggregator index for the account

You have the option to create an aggregator index in one Amazon Web Services Region when you first set up Amazon Resource Explorer. For more information, see Setting up and configuring Resource Explorer. This procedure is about promoting one of the local indexes to be the aggregator index for the account if you didn't do it at initial set up.

Important

  • You can have only one aggregator index in an Amazon Web Services account. If the account already has an aggregator index, you must first either demote it to a local index or delete it.

  • After deleting or changing which Region contains the aggregator index, you must wait 24 hours before you can promote another index to be the aggregator index.

Amazon Web Services Management Console
To promote a local index to be the aggregator index for the account

  1. Open the Resource Explorer Settings page.

  2. In the Indexes section, select the check box next to the index that you want to promote, and then choose Change index type.

  3. In the Change index type for <Region name> dialog, choose aggregator index, and then choose Save changes.

Amazon CLI
To promote a local index to be the aggregator index for the account

The following example command updates the index in the specified Amazon Web Services Region from type LOCAL to type AGGREGATOR. You must call the operation from the Amazon Web Services Region that you want to contain the aggregator index.

$ aws resource-explorer-2 update-index-type \
    --arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111 \
    --type AGGREGATOR \
    --region us-east-1
{
    "Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111",
    "LastUpdatedAt":"2022-07-13T18:41:58.799Z",
    "State":"UPDATING",
    "Type":"AGGREGATOR"
}

The operation works asynchronously and starts with State set to UPDATING. To check if the operation has completed, you can run the following command and look for the value ACTIVE in the State response field. You must run this command in the Region the contains the index you want to check.

$ aws resource-explorer-2 get-index --region us-east-1
{
    "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111",
    "CreatedAt": "2022-10-12T21:31:37.277000+00:00",
    "LastUpdatedAt": "2022-10-12T21:31:37.677000+00:00",
    "ReplicatingFrom": [
        "us-west-2",
        "us-east-2",
        "us-west-1"
    ],
    "State": "ACTIVE",
    "Tags": {},
    "Type": "AGGREGATOR"
}