# Promoting a local index to be the aggregator index for the account
<a name="manage-aggregator-region-turn-on"></a>

For cross-region search functionality, Resource Explorer provides a streamlined banner workflow that allows you to enable cross-region search with a single click. If you see a **Complete setup and enable cross-Region search** banner, you can choose **Enable cross-Region search in all Regions** for automatic setup or **Customize Region setup** for granular control. Alternatively, you have the option to manually create an aggregator index in one Amazon Web Services Region by promoting an existing user-owned (local) index from the **Settings** page . This procedure describes the manual process for promoting a user-owned (local) index to be the aggregator index for the account.

**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](manage-aggregator-region-turn-off.md) 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 user-owned (local) index to be the aggregator index for the account**

1. **Primary method - Banner workflow:** If you see a **Complete setup and enable cross-Region search** banner or banner notification, you can use the guided workflow:

   1. For automatic setup across all regions, choose **Enable cross-Region search in all Regions**, or

   1. For customized configuration, choose **Customize Region setup** to access granular setup options.

1. **Alternative method:** The **Settings** page.

   1. Open the Resource Explorer **[Settings](https://console.amazonaws.cn/resource-explorer/home#/settings)** page.

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

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

------
#### [ Amazon CLI ]

**To promote a user-owned (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. For information about the banner workflow option, see the Console tab above.

```
$ 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"
}
```

------