

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

# Criar recursos do Explorador de Recursos com o CloudFormation
Trabalhar com o CloudFormation

O Explorador de recursos da AWS é integrado com o AWS CloudFormation, um serviço que ajuda você a modelar e configurar os recursos da AWS. Essa integração ajuda você a dispender menos tempo criando e gerenciando os recursos e a infraestrutura. Você cria um modelo que descreve todos os recursos da AWS que deseja, e o CloudFormation os provisiona e configura para você. Exemplos de recursos incluem índices, visualizações ou a atribuição de uma visualização padrão para uma Região da AWS.

Quando você usa o CloudFormation, pode reutilizar o modelo para configurar os recursos do Explorador de Recursos repetidas vezes e de modo consistente. Basta descrever os recursos uma vez e depois provisionar os mesmos recursos várias vezes em várias Contas da AWS e regiões. 

**Usar o CloudFormation para implantar o Explorador de Recursos no AWS Organizations**  
Você pode usar os StackSets do CloudFormation para implantar o Explorador de Recursos em todas as contas da sua organização. Quando você adiciona ou cria contas-membros na sua organização, os StackSets pode configurar automaticamente índices em cada Região da AWS, incluindo um índice agregador onde você especificar, para cada nova conta-membro. Para obter instruções, consulte [Implantar o Explorador de Recursos nas contas de uma organização](manage-service-all-org-with-stacksets.md).

## Modelos do Explorador de Recursos e do CloudFormation


Para provisionar e configurar recursos para o Explorador de Recursos e serviços relacionados, você precisa entender os [modelos do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html). Os modelos são arquivos de texto formatados em JSON ou YAML. Esses modelos descrevem os recursos que você deseja provisionar nas pilhas do CloudFormation. Se você não estiver familiarizado com JSON ou YAML, poderá usar o CloudFormation Designer para ajudá-lo a começar a usar os modelos do CloudFormation. Para obter mais informações, consulte [O que é o Designer?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/working-with-templates-cfn-designer.html) (O que é o CloudFormation Designer) no *Manual do usuário do AWS CloudFormation*.

O Explorador de Recursos é compatível com a criação dos seguintes tipos de recursos no CloudFormation:
+ **[Índice](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourceexplorer2-index.html)**: cria um índice em uma região e ativa o Explorador de Recursos nessa região. Você pode especificar que o índice seja um índice local ou o índice agregador da Conta da AWS. Para obter mais informações, consulte [Ativando o Resource Explorer em um Região da AWS para indexar seus recursos](manage-service-turn-on-region.md) e [Ativar a pesquisa inter-regional criando um índice agregador](manage-aggregator-region.md). 
+ **[Visualização](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourceexplorer2-view.html)**: cria uma visualização que determina quais resultados podem ser exibidos quando um usuário faz uma pesquisa. Cada operação de pesquisa deve especificar uma visualização. É necessário conceder aos usuários permissão para usar as visualizações que você deseja que eles acessem. Veja mais informações em [Gerenciar visualizações do Explorador de Recursos para fornecer acesso para pesquisa](manage-views.md).
**nota**  
Você deve criar um índice em uma região antes de criar uma visualização nessa mesma região. Se você criar um índice e uma visualização como parte da mesma pilha, use o atributo `DependsOn` na visualização, conforme mostrado no exemplo de modelo a seguir, para garantir que o índice seja criado primeiro.
+ **[DefaultViewAssociation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-resourceexplorer2-defaultviewassociation.html)**: designa a visualização especificada para ser o padrão em sua região. Quando um usuário não especifica explicitamente a visualização ser usada em uma operação de pesquisa, o Explorador de Recursos tenta usar a visualização padrão associada à região em que o usuário faz a pesquisa. Para obter mais informações, consulte [Definir uma visualização padrão em uma Região da AWS](manage-views-set-default.md).

O exemplo a seguir ilustra como você pode criar um índice e uma visualização na mesma região e definir a visualização como padrão para a região.

**YAML**

```
Description: >-
  Sample CFN Stack setting up Resource Explorer with an aggregator index and a default view 
Resources:
  SampleIndex:
    Type: 'AWS::ResourceExplorer2::Index'
    Properties:
      Type: AGGREGATOR
      Tags:
        Purpose: ResourceExplorer Sample CFN Stack
  SampleView:
    Type: 'AWS::ResourceExplorer2::View'
    Properties:
      ViewName: mySampleView
      IncludedProperties:
        - Name: tags
      Tags:
        Purpose: ResourceExplorer Sample CFN Stack
    DependsOn: SampleIndex
  SampleDefaultViewAssociation:
    Type: 'AWS::ResourceExplorer2::DefaultViewAssociation'
    Properties:
      ViewArn: !Ref SampleView
```

**JSON**

```
{
    "Description": "Sample CFN Stack setting up Resource Explorer with an aggregator index and a default view ",
    "Resources": {
        "SampleIndex": {
            "Type": "AWS::ResourceExplorer2::Index",
            "Properties": {
                "Type": "AGGREGATOR",
                "Tags": {
                    "Purpose": "ResourceExplorer Sample Stack"
                }
            }
        },
        "SampleView": {
            "Type": "AWS::ResourceExplorer2::View",
            "Properties": {
                "ViewName": "mySampleView",
                "IncludedProperties": [
                    {
                        "Name": "tags"
                    }
                ],
                "Tags": {
                    "Purpose": "ResourceExplorer Sample CFN Stack"
                }
            },
            "DependsOn": "SampleIndex"
        },
        "SampleDefaultViewAssociation": {
            "Type": "AWS::ResourceExplorer2::DefaultViewAssociation",
            "Properties": {
                "ViewArn": {
                    "Ref": "SampleView"
                }
            }
        }
    }
}
```

Para obter mais informações, incluindo exemplos de modelos JSON e YAML para índices e visualizações do Explorador de Recursos, consulte a [ResourceExplorer2 resource type reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_ResourceExplorer2.html) no *AWS CloudFormation User Guide*.

## Saiba mais sobre o CloudFormation


Para saber mais sobre o CloudFormation, consulte os seguintes recursos:
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+ [Manual do usuário do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
+ [Guia do usuário da interface de linha de comando do AWS CloudFormation](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html)