Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Cree, actualice y gestione cuadros de mando con AWS CLI
<a name="lake-dashboard-cli"></a>

En esta sección se describen los AWS CLI comandos que puede usar para crear, actualizar y administrar sus paneles de CloudTrail Lake.

Cuando utilice el AWS CLI, recuerde que sus comandos se ejecutan en la Región de AWS configuración de su perfil. Si desea ejecutar los comandos en otra región, cambie la región predeterminada de su perfil o utilice el parámetro `--region` con el comando.

## Comandos disponibles para los paneles
<a name="lake-dashboard-cli-commands"></a>

Los comandos para crear y actualizar paneles en CloudTrail Lake incluyen:
+ `create-dashboard` para crear un panel personalizado o habilitar el panel de aspectos destacados.
+ `update-dashboard` para actualizar un panel personalizado o el panel de aspectos destacados.
+ `delete-dashboard` para eliminar un panel personalizado o el panel de aspectos destacados.
+ `get-dashboard` devuelve información sobre el panel especificado.
+ `list-dashboards`muestra todos los paneles de control de su Cuenta de AWS filtro o del filtro especificado.
+ `start-dashboard-refresh` inicia una actualización del panel.
+ `get-resource-policy` asocia la política basada en recursos al panel.
+ `put-resource-policy`adjunta una política basada en recursos a un panel para permitir actualizar el panel de forma CloudTrail asíncrona en su nombre. También puede adjuntar una política basada en recursos a un banco de datos de eventos para poder ejecutar consultas en el banco de datos de eventos CloudTrail a fin de rellenar los datos de los widgets del panel de control.
+ `delete-resource-policy` elimina la política basada en recursos asociada a un panel.
+ `add-tags` agrega etiquetas para identificar el panel.
+ `remove-tags` elimina las etiquetas de un panel.
+ `list-tags` hace una lista de etiquetas de un panel.

Para obtener una lista de los comandos disponibles para los almacenes de datos de eventos de CloudTrail Lake, consulte. [Comandos disponibles para los almacenes de datos de eventos](lake-eds-cli.md#lake-eds-cli-commands)

Para obtener una lista de los comandos disponibles para las consultas de CloudTrail Lake, consulte[Comandos disponibles para las consultas de CloudTrail Lake](lake-queries-cli.md#lake-queries-cli-commands).

Para obtener una lista de los comandos disponibles para las integraciones de CloudTrail Lake, consulte[Comandos disponibles para las integraciones de CloudTrail Lake](lake-integrations-cli.md#lake-integrations-cli-commands).

**Temas:**
+  [Cree un panel con AWS CLI](lake-dashboard-cli-create.md) 
+  [Gestione los paneles de control con AWS CLI](lake-dashboard-cli-manage.md) 
+  [Elimine un panel con el AWS CLI](lake-dashboard-cli-delete.md) 

# Cree un panel con AWS CLI
<a name="lake-dashboard-cli-create"></a>

En esta sección se describe cómo utilizar el comando `create-dashboard` para crear un panel personalizado o el panel de aspectos destacados.

Cuando utilice el AWS CLI, recuerde que sus comandos se ejecutan en la Región de AWS configuración de su perfil. Si desea ejecutar los comandos en otra región, cambie la región predeterminada de su perfil o utilice el parámetro `--region` con el comando.

 CloudTrail ejecuta consultas para rellenar los widgets del panel de control durante una actualización manual o programada. CloudTrail se le deben conceder permisos para ejecutar la `StartQuery` operación en cada almacén de datos de eventos asociado a un widget de panel. Para proporcionar permisos, ejecute el `put-resource-policy` comando para adjuntar una política basada en recursos a cada banco de datos de eventos o edite la política del banco de datos de eventos en la CloudTrail consola. Para ver una política de ejemplo, consulte [Ejemplo: CloudTrail permitir la ejecución de consultas para actualizar un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard). 

 Para establecer un programa de actualización, CloudTrail debe tener permisos para ejecutar la `StartDashboardRefresh` operación de actualización del panel en su nombre. Para proporcionar permisos, ejecute la `put-resource-policy` operación para adjuntar una política basada en recursos al panel de control o edite la política del panel en la CloudTrail consola. Para ver una política de ejemplo, consulte [Ejemplo de política basada en recursos para un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards). 

**Topics**
+ [Cree un panel personalizado con el AWS CLI](#lake-dashboard-cli-create-custom)
+ [Habilite el panel de aspectos destacados con el AWS CLI](#lake-dashboard-cli-create-highlights)
+ [Consulte las propiedades de los widgets](lake-widget-properties.md)

## Cree un panel personalizado con el AWS CLI
<a name="lake-dashboard-cli-create-custom"></a>

El siguiente procedimiento indica cómo crear un panel personalizado, asociar las políticas basadas en recursos necesarias a los almacenes de datos de eventos y al panel, y actualizar el panel para establecer y habilitar un programa de actualización.

1. Ejecutar `create-dashboard` para crear un panel

   Al crear un panel personalizado, puede incluir una matriz con hasta 10 widgets. Un widget ofrece una representación gráfica de los resultados de una consulta. Cada widget consta de `ViewProperties`, `QueryStatement` y `QueryParameters`.
   + `ViewProperties`: especifica las propiedades del tipo de vista. Para obtener más información, consulte [Consulte las propiedades de los widgets](lake-widget-properties.md).
   + `QueryStatement`— La consulta CloudTrail se ejecuta cuando se actualiza el panel. Puede realizar consultas en varios almacenes de datos de eventos siempre que los almacenes de datos de eventos existan en su cuenta.
   + `QueryParameters`: los siguientes valores de `QueryParameters` son compatibles con los paneles personalizados: `$Period$`, `$StartTime$` y `$EndTime$`. Para `QueryParameters` utilizarla, coloque a `?` en el lugar `QueryStatement` donde desee sustituir el parámetro. CloudTrail rellenará los parámetros cuando se ejecute la consulta.

   En el siguiente ejemplo se crea un panel con cuatro widgets, uno de cada tipo de vista.
**nota**  
En este ejemplo, `?` está rodeado de comillas simples porque se utiliza con `eventTime`. Según el sistema operativo que utilice, es posible que necesite poner comillas de escape entre las comillas simples. Para obtener más información, consulte [Uso de entrecomillado y literales con cadenas en la AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-quoting-strings.html).

   ```
   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. Cree un archivo independiente con la política de recursos necesaria para cada almacén de datos de eventos que se incluya en la `QueryStatement` del widget. Asigne un nombre al archivo *policy.json* con el siguiente ejemplo de declaración de política:

    *123456789012*Sustitúyelo por el ID de su cuenta, *arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard* por el ARN del panel de control.

   Para obtener más información sobre las políticas basadas en recursos para los paneles, consulte [Ejemplo: CloudTrail permitir la ejecución de consultas para actualizar un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard).

1. Ejecute el comando `put-resource-policy` para asociar la política. También puedes actualizar la política basada en los recursos de un almacén de datos de eventos en la consola. CloudTrail 

   En el siguiente ejemplo se asocia la política basada en recursos a un almacén de datos de eventos. 

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

1. Ejecute el comando `put-resource-policy` para asociar una política basada en recursos al panel. Para ver una política de ejemplo, consulte [Ejemplo de política basada en recursos para un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

   En el siguiente ejemplo se asocia una política basada en recursos a un panel. *account-id*Sustitúyala por tu ID de cuenta y *dashboard-arn* por el ARN del panel de control.

   ```
   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. Ejecute el comando `update-dashboard` para establecer y habilitar un programa de actualización configurando el parámetro `--refresh-schedule`.

   El `--refresh-schedule` consta de los siguientes parámetros opcionales:
   + `Frequency`: el `Unit` y `Value` para el programa.

     Para los paneles personalizados, la unidad puede ser `HOURS` o`DAYS`.

      En el caso de los paneles personalizados, los siguientes valores son válidos cuando la unidad es `HOURS`, `1`, `6`, `12`, `24`. 

     En el caso de los paneles personalizados, el único valor válido cuando la unidad es `DAYS` es `1`.
   + `Status`: especifica si el programa de actualización está habilitado. Establezca el valor en `ENABLED` para habilitar el programa de actualización o `DISABLED` para deshabilitarlo. 
   + `TimeOfDay `: la hora del día en UTC en la que se ejecuta el programa; para ver solo por hora, consulte los minutos; el valor predeterminado es 00:00.

   En el siguiente ejemplo, se establece un programa de actualización para cada seis horas y se habilita el programa.

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

## Habilite el panel de aspectos destacados con el AWS CLI
<a name="lake-dashboard-cli-create-highlights"></a>

El siguiente procedimiento indica cómo crear un panel de aspectos destacados, asociar las políticas basadas en recursos necesarias a los almacenes de datos de eventos y al panel, y actualizar el panel para establecer y habilitar un programa de actualización.

1. Ejecute el comando `create-dashboard` para crear el panel de aspectos destacados. A fin de crear este panel, `--name` debe ser `AWSCloudTrail-Highlights`.

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

1. Para cada almacén de datos de eventos de su cuenta, ejecute el comando `put-resource-policy` a fin de asociar una política basada en recursos al almacén de datos de eventos. También puedes actualizar la política basada en los recursos de un almacén de datos de eventos en la CloudTrail consola. Para ver una política de ejemplo, consulte [Ejemplo: CloudTrail permitir la ejecución de consultas para actualizar un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard).

   En el siguiente ejemplo se asocia la política basada en recursos a un almacén de datos de eventos. *account-id*Sustitúyalo por tu ID *eds-arn* de cuenta, por el ARN del almacén de datos del evento y por el *dashboard-arn* ARN del panel de control.

   ```
   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. Ejecute el comando `put-resource-policy` para asociar una política basada en recursos al panel. Para ver una política de ejemplo, consulte [Ejemplo de política basada en recursos para un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

   En el siguiente ejemplo se asocia una política basada en recursos a un panel. *account-id*Sustitúyala por tu ID de cuenta y *dashboard-arn* por el ARN del panel de control.

   ```
   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. Ejecute el comando `update-dashboard` para establecer y habilitar un programa de actualización configurando el parámetro `--refresh-schedule`. Para el panel de aspectos destacados, la única `UNIT` válida es `HOURS` y lo único `Value` válido es `6`.

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

# Consulte las propiedades de los widgets
<a name="lake-widget-properties"></a>

En esta sección, se describen las propiedades de vista que pueden configurarse para los cuatro tipos de vista: tabla, gráfico de líneas, gráfico circular y gráfico de barras.

**Topics**
+ [Tabla](#lake-widget-table)
+ [Gráfico de líneas](#lake-widget-linechart)
+ [Gráfico circular](#lake-widget-piechart)
+ [Gráfico de barras](#lake-widget-barchart)

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

En el siguiente ejemplo, se muestra un widget configurado como una tabla.

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

En la siguiente tabla, se describen las propiedades de vista que pueden configurarse para una tabla.


| Parámetro | Obligatorio | Valor | 
| --- | --- | --- | 
|  `Height`  |  Sí  |  La altura de la tabla en pulgadas.  | 
|  `Width`  |  Sí  |  El ancho de la tabla en pulgadas.  | 
|  `Title`  |  Sí  |  El título de la tabla.  | 
|  `View`  |  Sí  |  El tipo de vista del widget. En el caso de una tabla, el valor es`Table`.  | 

## Gráfico de líneas
<a name="lake-widget-linechart"></a>

En el siguiente ejemplo, se muestra un widget configurado como un gráfico de líneas.

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

En la siguiente tabla, se describen las propiedades de vista que pueden configurarse para un gráfico de líneas.


| Parámetro | Obligatorio | Valor | 
| --- | --- | --- | 
|  `Height`  |  Sí  |  La altura del gráfico de líneas en pulgadas.  | 
|  `Width`  |  Sí  |  El ancho del gráfico de líneas en pulgadas.  | 
|  `Title`  |  Sí  |  El título del gráfico de líneas.  | 
|  `View`  |  Sí  |  El tipo de vista del widget. En el caso de un gráfico de líneas, el valor es `LineChart`.  | 
|  `YAxisColumn`  |  Sí  |  El campo de los resultados de la consulta que quiere utilizar para la columna del eje Y. Por ejemplo, `eventCount`.  | 
|  `XAxisColumn`  |  Sí  |  El campo de los resultados de la consulta que quiere utilizar para la columna del eje X. Por ejemplo, `eventDate`.  | 
|  `FilterColumn`  |  No  |  El campo de los resultados de la consulta que quiere filtrar. Por ejemplo, `readOnly`.  | 

## Gráfico circular
<a name="lake-widget-piechart"></a>

En el siguiente ejemplo, se muestra un widget configurado como un gráfico circular.

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

En la siguiente tabla, se describen las propiedades de vista que pueden configurarse para un gráfico circular.


| Parámetro | Obligatorio | Valor | 
| --- | --- | --- | 
|  `Height`  |  Sí  |  La altura del gráfico circular en pulgadas.  | 
|  `Width`  |  Sí  |  El ancho del gráfico circular en pulgadas.  | 
|  `Title`  |  Sí  |  El título del gráfico circular.  | 
|  `View`  |  Sí  |  El tipo de vista del widget. En el caso de un gráfico circular, el valor es `PieChart`.  | 
|  `LabelColumn`  |  Sí  |  La etiqueta de los segmentos del gráfico circular. Por ejemplo, `awsRegion`.  | 
|  `ValueColumn`  |  Sí  |  El valor de los segmentos del gráfico circular. Por ejemplo, `ValueColumn`.  | 
|  `FilterColumn`  |  No  |  El campo de los resultados de la consulta que quiere filtrar. Por ejemplo, `awsRegion`.  | 

## Gráfico de barras
<a name="lake-widget-barchart"></a>

En el siguiente ejemplo, se muestra un widget configurado como un gráfico de barras.

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

En la siguiente tabla, se describen las propiedades de vista que pueden configurarse para un gráfico de barras.


| Parámetro | Obligatorio | Valor | 
| --- | --- | --- | 
|  `Height`  |  Sí  |  La altura del gráfico de barras en pulgadas.  | 
|  `Width`  |  Sí  |  Ancho del gráfico de barras en pulgadas.  | 
|  `Title`  |  Sí  |  El título del gráfico de barras.  | 
|  `View`  |  Sí  |  El tipo de vista del widget. En el caso de un gráfico de barras, el valor es `BarChart`.  | 
|  `LabelColumn`  |  Sí  |  La etiqueta de las barras del gráfico de barras. Por ejemplo, `service`.  | 
|  `ValueColumn`  |  Sí  |  El valor de las barras del gráfico de barras. Por ejemplo, `eventCount`.  | 
|  `FilterColumn`  |  No  |  El campo de los resultados de la consulta que quiere filtrar. Por ejemplo, `service`.  | 
|  `Orientation`  |  No  |  La orientación del gráfico de barras, ya sea `Horizontal` o `Vertical`.  | 

# Gestione los paneles de control con AWS CLI
<a name="lake-dashboard-cli-manage"></a>

En esta sección, se describen distintos comandos que puede ejecutar para administrar sus paneles, como obtener un panel, enumerar sus paneles, actualizar un panel.

Cuando utilice el AWS CLI, recuerde que sus comandos se ejecutan en la Región de AWS configuración de su perfil. Si desea ejecutar los comandos en otra región, cambie la región predeterminada de su perfil o utilice el parámetro `--region` con el comando.

**Topics**
+ [Obtenga un panel con AWS CLI](#lake-dashboard-cli-get)
+ [Enumere los paneles con AWS CLI](#lake-dashboard-cli-list)
+ [Adjunte una política basada en recursos a un banco de datos o un panel de control de eventos con la AWS CLI](#lake-dashboard-cli-add-rbp)
+ [Actualice manualmente un panel de control con el AWS CLI](#lake-dashboard-cli-refresh)
+ [Actualice un panel con AWS CLI](#lake-dashboard-cli-update)

## Obtenga un panel con AWS CLI
<a name="lake-dashboard-cli-get"></a>

Ejecute el comando `get-dashboard` para volver a un panel. Especifique el `--dashboard-id` mediante el ARN del panel o el nombre del panel.

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

## Enumere los paneles con AWS CLI
<a name="lake-dashboard-cli-list"></a>

Ejecute el comando `list-dashboards` para enumerar los paneles de su cuenta.
+ Incluya el parámetro `--type` para ver solo los paneles `CUSTOM` o `MANAGED`.
+  Incluya el parámetro `--max-results` para limitar la cantidad de resultados. Los valores válidos son del 1 al 100.
+ Incluya los `--name-prefix` para volver a los paneles que coincidan con el prefijo especificado.

En el ejemplo siguiente, se muestran todos los paneles.

```
aws cloudtrail list-dashboards
```

En este ejemplo, se muestran solo los paneles de `CUSTOM`.

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

En el siguiente ejemplo, se muestran solo los paneles de `MANAGED`.

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

En el último ejemplo se enumeran los paneles que coinciden con el prefijo especificado.

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

## Adjunte una política basada en recursos a un banco de datos o un panel de control de eventos con la AWS CLI
<a name="lake-dashboard-cli-add-rbp"></a>

Ejecute el comando `put-resource-policy` para aplicar una política basada en recursos a un almacén de datos de eventos o panel.

### Asocie una política basada en recursos a un almacén de datos de eventos
<a name="lake-dashboard-cli-add-rbp-eds"></a>

Para ejecutar las consultas en un panel durante una actualización manual o programada, debe asociar una política basada en recursos a cada almacén de datos de eventos que esté asociado a un widget en el panel. Esto permite a CloudTrail Lake ejecutar las consultas en tu nombre. Para obtener más información sobre la política basada en recursos, consulte [Ejemplo: CloudTrail permitir la ejecución de consultas para actualizar un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard).

En el siguiente ejemplo se asocia la política basada en recursos a un almacén de datos de eventos. *account-id*Sustitúyalo por tu ID de cuenta, *eds-arn* por el ARN del almacén de datos del evento para el que CloudTrail se ejecutarán las consultas y por el *dashboard-arn* ARN del panel de control.

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

### Asociar una política basada en recursos a un panel
<a name="lake-dashboard-cli-add-rbp-dashboard"></a>

Para establecer un programa de actualización para un panel, debe adjuntar una política basada en recursos al panel para que CloudTrail Lake pueda actualizar el panel en su nombre. Para obtener más información sobre la política basada en recursos, consulte [Ejemplo de política basada en recursos para un panel](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

En el siguiente ejemplo se asocia una política basada en recursos a un panel. *account-id*Sustitúyala por tu ID de cuenta y *dashboard-arn* por el ARN del panel de control.

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

## Actualice manualmente un panel de control con el AWS CLI
<a name="lake-dashboard-cli-refresh"></a>

Ejecute el comando `start-dashboard-refresh` para actualizar de manera manual el panel. Antes de ejecutar este comando, debe [asociar una política basada en recursos](#lake-dashboard-cli-add-rbp-eds) a cada almacén de datos de eventos asociado a un widget de panel.

En el siguiente ejemplo, se muestra cómo actualizar de manera manual un panel personalizado.

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

En el siguiente ejemplo, se muestra cómo actualizar de manera manual un panel administrado. Como los paneles gestionados se configuran mediante CloudTrail, la solicitud de actualización debe incluir el ID del almacén de datos del evento en el que se ejecutarán las consultas.

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

## Actualice un panel con AWS CLI
<a name="lake-dashboard-cli-update"></a>

Ejecute el comando `update-dashboard` para actualizar un panel. Puede actualizar el panel para establecer un programa de actualización, habilitar o deshabilitar un programa de actualización, modificar los widgets y habilitar o deshabilitar la protección contra la terminación.

### Actualice el programa de actualización con el AWS CLI
<a name="lake-dashboard-cli-update-schedule"></a>

En el ejemplo siguiente, se actualiza el programa de actualización de un panel personalizado conocido como `AccountActivityDashboard`.

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

### Desactive la protección de terminación y el programa de actualización en un panel personalizado con el AWS CLI
<a name="lake-dashboard-cli-update-termination-protection"></a>

En el siguiente ejemplo, se deshabilita la protección contra la terminación de un panel personalizado conocido como `AccountActivityDashboard` para permitir eliminarlo. También deshabilita el programa de actualización.

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

### Agregar un widget a un panel personalizado
<a name="lake-dashboard-cli-update-widget"></a>

En el siguiente ejemplo, se agrega un widget nuevo conocido como `TopServices` al panel personalizado denominado `AccountActivityDashboard`. La matriz de widgets incluye los dos widgets que ya se crearon para el panel y el widget nuevo.

**nota**  
En este ejemplo, `?` está rodeado de comillas simples porque se utiliza con `eventTime`. Según el sistema operativo que utilice, es posible que necesite poner comillas de escape entre las comillas simples. Para obtener más información, consulte [Uso de entrecomillado y literales con cadenas en la 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$"]
    }
  ]'
```

# Elimine un panel con el AWS CLI
<a name="lake-dashboard-cli-delete"></a>

En esta sección se describe cómo usar el AWS CLI `delete-dashboard` comando para eliminar un panel de CloudTrail Lake.

Para eliminar un panel, especifique el `--dashboard-id` mediante el ARN del panel o el nombre del panel.

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

Si la operación se realiza correctamente, no se produce ninguna respuesta.

**nota**  
No puede eliminar un panel si está configurado `--termination-protection-enabled`.