As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Ativar a pesquisa inter-regional criando um índice agregador
Com a pesquisa entre regiões ativada, você pode pesquisar recursos em todas as regiões do seu Conta da AWS.
**Topics**
+ [Sobre o índice agregador](#manage-aggregator-region-about)
+ [Promover um índice local para ser o índice agregador da conta](manage-aggregator-region-turn-on.md)
+ [Rebaixar o índice agregador a um índice local](manage-aggregator-region-turn-off.md)
## Sobre o índice agregador
Explorador de recursos da AWS armazena as informações coletadas sobre os recursos em um Região da AWS *índice local* que o Resource Explorer cria e mantém nessa região. Por exemplo, suponha que você tenha uma EC2 instância da Amazon na região Oeste dos EUA (Oregon). O Explorador de Recursos armazena os detalhes sobre esse recurso no índice local na região Oeste dos EUA (Oregon).
Para apoiar a pesquisa de recursos Regiões da AWS em toda a sua conta, você pode converter o índice local em *uma* região para ser o índice agregador da sua conta.
O índice agregador contém uma cópia replicada do índice local em todas as outras regiões em que você ativou o Explorador de Recursos. Isso permite criar visualizações na região que contêm o índice agregador cujos resultados podem incluir recursos de todos Regiões da AWS na conta.
O diagrama a seguir mostra um exemplo de como o índice do agregador funciona. Neste exemplo de Conta da AWS, o administrador faz o seguinte:
+ Ativa o Resource Explorer em três Regiões da AWS (`us-east-1``us-west-2`, e`eu-west-1`) criando índices nessas regiões. Cada região contém seu próprio índice local.
+ Escolhe *não* criar um índice na região `sa-east-1`. Os usuários não podem fazer pesquisas na região `sa-east-1` e nenhum recurso dessa região aparece nos resultados de pesquisa.
+ Cria o índice agregador para a conta na região `us-west-2`. Isso faz com que o Explorador de Recursos replique no índice agregador as informações dos índices locais de todas as outras regiões em que o Explorador de Recursos está ativado. Isso permite que as pesquisas feitas na região `us-west-2` incluam recursos de todas as três regiões nas quais o Explorador de Recursos está ativado.
Essa configuração significa que um usuário ***só***pode fazer pesquisas inter-regionais na região `us-west-2`, que contém o índice agregador. Somente visualizações dessa região podem retornar resultados de todas as regiões na conta.
![\[O diagrama mostra que o Explorador de Recursos está ativado em três regiões, e uma região tem o índice agregador e a visualização padrão. Uma única região não está ativada.\]](http://docs.aws.amazon.com/pt_br/resource-explorer/latest/userguide/images/AREX-Overview.png)
| |
| --- |
| Legenda |
| ![\[Gear icon with magnifying glass, representing system configuration or search settings.\]](http://docs.aws.amazon.com/pt_br/resource-explorer/latest/userguide/images/AREX-Activated-Icon.png) | O Resource Explorer é ativado nessa Região da AWS opção e seus recursos são catalogados em um índice nessa região. O índice dessa região também é replicado (indicado pelas setas) para o Região da AWS que contém o índice agregador. |
| ![\[Notebook icon representing a document or file with lined pages.\]](http://docs.aws.amazon.com/pt_br/resource-explorer/latest/userguide/images/Global-Index-Icon.png) | Isso Região da AWS contém o índice agregador. O Resource Explorer replica as informações de recursos coletadas em todos os outros Regiões da AWS nesta região. |
| ![\[Blue square border with white interior, representing a placeholder for an image.\]](http://docs.aws.amazon.com/pt_br/resource-explorer/latest/userguide/images/Default-Search-Scope.png) | A visualização padrão criada pela Configuração rápida inclui todos os recursos em todas as Regiões da AWS. |
# Promover um índice local para ser o índice agregador da conta
Você tem a opção de criar um índice agregador em uma Região da AWS quando configura o Explorador de recursos da AWS pela primeira vez. Veja mais informações em [Instalar e configurar o Explorador de Recursos](getting-started-setting-up.md). Esse procedimento consiste em promover um dos índices locais para ser o índice agregador da conta, caso você não tenha feito isso na configuração inicial.
**Importante**
Você não pode ter mais de um índice agregador em uma Conta da AWS. Se a conta já tiver um índice agregador, você deverá primeiro [rebaixá-lo a um índice local](manage-aggregator-region-turn-off.md) ou excluí-lo.
Depois de excluir ou alterar a região que contém o índice agregador, você deve esperar 24 horas antes de poder promover outro índice para ser o índice agregador.
------
#### [ Console de gerenciamento da AWS ]
**Para promover um índice local para ser o índice agregador da conta**
1. Abra a página **[Configurações](https://console.aws.amazon.com/resource-explorer/home#/settings)** do Explorador de Recursos.
1. Na seção **Índices**, marque a caixa de seleção ao lado do índice que você deseja promover e escolha **Alterar tipo de índice**.
1. Na caixa de diálogo **Alterar tipo de índice para <*Nome da região*>**, escolha **Índice agregador** e depois **Salvar alterações**.
------
#### [ AWS CLI ]
**Para promover um índice local para ser o índice agregador da conta**
O exemplo de comando a seguir atualiza o índice na Região da AWS especificada do tipo `LOCAL` para o tipo `AGGREGATOR`. É necessário chamar a operação na Região da AWS que você deseja que contenha o índice agregador.
```
$ 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"
}
```
A operação funciona de forma assíncrona e começa com `State` definido como `UPDATING`. Para verificar se a operação foi concluída, você pode executar o comando a seguir e procurar o valor `ACTIVE` no campo `State` da resposta. Você deve executar esse comando na região que contém o índice que você deseja verificar.
```
$ 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"
}
```
------
# Rebaixar o índice agregador a um índice local
É possível rebaixar um índice agregador a um índice local, por exemplo, quando você quer transferir o índice agregador para outra Região da AWS.
Quando você rebaixa um índice agregador a um índice local, o Explorador de Recursos deixa de replicar os índices de outras Regiões da AWS. Ele também inicia uma tarefa assíncrona em segundo plano para excluir qualquer informação replicada das outras regiões. Até que a tarefa assíncrona seja concluída, alguns resultados inter-regionais podem continuar aparecendo nos resultados de pesquisa.
**Observações**
Depois de rebaixar um índice agregador, você deve esperar 24 horas antes de poder promover o mesmo índice ou o índice de uma outra região para ser o novo índice agregador da conta.
Depois de rebaixar um índice agregador, pode levar até 36 horas para que os processos em segundo plano sejam concluídos e todas as informações de recursos de outras regiões desapareçam dos resultados das pesquisas realizadas nessa região.
Se você rebaixar uma conta-membro em uma visão ampla da organização, a conta-membro poderá ser removida da pesquisa de várias contas.
Você pode verificar o status da tarefa em segundo plano visualizando a lista de índices na página **[Configurações](https://console.aws.amazon.com/resource-explorer/home#/settings)** ou usando a [GetIndex](https://docs.aws.amazon.com/resource-explorer/latest/apireference/API_GetIndex.html)operação. Quando as tarefas assíncronas são concluídas, o campo `Status` do índice muda de `UPDATING` para `ACTIVE`. Nesse momento, somente os resultados da região local aparecem nos resultados das consultas.
------
#### [ Console de gerenciamento da AWS ]
**Para rebaixar o índice agregador a um índice local**
1. Abra a página **[Configurações](https://console.aws.amazon.com/resource-explorer/home#/settings)** do Explorador de Recursos.
1. Na seção **Índices**, marque a caixa de seleção ao lado da região que contém o índice agregador que você deseja rebaixar a um índice local e escolha **Alterar tipo de índice**.
1. Na caixa de diálogo **Alterar tipo de índice para <*Nome da região*>**, escolha **Índice local** e depois **Salvar alterações**.
------
#### [ AWS CLI ]
**Para rebaixar o índice agregador a um índice local**
O exemplo a seguir rebaixa o índice agregador especificado a um índice local. Você deve chamar a operação na Região da AWS que contém o índice agregador no momento.
```
$ aws resource-explorer-2 update-index-type \
--arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111 \
--type LOCAL \
--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":"LOCAL"
}
```
A operação funciona de forma assíncrona e começa com `State` definido como `UPDATING`. Para verificar se a operação foi concluída, você pode executar o comando a seguir e procurar o valor `ACTIVE` no campo `State` da resposta. Você deve executar esse comando na região que contém o índice que você deseja verificar.
```
$ 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": "LOCAL"
}
```
------