# Exemplos do Explorador de Recursos usando a AWS CLI
<a name="cli_resource-explorer-2_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Explorador de Recursos.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `associate-default-view`
<a name="resource-explorer-2_AssociateDefaultView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `associate-default-view`.

**AWS CLI**  
**Para definir uma visualização do Explorador de Recursos como padrão para a região da AWS**  
O exemplo `associate-default-view` a seguir define uma visualização, conforme especificado por seu ARN, como a visualização padrão para a região da AWS na qual você chama a operação.  

```
aws resource-explorer-2 associate-default-view \
    --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
```
Resultado:  

```
{
    "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
}
```
Para obter mais informações, consulte [Configurando uma exibição padrão em uma região da AWS](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) no *Guia do usuário do AWS Resource Explorer*.  
+  Para ver detalhes da API, consulte [AssociateDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/associate-default-view.html) na *Referência de comandos da AWS CLI*. 

### `batch-get-view`
<a name="resource-explorer-2_BatchGetView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `batch-get-view`.

**AWS CLI**  
**Para recuperar detalhes sobre várias visualizações do Explorador de Recursos**  
O exemplo `batch-get-view` a seguir exibe os detalhes sobre duas visualizações especificadas por seus ARNs. Use espaços para separar os vários ARNs no parâmetro --view-arn.  

```
aws resource-explorer-2 batch-get-view \
    --view-arns arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222, \
                arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
```
Resultado:  

```
{
    "Views": [
        {
            "Filters": {
                "FilterString": "service:ec2"
            },
            "IncludedProperties": [
                {
                    "Name": "tags"
                }
            ],
            "LastUpdatedAt": "2022-07-13T21:33:45.249000+00:00",
            "Owner": "123456789012",
            "Scope": "arn:aws:iam::123456789012:root",
            "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222"
        },
        {
            "Filters": {
                "FilterString": ""
            },
            "IncludedProperties": [
                {
                    "Name": "tags"
                }
            ],
            "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00",
            "Owner": "123456789012",
            "Scope": "arn:aws:iam::123456789012:root",
            "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
        }
    ]
    "Errors": []
}
```
Para obter mais informações sobre exibições, consulte [Sobre as exibições do Explorador de Recursos](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) no *Guia do Usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [BatchGetView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/batch-get-view.html) na *Referência de comandos da AWS CLI*. 

### `create-index`
<a name="resource-explorer-2_CreateIndex_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-index`.

**AWS CLI**  
**Ativar o Explorador de Recursos em uma região da AWS criando um índice**  
O exemplo `create-index` a seguir cria um índice local na Região da AWS em que a operação é chamada. A AWS CLI gera automaticamente um valor de parâmetro `client-token` aleatório e o inclui na chamada à AWS caso você não especifique um valor.  

```
aws resource-explorer-2 create-index \
    --region us-east-1
```
Resultado:  

```
{
    "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222c",
    "CreatedAt": "2022-11-01T20:00:59.149Z",
    "State": "CREATING"
}
```
Depois de criar um índice local, você pode convertê-lo no índice agregador da conta executando o comando [update-index-type](https://docs.aws.amazon.com/cli/latest/reference/resource-explorer-2/update-index-type.html).  
Para obter mais informações, consulte [Como ativar o Explorador de Recursos em uma Região da AWS para indexar seus recursos](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-register.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [CreateIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-index.html) na *Referência de comandos da AWS CLI*. 

### `create-view`
<a name="resource-explorer-2_CreateView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-view`.

**AWS CLI**  
**Exemplo 1: criar uma exibição não filtrada para o índice em uma Região da AWS**  
O exemplo `create-view` a seguir cria uma visão na Região da AWS especificada, que retorna todos os resultados na região sem qualquer filtragem. A visão inclui o campo opcional Tags nos resultados retornados. Como essa visualização é criada na Região que contém o índice agregador, ela pode incluir resultados de todas as Regiões da conta que contêm um índice do Explorador de Recursos.  

```
aws resource-explorer-2 create-view \
    --view-name My-Main-View \
    --included-properties Name=tags \
    --region us-east-1
```
Resultado:  

```
{
    "View": {
        "Filters": {
            "FilterString": ""
        },
        "IncludedProperties": [
            {
                "Name": "tags"
            }
        ],
        "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00",
        "Owner": "123456789012",
        "Scope": "arn:aws:iam::123456789012:root",
        "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
    }
}
```
**Exemplo 2: criar uma visão que retorne somente recursos associados ao Amazon EC2**  
O seguinte `create-view` cria uma visão na região `us-east-1` da AWS, que retorna somente os recursos na região que estão associados ao serviço Amazon EC2. A visão inclui o campo opcional `Tags` nos resultados retornados. Como essa visualização é criada na Região que contém o índice agregador, ela pode incluir resultados de todas as Regiões da conta que contêm um índice do Explorador de Recursos.  

```
aws resource-explorer-2 create-view \
    --view-name My-EC2-Only-View \
    --included-properties Name=tags \
    --filters FilterString="service:ec2" \
    --region us-east-1
```
Resultado:  

```
{
    "View": {
        "Filters": {
            "FilterString": "service:ec2"
        },
        "IncludedProperties": [
            {
                "Name":"tags"
            }
        ],
        "LastUpdatedAt": "2022-07-13T21:35:09.059Z",
        "Owner": "123456789012",
        "Scope": "arn:aws:iam::123456789012:root",
        "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222"
    }
}
```
Para obter mais informações, consulte [Criar visões para pesquisa](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-create.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [CreateView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-view.html) na *Referência de comandos da AWS CLI*. 

### `delete-index`
<a name="resource-explorer-2_DeleteIndex_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-index`.

**AWS CLI**  
**Para desativar o Explorador de Recursos em uma Região da AWS excluindo seu índice**  
O exemplo `delete-index` a seguir exclui o índice especificado do Explorador de Recursos na Região da AWS em que você faz a solicitação.  

```
aws resource-explorer-2 delete-index \
    --arn arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222 \
    --region us-west-2
```
Resultado:  

```
{
    "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222",
    "State": "DELETING"
}
```
Para obter mais informações sobre como excluir um índice, consulte [Desativar o Explorador de Recursos da AWS em uma Região da AWS](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-deregister.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [DeleteIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-index.html) na *Referência de comandos da AWS CLI*. 

### `delete-view`
<a name="resource-explorer-2_DeleteView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-view`.

**AWS CLI**  
**Para excluir uma visualização do Explorador de Recursos**  
O exemplo `delete-view` a seguir exclui uma visão especificada por seu ARN.  

```
aws resource-explorer-2 delete-view \
    --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
```
Resultado:  

```
{
    "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
}
```
Para obter mais informações, consulte [Excluir visualizações](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-delete.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [DeleteView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-view.html) na *Referência de comandos da AWS CLI*. 

### `disassociate-default-view`
<a name="resource-explorer-2_DisassociateDefaultView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `disassociate-default-view`.

**AWS CLI**  
**Para remover a visualização padrão do Explorador de Recursos de uma Região da AWS**  
O `disassociate-default-view` a seguir remove a visualização padrão do Explorador de Recursos para a Região da AWS na qual você chama a operação. Depois de realizar essa operação, todas as operações de pesquisa na Região devem especificar explicitamente uma visão ou a operação falhará.  

```
aws resource-explorer-2 disassociate-default-view
```
Este comando não produz saída.  
Para obter mais informações, consulte [Configurando uma exibição padrão em uma região da AWS](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) no *Guia do usuário do AWS Resource Explorer*.  
+  Para ver detalhes da API, consulte [DisassociateDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/disassociate-default-view.html) na *Referência de comandos da AWS CLI*. 

### `get-default-view`
<a name="resource-explorer-2_GetDefaultView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-default-view`.

**AWS CLI**  
**Para recuperar a visão do Explorador de Recursos que é a visão padrão para a sua Região da AWS**  
O exemplo `get-default-view` a seguir recupera o ARN da visão que é o padrão para a Região da AWS na qual você chama a operação.  

```
aws resource-explorer-2 get-default-view
```
Resultado:  

```
{
    "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
}
```
Para obter mais informações, consulte [Configurando uma exibição padrão em uma região da AWS](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) no *Guia do usuário do AWS Resource Explorer*.  
+  Para ver detalhes da API, consulte [GetDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-default-view.html) na *Referência de comandos da AWS CLI*. 

### `get-index`
<a name="resource-explorer-2_GetIndex_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-index`.

**AWS CLI**  
**Exemplo 1: recuperar os detalhes de um índice agregador do Explorador de Recursos**  
O exemplo `get-index` a seguir exibe os detalhes do índice do Explorador de Recursos na Região da AWS especificada. Como a Região especificada contém o índice agregador da conta, a saída lista as Regiões que replicam dados no índice dessa Região.  

```
aws resource-explorer-2 get-index \
    --region us-east-1
```
Resultado:  

```
{
    "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111",
    "CreatedAt": "2022-07-12T18:59:10.503000+00:00",
    "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00",
    "ReplicatingFrom": [
        "ap-south-1",
        "us-west-2"
    ],
    "State": "ACTIVE",
    "Tags": {},
    "Type": "AGGREGATOR"
}
```
**Exemplo 2: recuperar os detalhes de um índice local do Explorador de Recursos**  
O exemplo `get-index` a seguir exibe os detalhes do índice do Explorador de Recursos na Região da AWS especificada. Como a Região especificada contém um índice local, a saída lista a Região para a qual ela replica os dados do índice dessa Região.  

```
aws resource-explorer-2 get-index \
    --region us-west-2
```
Resultado:  

```
{
    "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222",
    "CreatedAt": "2022-07-12T18:59:10.503000+00:00",
    "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00",
    "ReplicatingTo": [
        "us-west-2"
    ],
    "State": "ACTIVE",
    "Tags": {},
    "Type": "LOCAL"
}
```
Para obter mais informações sobre índices, consulte [Verificando quais Regiões da AWS têm o Explorador de Recursos ativado](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [GetIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-index.html) na *Referência de comandos da AWS CLI*. 

### `get-view`
<a name="resource-explorer-2_GetView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-view`.

**AWS CLI**  
**Para recuperar detalhes sobre uma visão do Explorador de Recursos**  
O exemplo `get-view` a seguir exibe os detalhes sobre uma visão especificada por seu ARN.  

```
aws resource-explorer-2 get-view \
    --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
```
Resultado:  

```
{
  "Tags" : {},
  "View" : {
        "Filters" : {
            "FilterString" : "service:ec2"
        },
        "IncludedProperties" : [
            {
                "Name" : "tags"
            }
        ],
        "LastUpdatedAt" : "2022-07-13T21:33:45.249Z",
        "Owner" : "123456789012",
        "Scope" : "arn:aws:iam::123456789012:root",
        "ViewArn" : "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
  }
}
```
Para obter mais informações sobre exibições, consulte [Sobre as exibições do Explorador de Recursos](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) no *Guia do Usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [GetView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-view.html) na *Referência de comandos da AWS CLI*. 

### `list-indexes`
<a name="resource-explorer-2_ListIndexes_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-indexes`.

**AWS CLI**  
**Para listar as Regiões da AWS nas quais o Explorador de Recursos tem índices**  
O exemplo `list-indexes` a seguir lista os índices de todas as Regiões em que o Explorador de Recursos tem um índice. A resposta especifica o tipo de cada índice, sua Região da AWS e seu ARN.  

```
aws resource-explorer-2 list-indexes
```
Resultado:  

```
{
    "Indexes": [
        {
            "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111",
            "Region": "us-west-2",
            "Type": "AGGREGATOR"
        },
        {
            "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222",
            "Region": "us-east-1",
            "Type": "LOCAL"
        },
        {
            "Arn": "arn:aws:resource-explorer-2:us-east-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333",
            "Region": "us-east-2",
            "Type": "LOCAL"
        },
        {
            "Arn": "arn:aws:resource-explorer-2:us-west-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE44444",
            "Region": "us-west-1",
            "Type": "LOCAL"
        }
    ]
}
```
Para obter mais informações sobre índices, consulte [Verificando quais Regiões da AWS têm o Explorador de Recursos ativado](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [ListIndexes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-indexes.html) na *Referência de comandos da AWS CLI*. 

### `list-supported-resource-types`
<a name="resource-explorer-2_ListSupportedResourceTypes_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-supported-resource-types`.

**AWS CLI**  
**Para listar as Regiões da AWS nas quais o Explorador de Recursos tem índices**  
O exemplo `list-supported-resource-types` a seguir lista todos os tipos de recursos atualmente compatíveis com &AREXlong;. O exemplo de resposta inclui um valor `NextToken`, que indica que há mais saída disponível para recuperação com chamadas adicionais.  

```
aws resource-explorer-2 list-supported-resource-types \
    --max-items 10
```
Resultado:  

```
{
    "ResourceTypes": [
        {
            "ResourceType": "cloudfront:cache-policy",
            "Service": "cloudfront"
        },
        {
            "ResourceType": "cloudfront:distribution",
            "Service": "cloudfront"
        },
        {
            "ResourceType": "cloudfront:function",
            "Service": "cloudfront"
        },
        {
            "ResourceType": "cloudfront:origin-access-identity",
            "Service": "cloudfront"
        },
        {
            "ResourceType": "cloudfront:origin-request-policy",
            "Service": "cloudfront"
        },
        {
            "ResourceType": "cloudfront:realtime-log-config",
            "Service": "cloudfront"
        },
        {
            "ResourceType": "cloudfront:response-headers-policy",
            "Service": "cloudfront"
        },
        {
            "ResourceType": "cloudwatch:alarm",
            "Service": "cloudwatch"
        },
        {
            "ResourceType": "cloudwatch:dashboard",
            "Service": "cloudwatch"
        },
        {
            "ResourceType": "cloudwatch:insight-rule",
            "Service": "cloudwatch"
        }
    ],
    "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0="
}
```
Para obter a próxima parte da saída, chame a operação novamente e transmita o valor de resposta `NextToken` da chamada anterior como valor para `--starting-token`. Repita até que `NextToken` esteja ausente da resposta.  

```
aws resource-explorer-2 list-supported-resource-types \
    --max-items 10  \
    --starting-token eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=
```
Resultado:  

```
{
    "ResourceTypes": [
        {
            "ResourceType": "cloudwatch:metric-stream",
            "Service": "cloudwatch"
        },
        {
            "ResourceType": "dynamodb:table",
            "Service": "dynamodb"
        },
        {
            "ResourceType": "ec2:capacity-reservation",
            "Service": "ec2"
        },
        {
            "ResourceType": "ec2:capacity-reservation-fleet",
            "Service": "ec2"
        },
        {
            "ResourceType": "ec2:client-vpn-endpoint",
            "Service": "ec2"
        },
        {
            "ResourceType": "ec2:customer-gateway",
            "Service": "ec2"
        },
        {
            "ResourceType": "ec2:dedicated-host",
            "Service": "ec2"
        },
        {
            "ResourceType": "ec2:dhcp-options",
            "Service": "ec2"
        },
        {
            "ResourceType": "ec2:egress-only-internet-gateway",
            "Service": "ec2"
        },
        {
            "ResourceType": "ec2:elastic-gpu",
            "Service": "ec2"
        }
    ],
    "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyMH0="
}
```
Para obter mais informações sobre índices, consulte [Verificando quais Regiões da AWS têm o Explorador de Recursos ativado](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [ListSupportedResourceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-supported-resource-types.html) na *Referência de comandos da AWS CLI*. 

### `list-tags-for-resource`
<a name="resource-explorer-2_ListTagsForResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-tags-for-resource`.

**AWS CLI**  
**Para listar as tags anexadas a uma visão ou índice do Explorador de Recursos**  
O exemplo `list-tags-for-resource` a seguir lista os pares de chave e valor de tag anexados para exibição com o ARN especificado. Você deve chamar a operação na Região da AWS que contém o recurso.  

```
aws resource-explorer-2 list-tags-for-resource \
    --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
```
Resultado:  

```
{
    "Tags": {
        "application": "MainCorpApp",
        "department": "1234"
    }
}
```
Para obter mais informações sobre a marcação de visões, consulte [Como marcar visões para controle de acesso](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-tags-for-resource.html) na *AWS CLI Command Reference*. 

### `list-views`
<a name="resource-explorer-2_ListViews_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-views`.

**AWS CLI**  
**Para listar as visões do Explorador de Recursos disponíveis em uma Região da AWS**  
O exemplo `list-views` a seguir lista todas as visões disponíveis na Região na qual você invoca a operação.  

```
aws resource-explorer-2 list-views
```
Resultado:  

```
{
    "Views": [
        "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111",
        "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Default-All-Resources-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222",
        "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Production-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333"
    ]
}
```
Para obter mais informações sobre exibições, consulte [Sobre as exibições do Explorador de Recursos](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) no *Guia do Usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [ListViews](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-views.html) na *Referência de comandos da AWS CLI*. 

### `search`
<a name="resource-explorer-2_Search_cli_topic"></a>

O código de exemplo a seguir mostra como usar `search`.

**AWS CLI**  
**Exemplo 1: pesquisar usando a visão padrão**  
O exemplo `search` a seguir exibe todos os recursos especificados que estão associados ao serviço. A pesquisa usa a visualização como padrão para a Região. O exemplo de resposta inclui um valor `NextToken`, que indica que há mais saída disponível para recuperação com chamadas adicionais.  

```
aws resource-explorer-2 search \
    --query-string "service:iam"
```
Resultado:  

```
{
    "Count": {
        "Complete": true,
        "TotalResources": 55
    },
    "NextToken": "AG9VOEF1KLEXAMPLEOhJHVwo5chEXAMPLER5XiEpNrgsEXAMPLE...b0CmOFOryHEXAMPLE",
    "Resources": [{
        "Arn": "arn:aws:iam::123456789012:policy/service-role/Some-Policy-For-A-Service-Role",
        "LastReportedAt": "2022-07-21T12:34:42Z",
        "OwningAccountId": "123456789012",
        "Properties": [],
        "Region": "global",
        "ResourceType": "iam:policy",
        "Service": "iam"
    }, {
        "Arn": "arn:aws:iam::123456789012:policy/service-role/Another-Policy-For-A-Service-Role",
        "LastReportedAt": "2022-07-21T12:34:42Z",
        "OwningAccountId": "123456789012",
        "Properties": [],
        "Region": "global",
        "ResourceType": "iam:policy",
        "Service": "iam"
    }, {
       ... TRUNCATED FOR BREVITY ...
    }],
    "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/my-default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
}
```
**Exemplo 2: pesquisar usando uma visão especificada**  
O exemplo de pesquisa `search` a seguir exibe todos os recursos ("\$1") na Região da AWS especificada que são visíveis por meio da visão especificada. Os resultados incluem somente recursos associados ao Amazon EC2, devido aos filtros anexados à visão.  

```
aws resource-explorer-2 search \
    -- query-string "*" \
    -- view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222
```
Resultado:  

```
HTTP/1.1 200 OK
Date: Tue, 01 Nov 2022 20:00:59 GMT
Content-Type: application/json
Content-Length: <PayloadSizeBytes>

    {
        "Count": {
            "Complete": true,
            "TotalResources": 67
        },
        "Resources": [{
            "Arn": "arn:aws:ec2:us-east-1:123456789012:network-acl/acl-1a2b3c4d",
            "LastReportedAt": "2022-07-21T18:52:02Z",
            "OwningAccountId": "123456789012",
            "Properties": [{
                "Data": [{
                    "Key": "Department",
                    "Value": "AppDevelopment"
                }, {
                    "Key": "Environment",
                    "Value": "Production"
                }],
                "LastReportedAt": "2021-11-15T14:48:29Z",
                "Name": "tags"
            }],
            "Region": "us-east-1",
            "ResourceType": "ec2:network-acl",
            "Service": "ec2"
        }, {
            "Arn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-1a2b3c4d",
            "LastReportedAt": "2022-07-21T21:22:23Z",
            "OwningAccountId": "123456789012",
            "Properties": [{
                "Data": [{
                    "Key": "Department",
                    "Value": "AppDevelopment"
                }, {
                    "Key": "Environment",
                    "Value": "Production"
                }],
                "LastReportedAt": "2021-07-29T19:02:39Z",
                "Name": "tags"
            }],
            "Region": "us-east-1",
            "ResourceType": "ec2:subnet",
            "Service": "ec2"
        }, {
            "Arn": "arn:aws:ec2:us-east-1:123456789012:dhcp-options/dopt-1a2b3c4d",
            "LastReportedAt": "2022-07-21T06:08:53Z",
            "OwningAccountId": "123456789012",
            "Properties": [{
                "Data": [{
                    "Key": "Department",
                    "Value": "AppDevelopment"
                }, {
                    "Key": "Environment",
                    "Value": "Production"
                }],
                "LastReportedAt": "2021-11-15T15:11:05Z",
                "Name": "tags"
            }],
            "Region": "us-east-1",
            "ResourceType": "ec2:dhcpoptions",
            "Service": "ec2"
        }, {
            ... TRUNCATED FOR BREVITY ...
        }],
        "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222"
    }
```
Para obter mais informações, consulte [Usando o Explorador de Recursos da AWS para pesquisar recursos](https://docs.aws.amazon.com/resource-explorer/latest/userguide/using-search.html) no *Guia do usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [Search](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/search.html) na *Referência de comandos da AWS CLI*. 

### `tag-resource`
<a name="resource-explorer-2_TagResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `tag-resource`.

**AWS CLI**  
**Para marcar uma visão do Explorador de Recursos**  
O exemplo `tag-resource` a seguir adiciona a chave de tag “environment” com o valor “production” à visão com o ARN especificado.  

```
aws resource-explorer-2 tag-resource \
    --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \
    --tags environment=production
```
Este comando não produz saída.  
Para obter mais informações, consulte [Marcar visualizações para controle de acesso](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) no *Guia do usuário do AWS Resource Explorer*.  
+  Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/tag-resource.html) na *Referência de comandos da AWS CLI*. 

### `untag-resource`
<a name="resource-explorer-2_UntagResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `untag-resource`.

**AWS CLI**  
**Para remover uma tag de uma visão do Explorador de Recursos**  
O exemplo `untag-resource` a seguir remove qualquer tag com o nome de chave "environment" da visão com o ARN especificado.  

```
aws resource-explorer-2 untag-resource \
    --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \
    --tag-keys environment
```
Este comando não produz saída.  
Para obter mais informações, consulte [Marcar visualizações para controle de acesso](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) no *Guia do usuário do AWS Resource Explorer*.  
+  Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/untag-resource.html) na *Referência de comandos da AWS CLI*. 

### `update-index-type`
<a name="resource-explorer-2_UpdateIndexType_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-index-type`.

**AWS CLI**  
**Para alterar o tipo de um índice do Explorador de Recursos**  
O exemplo `update-index-type` a seguir converte o índice especificado do tipo `local` para o tipo `aggregator`, para ativar a capacidade de pesquisar recursos em todas as Regiões da AWS da conta. Você deve enviar a solicitação para a Região da AWS que contém o índice que você deseja atualizar.  

```
aws resource-explorer-2 update-index-type \
    --arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \
    --type aggregator \
    --region us-east-1
```
Resultado:  

```
{
    "Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111",
    "LastUpdatedAt":"2022-07-13T18:41:58.799Z",
    "State":"updating",
    "Type":"aggregator"
}
```
Para obter informações sobre a alteração do tipo de um índice, consulte [Ativar a pesquisa entre regiões criando um índice agregador](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-aggregator-region.html) no *Guia do Usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [UpdateIndexType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-index-type.html) na *Referência de comandos da AWS CLI*. 

### `update-view`
<a name="resource-explorer-2_UpdateView_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-view`.

**AWS CLI**  
**Exemplo 1: atualizar o campo IncludedProperties para uma visão do Explorador de Recursos**  
O exemplo `update-view` a seguir atualiza a exibição especificada adicionando ``tags`` à ``IncludedProperties`` opcional. Depois de executar essa operação, as operações de pesquisa que usam essa visão incluem informações sobre as tags anexadas aos recursos que aparecem nos resultados.  

```
aws resource-explorer-2 update-view \
    --included-properties Name=tags \
    --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222
```
Resultado:  

```
{
    "View": {
        "Filters": {
            "FilterString": ""
        },
        "IncludedProperties": [
            {
                "Name": "tags"
            }
        ],
        "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00",
        "Owner": "123456789012",
        "Scope": "arn:aws:iam::123456789012:root",
        "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
    }
}
```
**Exemplo 2: atualizar os filtros anexados a uma visão**  
O exemplo `update-view` a seguir atualiza a visão especificada para usar um filtro que limita os resultados somente aos tipos de recursos associados ao serviço Amazon EC2.  

```
aws resource-explorer-2 update-view \
    --filters FilterString="service:ec2" \
    --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222
```
Resultado:  

```
{
    "View": {
    "Filters": {
        "FilterString": "service:ec2"
    },
    "IncludedProperties": [],
    "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00",
        "Owner": "123456789012",
        "Scope": "arn:aws:iam::123456789012:root",
        "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222"
    }
}
```
Para obter mais informações sobre exibições, consulte [Sobre as exibições do Explorador de Recursos](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) no *Guia do Usuário do Explorador de Recursos da AWS*.  
+  Para ver detalhes da API, consulte [UpdateView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-view.html) na *Referência de comandos da AWS CLI*.