Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Crea, aggiorna e gestisci dashboard con AWS CLI
<a name="lake-dashboard-cli"></a>

Questa sezione descrive i AWS CLI comandi che puoi utilizzare per creare, aggiornare e gestire le dashboard di CloudTrail Lake.

Quando usi il AWS CLI, ricorda che i comandi vengono eseguiti nella Regione AWS configurazione per il tuo profilo. Per eseguire i comandi in un'altra regione, modificare la regione predefinita per il profilo oppure utilizzare il parametro `--region` con il comando.

## Comandi disponibili per i dashboard
<a name="lake-dashboard-cli-commands"></a>

I comandi per la creazione e l'aggiornamento delle dashboard in CloudTrail Lake includono:
+ `create-dashboard`per creare una dashboard personalizzata o abilitare la dashboard Highlights.
+ `update-dashboard`per aggiornare una dashboard personalizzata o la dashboard Highlights.
+ `delete-dashboard`per eliminare una dashboard personalizzata o la dashboard Highlights.
+ `get-dashboard`restituisce informazioni sulla dashboard specificata.
+ `list-dashboards`elenca tutte le dashboard per il tuo Account AWS o per il filtro specificato.
+ `start-dashboard-refresh`avvia un aggiornamento della dashboard.
+ `get-resource-policy`ottiene la politica basata sulle risorse allegata alla dashboard.
+ `put-resource-policy`allega una policy basata sulle risorse a una dashboard per consentire l'aggiornamento asincrono della dashboard CloudTrail per conto dell'utente. È inoltre possibile allegare una policy basata sulle risorse a un data store di eventi per consentire l'esecuzione di query sul data store degli eventi CloudTrail per compilare i dati per i widget del dashboard.
+ `delete-resource-policy`rimuove la politica basata sulle risorse allegata a un dashboard.
+ `add-tags`aggiunge tag per identificare la dashboard.
+ `remove-tags`rimuove i tag da una dashboard.
+ `list-tags`elenca i tag per una dashboard.

Per un elenco dei comandi disponibili per i data store di eventi CloudTrail Lake, vedi[Comandi disponibili per gli archivi dati degli eventi](lake-eds-cli.md#lake-eds-cli-commands).

Per un elenco dei comandi disponibili per le query CloudTrail Lake, consulta[Comandi disponibili per le query su CloudTrail Lake](lake-queries-cli.md#lake-queries-cli-commands).

Per un elenco dei comandi disponibili per le integrazioni di CloudTrail Lake, vedi. [Comandi disponibili per le integrazioni con CloudTrail Lake](lake-integrations-cli.md#lake-integrations-cli-commands)

**Argomenti:**
+  [Crea una dashboard con AWS CLI](lake-dashboard-cli-create.md) 
+  [Gestisci i pannelli di controllo con AWS CLI](lake-dashboard-cli-manage.md) 
+  [Eliminare una dashboard con AWS CLI](lake-dashboard-cli-delete.md) 

# Crea una dashboard con AWS CLI
<a name="lake-dashboard-cli-create"></a>

Questa sezione descrive come utilizzare il `create-dashboard` comando per creare una dashboard personalizzata o la dashboard Highlights.

Quando usi il AWS CLI, ricorda che i comandi vengono eseguiti nella Regione AWS configurazione per il tuo profilo. Per eseguire i comandi in un'altra regione, modificare la regione predefinita per il profilo oppure utilizzare il parametro `--region` con il comando.

 CloudTrail esegue query per popolare i widget della dashboard durante un aggiornamento manuale o pianificato. CloudTrail è necessario disporre delle autorizzazioni per eseguire l'`StartQuery`operazione su ogni archivio dati di eventi associato a un widget del dashboard. Per fornire le autorizzazioni, esegui il `put-resource-policy` comando per allegare una policy basata sulle risorse a ciascun event data store oppure modifica la policy dell'Event Data Store sulla console. CloudTrail Per un esempio di policy, consulta [Esempio: consenti CloudTrail di eseguire query per aggiornare un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard). 

 Per impostare una pianificazione di aggiornamento, è CloudTrail necessario disporre delle autorizzazioni necessarie per eseguire l'`StartDashboardRefresh`operazione di aggiornamento della dashboard per conto dell'utente. Per fornire le autorizzazioni, esegui l'`put-resource-policy`operazione per allegare una politica basata sulle risorse alla dashboard o modifica la politica della dashboard sulla console. CloudTrail Per un esempio di policy, consulta [Esempio di policy basata sulle risorse per un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards). 

**Topics**
+ [Crea una dashboard personalizzata con AWS CLI](#lake-dashboard-cli-create-custom)
+ [Abilita il pannello di controllo Highlights con il AWS CLI](#lake-dashboard-cli-create-highlights)
+ [Visualizza le proprietà dei widget](lake-widget-properties.md)

## Crea una dashboard personalizzata con AWS CLI
<a name="lake-dashboard-cli-create-custom"></a>

La procedura seguente mostra come creare un dashboard personalizzato, allegare le politiche basate sulle risorse richieste agli archivi di dati degli eventi e al dashboard e aggiornare il dashboard per impostare e abilitare una pianificazione di aggiornamento.

1. Esegui il comando per creare un pannello `create-dashboard` di controllo.

   Quando crei una dashboard personalizzata, puoi inserire un array con un massimo di 10 widget. Un widget fornisce una rappresentazione grafica dei risultati di una query. Ogni widget è composto da `ViewProperties``QueryStatement`, e`QueryParameters`.
   + `ViewProperties`: specifica le proprietà per il tipo di visualizzazione. Per ulteriori informazioni, consulta [Visualizza le proprietà dei widget](lake-widget-properties.md).
   + `QueryStatement`— La query CloudTrail viene eseguita quando il dashboard viene aggiornato. È possibile eseguire query su più archivi dati di eventi purché gli archivi dati degli eventi esistano nel proprio account.
   + `QueryParameters`— I seguenti `QueryParameters` valori sono supportati per i dashboard personalizzati:`$Period$`,`$StartTime$`, e`$EndTime$`. Per utilizzare, `QueryParameters` posiziona `?` a nel `QueryStatement` punto in cui desideri sostituire il parametro. CloudTrail inserirà i parametri quando viene eseguita la query.

   L'esempio seguente crea una dashboard con quattro widget, uno per ogni tipo di visualizzazione.
**Nota**  
In questo esempio, `?` è racchiuso tra virgolette singole perché viene utilizzato con`eventTime`. A seconda del sistema operativo in uso, potrebbe essere necessario racchiudere le virgolette singole tra virgolette di escape. Per ulteriori informazioni, vedere [Utilizzo di virgolette e letterali con stringhe](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-quoting-strings.html) in. AWS CLI

   ```
   aws cloudtrail create-dashboard --name 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": "AccountActivity",
           "View": "LineChart",
           "YAxisColumn": "eventCount",
           "XAxisColumn": "eventDate",
           "FilterColumn": "readOnly"
         },
         "QueryStatement": "SELECT DATE_TRUNC('?', eventTime) AS eventDate, IF(readOnly, 'read', 'write') AS readOnly, COUNT(*) as eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' GROUP BY DATE_TRUNC('?', eventTime), readOnly ORDER BY DATE_TRUNC('?', eventTime), readOnly",
         "QueryParameters": ["$Period$", "$StartTime$", "$EndTime$", "$Period$", "$Period$"]
       },
       {
         "ViewProperties": {
           "Height": "2",
           "Width": "4",
           "Title": "TopServices",
           "View": "BarChart",
           "LabelColumn": "service",
           "ValueColumn": "eventCount",
           "FilterColumn": "service",
           "Orientation": "Horizontal"
         },
         "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$"]
       }
     ]'
   ```

1. Crea un file separato con la politica delle risorse necessaria per ogni archivio di dati di eventi incluso in un widget. `QueryStatement` Assegna un nome al file*policy.json*, con la seguente dichiarazione politica di esempio:

    Sostituiscilo *123456789012* con l'ID del tuo account, *arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard* con l'ARN della dashboard.

   Per ulteriori informazioni sulle politiche basate sulle risorse per le dashboard, consulta. [Esempio: consenti CloudTrail di eseguire query per aggiornare un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard)

1. Esegui il `put-resource-policy` comando per allegare la policy. Puoi anche aggiornare la politica basata sulle risorse di un Event Data Store sulla console. CloudTrail 

   L'esempio seguente allega una policy basata sulle risorse a un data store di eventi. 

   ```
   aws cloudtrail put-resource-policy \
   --resource-arn eds-arn \
   --resource-policy file://policy.json
   ```

1. Esegui il `put-resource-policy` comando per allegare una policy basata sulle risorse alla dashboard. Per un esempio di policy, consulta [Esempio di policy basata sulle risorse per un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

   L'esempio seguente allega una policy basata sulle risorse a un pannello di controllo. Sostituiscilo *account-id* con l'ID del tuo account e *dashboard-arn* con l'ARN della dashboard.

   ```
   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"}}}]}'
   ```

1. Esegui il `update-dashboard` comando per impostare e abilitare una pianificazione di aggiornamento configurando il parametro. `--refresh-schedule`

   `--refresh-schedule`È costituito dai seguenti parametri opzionali:
   + `Frequency`— La `Unit` e `Value` per la pianificazione.

     Per i dashboard personalizzati, l'unità può essere `HOURS` o`DAYS`.

      Per i dashboard personalizzati, i seguenti valori sono validi quando l'unità è`HOURS`:`1`,,, `6` `12` `24` 

     Per i dashboard personalizzati, l'unico valore valido quando l'unità è è`DAYS`. `1`
   + `Status`— Speciifica se la pianificazione dell'aggiornamento è abilitata. Imposta il valore `ENABLED` per abilitare la pianificazione dell'aggiornamento o `DISABLED` per disattivarla. 
   + `TimeOfDay `— L'ora del giorno in UTC in cui eseguire la pianificazione; per ora si fa riferimento solo ai minuti; l'impostazione predefinita è 00:00.

   L'esempio seguente imposta una pianificazione di aggiornamento ogni sei ore e abilita la pianificazione.

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

## Abilita il pannello di controllo Highlights con il AWS CLI
<a name="lake-dashboard-cli-create-highlights"></a>

La procedura seguente mostra come creare la dashboard Highlights, allegare le politiche basate sulle risorse richieste ai data store degli eventi e alla dashboard e aggiornare la dashboard per impostare e abilitare la pianificazione degli aggiornamenti.

1. Esegui il `create-dashboard` comando per creare la dashboard Highlights. Per creare questa dashboard, `--name` deve essere`AWSCloudTrail-Highlights`.

   ```
   aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights
   ```

1. Per ogni archivio dati di eventi nel tuo account, esegui il `put-resource-policy` comando per allegare una politica basata sulle risorse all'archivio dati degli eventi. Puoi anche aggiornare la politica basata sulle risorse di un Event Data Store sulla console. CloudTrail Per un esempio di policy, consulta [Esempio: consenti CloudTrail di eseguire query per aggiornare un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard).

   L'esempio seguente allega una policy basata sulle risorse a un data store di eventi. Sostituisci *account-id* con l'ID del tuo account, *eds-arn* con l'ARN dell'archivio dati degli eventi e *dashboard-arn* con l'ARN della dashboard.

   ```
   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"}}} ]}'
   ```

1. Esegui il `put-resource-policy` comando per allegare una politica basata sulle risorse alla dashboard. Per un esempio di policy, consulta [Esempio di policy basata sulle risorse per un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

   L'esempio seguente allega una policy basata sulle risorse a un pannello di controllo. Sostituiscilo *account-id* con l'ID del tuo account e *dashboard-arn* con l'ARN della dashboard.

   ```
   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"}}}]}'
   ```

1. Esegui il `update-dashboard` comando per impostare e abilitare una pianificazione di aggiornamento configurando il parametro. `--refresh-schedule` Per la dashboard Highlights, l'unico valido `UNIT` è `HOURS` e l'unico valido `Value` è. `6`

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

# Visualizza le proprietà dei widget
<a name="lake-widget-properties"></a>

Questa sezione descrive le proprietà di visualizzazione configurabili per i 4 tipi di visualizzazione: tabella, grafico a linee, grafico a torta e grafico a barre.

**Topics**
+ [Tabella](#lake-widget-table)
+ [Grafico a linee](#lake-widget-linechart)
+ [Grafico a torta](#lake-widget-piechart)
+ [Grafico a barre](#lake-widget-barchart)

## Tabella
<a name="lake-widget-table"></a>

L'esempio seguente mostra un widget configurato come tabella.

```
{
    "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$"]
}
```

La tabella seguente descrive le proprietà di visualizzazione configurabili per una tabella.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza della tabella in pollici.  | 
|  `Width`  |  Sì  |  La larghezza della tabella in pollici.  | 
|  `Title`  |  Sì  |  Il titolo della tabella.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per una tabella, il valore è`Table`.  | 

## Grafico a linee
<a name="lake-widget-linechart"></a>

L'esempio seguente mostra un widget configurato come grafico a linee.

```
{
    "ViewProperties": {
       "Height": "2",
       "Width": "4",
       "Title": "AccountActivity",
       "View": "LineChart",
       "YAxisColumn": "eventCount",
       "XAxisColumn": "eventDate",
       "FilterColumn": "readOnly"
    },
    "QueryStatement": "SELECT DATE_TRUNC('?', eventTime) AS eventDate, IF(readOnly, 'read', 'write') AS readOnly, COUNT(*) as eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' GROUP BY DATE_TRUNC('?', eventTime), readOnly ORDER BY DATE_TRUNC('?', eventTime), readOnly",
    "QueryParameters": ["$Period$", "$StartTime$", "$EndTime$", "$Period$", "$Period$"]
}
```

La tabella seguente descrive le proprietà di visualizzazione configurabili per un grafico a linee.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza del grafico a linee in pollici.  | 
|  `Width`  |  Sì  |  La larghezza del grafico a linee in pollici.  | 
|  `Title`  |  Sì  |  Il titolo del grafico a linee.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per un grafico a linee, il valore è`LineChart`.  | 
|  `YAxisColumn`  |  Sì  |  Il campo dei risultati della query che si desidera utilizzare per la colonna dell'asse Y. Ad esempio, `eventCount`.  | 
|  `XAxisColumn`  |  Sì  |  Il campo dei risultati della query che si desidera utilizzare per la colonna dell'asse X. Ad esempio, `eventDate`.  | 
|  `FilterColumn`  |  No  |  Il campo dei risultati della query in base al quale si desidera filtrare. Ad esempio, `readOnly`.  | 

## Grafico a torta
<a name="lake-widget-piechart"></a>

L'esempio seguente mostra un widget configurato come grafico a torta.

```
{
    "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$"]
}
```

La tabella seguente descrive le proprietà di visualizzazione configurabili per un grafico a torta.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza del grafico a torta in pollici.  | 
|  `Width`  |  Sì  |  La larghezza del grafico a torta in pollici.  | 
|  `Title`  |  Sì  |  Il titolo del grafico a torta.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per un grafico a torta, il valore è`PieChart`.  | 
|  `LabelColumn`  |  Sì  |  L'etichetta per i segmenti nel grafico a torta. Ad esempio, `awsRegion`.  | 
|  `ValueColumn`  |  Sì  |  Il valore dei segmenti nel grafico a torta. Ad esempio, `ValueColumn`.  | 
|  `FilterColumn`  |  No  |  Il campo dei risultati della query in base al quale si desidera filtrare. Ad esempio, `awsRegion`.  | 

## Grafico a barre
<a name="lake-widget-barchart"></a>

L'esempio seguente mostra un widget configurato come grafico a barre.

```
{
    "ViewProperties": {
       "Height": "2",
       "Width": "4",
       "Title": "TopServices",
       "View": "BarChart",
       "LabelColumn": "service",
       "ValueColumn": "eventCount",
       "FilterColumn": "service",
       "Orientation": "Horizontal"
    },
    "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$"]
}
```

La tabella seguente descrive le proprietà di visualizzazione configurabili per un grafico a barre.


| Parametro | Obbligatorio | Valore | 
| --- | --- | --- | 
|  `Height`  |  Sì  |  L'altezza del grafico a barre in pollici.  | 
|  `Width`  |  Sì  |  La larghezza del grafico a barre in pollici.  | 
|  `Title`  |  Sì  |  Il titolo del grafico a barre.  | 
|  `View`  |  Sì  |  Il tipo di visualizzazione del widget. Per un grafico a barre, il valore è`BarChart`.  | 
|  `LabelColumn`  |  Sì  |  L'etichetta per le barre nel grafico a barre. Ad esempio, `service`.  | 
|  `ValueColumn`  |  Sì  |  Il valore delle barre nel grafico a barre. Ad esempio, `eventCount`.  | 
|  `FilterColumn`  |  No  |  Il campo dei risultati della query in base al quale si desidera filtrare. Ad esempio, `service`.  | 
|  `Orientation`  |  No  |  L'orientamento del grafico a barre, `Horizontal` o`Vertical`.  | 

# Gestisci i pannelli di controllo con AWS CLI
<a name="lake-dashboard-cli-manage"></a>

Questa sezione descrive diversi altri comandi che puoi eseguire per gestire i dashboard, tra cui creare una dashboard, elencare le dashboard, aggiornare una dashboard e aggiornare una dashboard.

Quando usi il AWS CLI, ricorda che i comandi vengono eseguiti nella Regione AWS configurazione per il tuo profilo. Per eseguire i comandi in un'altra regione, modificare la regione predefinita per il profilo oppure utilizzare il parametro `--region` con il comando.

**Topics**
+ [Ottieni una dashboard con AWS CLI](#lake-dashboard-cli-get)
+ [Elenca i dashboard con AWS CLI](#lake-dashboard-cli-list)
+ [Allega una policy basata sulle risorse a un data store o dashboard di eventi con il AWS CLI](#lake-dashboard-cli-add-rbp)
+ [Aggiorna manualmente una dashboard con AWS CLI](#lake-dashboard-cli-refresh)
+ [Aggiorna una dashboard con il AWS CLI](#lake-dashboard-cli-update)

## Ottieni una dashboard con AWS CLI
<a name="lake-dashboard-cli-get"></a>

Esegui il `get-dashboard` comando per restituire una dashboard. Specificare il `--dashboard-id` fornendo l'ARN del dashboard o il nome del dashboard.

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

## Elenca i dashboard con AWS CLI
<a name="lake-dashboard-cli-list"></a>

Esegui il `list-dashboards` comando per elencare le dashboard del tuo account.
+ Includi il `--type` parametro, per visualizzare solo le `MANAGED` dashboard `CUSTOM` o.
+  Includi il `--max-results` parametro per limitare il numero di risultati. I valori validi sono 1-100.
+ `--name-prefix`Includi i dashboard di ritorno corrispondenti al prefisso specificato.

L'esempio seguente elenca tutti i dashboard.

```
aws cloudtrail list-dashboards
```

Questo esempio elenca solo i `CUSTOM` dashboard.

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

L'esempio successivo elenca solo i `MANAGED` dashboard.

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

L'ultimo esempio elenca i dashboard che corrispondono al prefisso specificato.

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

## Allega una policy basata sulle risorse a un data store o dashboard di eventi con il AWS CLI
<a name="lake-dashboard-cli-add-rbp"></a>

Esegui il `put-resource-policy` comando per applicare una policy basata sulle risorse a un data store o dashboard di eventi.

### Allega una policy basata sulle risorse a un data store di eventi
<a name="lake-dashboard-cli-add-rbp-eds"></a>

Per eseguire interrogazioni su una dashboard durante un aggiornamento manuale o pianificato, devi allegare una policy basata sulle risorse a ogni archivio di dati di eventi associato a un widget sulla dashboard. Ciò consente a CloudTrail Lake di eseguire le query per tuo conto. Per ulteriori informazioni sulla politica basata sulle risorse, consulta. [Esempio: consenti CloudTrail di eseguire query per aggiornare un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard)

L'esempio seguente allega una policy basata sulle risorse a un archivio dati di eventi. Sostituiscilo *account-id* con l'ID del tuo account, *eds-arn* con l'ARN dell'archivio dati degli eventi per il quale CloudTrail verranno eseguite le query e con *dashboard-arn* l'ARN della dashboard.

```
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"}}} ]}'
```

### Allega una policy basata sulle risorse a una dashboard
<a name="lake-dashboard-cli-add-rbp-dashboard"></a>

Per impostare una pianificazione di aggiornamento per una dashboard, devi allegare alla dashboard una policy basata sulle risorse per consentire a CloudTrail Lake di aggiornare la dashboard per tuo conto. Per ulteriori informazioni sulla politica basata sulle risorse, consulta. [Esempio di policy basata sulle risorse per un pannello di controllo](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards)

L'esempio seguente allega una policy basata sulle risorse a un pannello di controllo. Sostituiscilo *account-id* con l'ID del tuo account e *dashboard-arn* con l'ARN della dashboard.

```
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"}}}]}'
```

## Aggiorna manualmente una dashboard con AWS CLI
<a name="lake-dashboard-cli-refresh"></a>

Esegui il `start-dashboard-refresh` comando per aggiornare manualmente la dashboard. Prima di poter eseguire questo comando, è necessario [allegare una policy basata sulle risorse](#lake-dashboard-cli-add-rbp-eds) a ogni archivio di dati di eventi associato a un widget del dashboard.

L'esempio seguente mostra come aggiornare manualmente una dashboard personalizzata.

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

L'esempio successivo mostra come aggiornare manualmente una dashboard gestita. Poiché i dashboard gestiti sono configurati da CloudTrail, la richiesta di aggiornamento deve includere l'ID del data store degli eventi su cui verranno eseguite le query.

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

## Aggiorna una dashboard con il AWS CLI
<a name="lake-dashboard-cli-update"></a>

Esegui il `update-dashboard` comando per aggiornare un pannello di controllo. Puoi aggiornare la dashboard per impostare una pianificazione di aggiornamento, abilitare o disabilitare una pianificazione di aggiornamento, modificare i widget e abilitare o disabilitare la protezione dalla terminazione.

### Aggiorna la pianificazione dell'aggiornamento con il AWS CLI
<a name="lake-dashboard-cli-update-schedule"></a>

L'esempio seguente aggiorna la pianificazione dell'aggiornamento per un pannello di controllo personalizzato denominato. `AccountActivityDashboard`

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

### Disabilita la protezione dalla terminazione e la pianificazione degli aggiornamenti su un pannello di controllo personalizzato con il AWS CLI
<a name="lake-dashboard-cli-update-termination-protection"></a>

L'esempio seguente disattiva la protezione dalla terminazione per un dashboard personalizzato denominato `AccountActivityDashboard` per consentire l'eliminazione del dashboard. Disattiva anche la pianificazione degli aggiornamenti.

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

### Aggiungi un widget a una dashboard personalizzata
<a name="lake-dashboard-cli-update-widget"></a>

L'esempio seguente aggiunge un nuovo widget denominato `TopServices` alla dashboard personalizzata denominata`AccountActivityDashboard`. L'array di widget include i due widget già creati per la dashboard e il nuovo widget.

**Nota**  
In questo esempio, `?` è racchiuso tra virgolette singole perché viene utilizzato con. `eventTime` A seconda del sistema operativo in uso, potrebbe essere necessario racchiudere le virgolette singole tra virgolette di escape. Per ulteriori informazioni, vedere [Utilizzo di virgolette e letterali con stringhe](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-quoting-strings.html) in. AWS CLI

```
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$"]
    }
  ]'
```

# Eliminare una dashboard con AWS CLI
<a name="lake-dashboard-cli-delete"></a>

Questa sezione descrive come utilizzare il AWS CLI `delete-dashboard` comando per eliminare una dashboard di CloudTrail Lake.

Per eliminare un dashboard, specificalo `--dashboard-id` fornendo l'ARN del dashboard o il nome del dashboard.

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

Se l'operazione riesce, non verrà generata alcuna risposta.

**Nota**  
Non puoi eliminare una dashboard se `--termination-protection-enabled` è impostata.