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

# Gerencie painéis com o AWS CLI
<a name="lake-dashboard-cli-manage"></a>

Esta seção descreve vários outros comandos que você pode executar para gerenciar seus painéis; incluindo obter, listar, recarregar e atualizar um painel.

Ao usar o AWS CLI, lembre-se de que seus comandos são Região da AWS executados no configurado para seu perfil. Se você deseja executar os comandos em uma região diferente, altere a região padrão para o seu perfil ou use o parâmetro `--region` com o comando.

**Topics**
+ [Obtenha um painel com o AWS CLI](#lake-dashboard-cli-get)
+ [Liste painéis com o AWS CLI](#lake-dashboard-cli-list)
+ [Anexe uma política baseada em recursos a um repositório de dados ou painel de controle de eventos com o AWS CLI](#lake-dashboard-cli-add-rbp)
+ [Atualize manualmente um painel com o AWS CLI](#lake-dashboard-cli-refresh)
+ [Atualize um painel com o AWS CLI](#lake-dashboard-cli-update)

## Obtenha um painel com o AWS CLI
<a name="lake-dashboard-cli-get"></a>

Execute o comando `get-dashboard` para retornar um painel. Especifique o `--dashboard-id` fornecendo o ARN do painel ou o nome do painel.

```
aws cloudtrail get-dashboard --dashboard-id arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash
```

## Liste painéis com o AWS CLI
<a name="lake-dashboard-cli-list"></a>

Execute o comando `list-dashboards` para listar os painéis da sua conta.
+ Inclua o parâmetro `--type` para visualizar apenas os painéis `CUSTOM` ou `MANAGED`.
+  Inclua o parâmetro `--max-results` para limitar o número de resultados. Os valores válidos são de 1 a 100.
+ Inclua o `--name-prefix` para retornar os painéis que correspondem ao prefixo especificado.

O exemplo a seguir lista todos os painéis.

```
aws cloudtrail list-dashboards
```

Este exemplo lista apenas os painéis `CUSTOM`.

```
aws cloudtrail list-dashboards --type CUSTOM
```

O próximo exemplo lista apenas os painéis `MANAGED`.

```
aws cloudtrail list-dashboards --type MANAGED
```

O último exemplo lista os painéis que correspondem ao prefixo especificado.

```
aws cloudtrail list-dashboards --name-prefix {{ExamplePrefix}}
```

## Anexe uma política baseada em recursos a um repositório de dados ou painel de controle de eventos com o AWS CLI
<a name="lake-dashboard-cli-add-rbp"></a>

Execute o comando `put-resource-policy` para aplicar uma política baseada em recurso a um painel ou datastore de eventos.

### Anexar uma política baseada em recurso a um datastore de eventos
<a name="lake-dashboard-cli-add-rbp-eds"></a>

Para executar consultas em um painel durante uma atualização manual ou agendada, você precisa anexar uma política baseada em recurso a cada datastore de eventos associado a um widget no painel. Isso permite que o CloudTrail Lake execute as consultas em seu nome. Para obter mais informações sobre políticas baseadas em recursos, consulte [Exemplo: permitir CloudTrail a execução de consultas para atualizar um painel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard).

Os exemplo a seguir anexa a política baseada em recurso a um datastore de eventos. {{account-id}}Substitua pelo ID da sua conta, {{eds-arn}} pelo ARN do armazenamento de dados do evento para o qual CloudTrail serão executadas consultas e {{dashboard-arn}} pelo ARN do painel.

```
aws cloudtrail put-resource-policy \
--resource-arn {{eds-arn}} \
--resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "EDSPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartQuery", "Condition": { "StringEquals": { "AWS:SourceArn": "{{dashboard-arn}}", "AWS:SourceAccount": "{{account-id}}"}}} ]}'
```

### Anexar uma política baseada em recurso a um painel
<a name="lake-dashboard-cli-add-rbp-dashboard"></a>

Para definir um cronograma de atualização para um painel, você precisa anexar uma política baseada em recursos ao painel para permitir que o CloudTrail Lake atualize o painel em seu nome. Para obter mais informações sobre políticas baseadas em recursos, consulte [Exemplo de política baseada em recurso para um painel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

O exemplo a seguir anexa uma política baseada em recurso a um painel. {{account-id}}Substitua pelo ID da sua conta e {{dashboard-arn}} pelo ARN do painel.

```
aws cloudtrail put-resource-policy \
--resource-arn {{dashboard-arn}} \
--resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "DashboardPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartDashboardRefresh", "Condition": { "StringEquals": { "AWS:SourceArn": "{{dashboard-arn}}", "AWS:SourceAccount": "{{account-id}}"}}}]}'
```

## Atualize manualmente um painel com o AWS CLI
<a name="lake-dashboard-cli-refresh"></a>

Execute o comando `start-dashboard-refresh` para atualizar manualmente o painel. Antes de executar esse comando, você deve [anexar uma política baseada em recurso](#lake-dashboard-cli-add-rbp-eds) a cada datastore de eventos associado a um widget do painel.

O exemplo a seguir mostra como atualizar manualmente um painel personalizado.

```
aws cloudtrail start-dashboard-refresh \ 
--dashboard-id  {{dashboard-id}} \ 
--query-parameter-values '{"$StartTime$": "2024-11-05T10:45:24.00Z"}'
```

O próximo exemplo mostra como atualizar manualmente um painel gerenciado. Como os painéis gerenciados são configurados por CloudTrail, a solicitação de atualização precisa incluir a ID do armazenamento de dados do evento no qual as consultas serão executadas.

```
aws cloudtrail start-dashboard-refresh \
--dashboard-id {{dashboard-id}}  \
--query-parameter-values '{"$StartTime$": "2024-11-05T10:45:24.00Z", "$EventDataStoreId$": "{{eds-id}}"}'
```

## Atualize um painel com o AWS CLI
<a name="lake-dashboard-cli-update"></a>

Execute o comando `update-dashboard` para atualizar um painel. Você pode atualizar o painel para definir uma agenda de atualização, habilitar ou desabilitar uma agenda de atualização, modificar os widgets e habilitar ou desabilitar a proteção contra encerramento.

### Atualize o cronograma de atualização com o AWS CLI
<a name="lake-dashboard-cli-update-schedule"></a>

O exemplo a seguir atualiza a agenda de atualização de um painel personalizado denominado `AccountActivityDashboard`.

```
aws cloudtrail update-dashboard --dashboard-id AccountActivityDashboard \
--refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}'
```

### Desative a proteção contra encerramento e o cronograma de atualização em um painel personalizado com o AWS CLI
<a name="lake-dashboard-cli-update-termination-protection"></a>

O exemplo a seguir desabilita a proteção contra encerramento de um painel personalizado denominado `AccountActivityDashboard` para permitir que o painel seja excluído. Também desativa uma agenda de atualização.

```
aws cloudtrail update-dashboard --dashboard-id AccountActivityDashboard \
--refresh-schedule '{ "Status": "DISABLED"}' \
--no-termination-protection-enabled
```

### Para adicionar um widget a um painel personalizado
<a name="lake-dashboard-cli-update-widget"></a>

O exemplo a seguir adiciona um novo widget denominado `TopServices` ao painel personalizado denominado `AccountActivityDashboard`. A matriz de widgets inclui os dois widgets que já foram criados para o painel e o novo widget.

**nota**  
Neste exemplo, `?` está entre aspas simples porque é usado com `eventTime`. Dependendo do sistema operacional sendo executado, pode seja necessário colocar aspas simples entre aspas de escape. Para ter mais informações, consulte [Usar aspas e literais com strings na AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-quoting-strings.html).

```
aws cloudtrail update-dashboard --dashboard-id AccountActivityDashboard \
--widgets '[
    {
      "ViewProperties": {
        "Height": "2",
        "Width": "4",
        "Title": "TopErrors",
        "View": "Table"
      },
      "QueryStatement": "SELECT errorCode, COUNT(*) AS eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' AND (errorCode is not null) GROUP BY errorCode ORDER BY eventCount DESC LIMIT 100",
      "QueryParameters": ["$StartTime$", "$EndTime$"]
    },
    {
      "ViewProperties": {
        "Height": "2",
        "Width": "4",
        "Title": "MostActiveRegions",
        "View": "PieChart",
        "LabelColumn": "awsRegion",
        "ValueColumn": "eventCount",
        "FilterColumn": "awsRegion"
      },
      "QueryStatement": "SELECT awsRegion, COUNT(*) AS eventCount FROM eds where eventTime > '?' and eventTime < '?' GROUP BY awsRegion ORDER BY eventCount LIMIT 100",
      "QueryParameters": ["$StartTime$", "$EndTime$"]
    },
    {
      "ViewProperties": {
        "Height": "2",
        "Width": "4",
        "Title": "TopServices",
        "View": "BarChart",
        "LabelColumn": "service",
        "ValueColumn": "eventCount",
        "FilterColumn": "service",
        "Orientation": "Vertical"
      },
      "QueryStatement": "SELECT replace(eventSource, '.amazonaws.com') AS service, COUNT(*) as eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' GROUP BY eventSource ORDER BY eventCount DESC LIMIT 100",
      "QueryParameters": ["$StartTime$", "$EndTime$"]
    }
  ]'
```