Ativando o Resource Explorer em um Região da AWS para indexar seus recursos - Explorador de recursos da AWS
Criar um índice do Explorador de Recursos em uma região

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á.

Ativando o Resource Explorer em um Região da AWS para indexar seus recursos

Ao ativar Explorador de recursos da AWS inicialmente o seu Conta da AWS, você criou índices para o serviço em um ou mais Regiões da AWS. Se você usou a opção Configuração rápida, o Explorador de Recursos criou os índices automaticamente em todas as Regiões da AWS que estão ativadas na sua Conta da AWS. O serviço Explorador de Recursos também promoveu o índice na região especificada para ser o índice agregador da conta. Se usou a opção Configuração avançada, você especificou as regiões nas quais criar os índices.

Tópicos

Quando você ativa o Resource Explorer em um Região da AWS, o serviço executa as seguintes ações:

  • Quando você inicia o Resource Explorer na primeira região de um Conta da AWS, o Resource Explorer cria uma função vinculada ao serviço na conta chamada. AWSServiceRoleForResourceExplorer Esse perfil concede permissões para o Explorador de Recursos descobrir e indexar os recursos na sua conta usando serviços como o AWS CloudTrail e o serviço de marcação. A criação da função vinculada ao serviço acontece somente quando você registra a primeira Região da AWS na conta. O Explorador de Recursos usa o mesmo perfil vinculado ao serviço para todas as regiões adicionadas posteriormente.

  • O Explorador de Recursos cria um índice na região especificada para armazenar os detalhes dos recursos dessa região.

  • O Explorador de Recursos começa a descobrir os recursos na região especificada e adiciona as informações encontradas sobre eles ao índice dessa região.

  • Se sua conta já contiver um índice agregador em outra região, o Explorador de Recursos começará a replicar as informações do índice da nova região no índice agregador para possibilitar a pesquisa inter-regiões.

Quando essas etapas são concluídas, as informações sobre os recursos ficam disponíveis para serem descobertas pelos usuários. Eles podem pesquisar usando uma das visualizações definidas na mesma região ou na região que contém o índice agregador.

Criar um índice do Explorador de Recursos em uma região

Você pode criar um índice do Resource Explorer em um adicional Região da AWS usando o AWS Management Console, usando comandos no AWS Command Line Interface (AWS CLI) ou usando API operações em um AWS SDK. Você não pode criar mais de um índice em uma região.

Permissões mínimas

Para realizar as etapas do procedimento a seguir, você deve ter as seguintes permissões:

  • Ação: resource-explorer-2:* - Recurso: nenhum recurso específico (*)

  • Ação: iam:CreateServiceLinkedRole - Recurso: nenhum recurso específico (*)

AWS Management Console
Para criar um índice do Resource Explorer em um Região da AWS

  1. Na página Configurações do Explorador de Recursos.

  2. Na seção Índices, escolha Criar índices.

  3. Na página Criar índices, marque as caixas de seleção ao lado das Regiões da AWS quais você deseja criar um índice para apoiar a pesquisa dos recursos dessa região. Caixas de seleção indisponíveis indicam regiões que já contêm um índice do Explorador de Recursos.

  4. (Opcional) Na seção Tags, você pode especificar pares de chave e valor de tag para o índice.

  5. Escolha Criar índice.

    O Explorador de Recursos exibe um banner verde na parte superior da página para indicar sucesso ou um banner vermelho se ocorrer um erro ao criar um índice em uma ou mais das regiões selecionadas.

    nota

    Os recursos marcados locais para o índice aparecem nos resultados de pesquisa em poucos minutos. Os recursos não marcados normalmente levam menos de duas horas para aparecer, mas podem levar mais tempo quando há muita demanda. A replicação inicial de todos os índices locais existentes em um novo índice agregador também pode levar até uma hora.

Próxima etapa: se você já criou um índice agregador, as novas regiões começarão automaticamente a replicar suas informações de índice no índice agregador. Se os usuários fizerem ali todas as pesquisas, os recursos na nova região aparecerão nesses resultados de pesquisa e pronto.

Porém, se quiser que os usuários possam pesquisar recursos apenas na região recém-indexada, você deverá criar também uma visualização para os usuários nessa região e conceder a eles permissões para essa visualização. Para obter instruções sobre como criar uma visualização, consulte Gerenciar visualizações do Explorador de Recursos para fornecer acesso para pesquisa.

AWS CLI
Para criar um índice do Resource Explorer em um Região da AWS

Execute o comando a seguir para cada um Região da AWS em que você deseja criar um índice para apoiar a pesquisa dos recursos dessa região. O exemplo de comando a seguir registra o Explorador de Recursos na região Leste dos EUA (Norte da Virgínia) (us-east-1).

$ aws resource-explorer-2 create-index \
    --region us-east-1
{
    "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111",
    "CreatedAt": "2022-11-01T20:00:59.149Z",
    "State": "CREATING"
}

Repita esse comando para cada região na qual você deseja ativar o Explorador de Recursos, substituindo o parâmetro --region pelo código de região apropriado.

Como o Explorador de Recursos executa parte da criação do índice como tarefas assíncronas em segundo plano, a resposta pode ser CREATING, o que indica que os processos em segundo plano ainda não foram concluídos.

nota

Os recursos marcados locais para o índice aparecem nos resultados de pesquisa em poucos minutos. Os recursos não marcados normalmente levam menos de duas horas para aparecer, mas podem levar mais tempo quando há muita demanda. A replicação inicial de todos os índices locais existentes em um novo índice agregador também pode levar até uma hora.

Você pode verificar a conclusão final executando o comando a seguir e verificando se o status é ACTIVE.

$ 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-07-12T18:59:10.503000+00:00",
    "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00",
    "ReplicatingFrom": [],
    "State": "ACTIVE",
    "Tags": {},
    "Type": "LOCAL"
}

Próxima etapa: se você já criou um índice agregador, as novas regiões começarão automaticamente a replicar suas informações de índice no índice agregador. Se os usuários fizerem ali todas as pesquisas, os recursos na nova região aparecerão nesses resultados de pesquisa e pronto.

Porém, se quiser que os usuários possam pesquisar recursos apenas na região recém-indexada, você deverá criar também uma visualização para os usuários nessa região e conceder a eles permissões para essa visualização. Para obter instruções sobre como criar uma visualização, consulte Gerenciar visualizações do Explorador de Recursos para fornecer acesso para pesquisa.