Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwalten Sie Dashboards mit dem AWS CLI
<a name="lake-dashboard-cli-manage"></a>

In diesem Abschnitt werden mehrere andere Befehle beschrieben, die Sie ausführen können, um Ihre Dashboards zu verwalten, darunter das Abrufen eines Dashboards, das Auflisten Ihrer Dashboards, das Aktualisieren eines Dashboards und das Aktualisieren eines Dashboards.

Denken Sie bei der Verwendung von daran AWS CLI, dass Ihre Befehle in der für Ihr Profil AWS-Region konfigurierten Version ausgeführt werden. Wenn Sie die Befehle in einer anderen Region ausführen möchten, ändern Sie entweder die Standardregion für Ihr Profil, oder verwenden Sie den `--region`-Parameter mit dem Befehl.

**Topics**
+ [Holen Sie sich ein Dashboard mit AWS CLI](#lake-dashboard-cli-get)
+ [Listet Dashboards mit dem auf AWS CLI](#lake-dashboard-cli-list)
+ [Hängen Sie eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher oder ein Dashboard mit dem AWS CLI](#lake-dashboard-cli-add-rbp)
+ [Aktualisieren Sie ein Dashboard manuell mit AWS CLI](#lake-dashboard-cli-refresh)
+ [Aktualisieren Sie ein Dashboard mit AWS CLI](#lake-dashboard-cli-update)

## Holen Sie sich ein Dashboard mit AWS CLI
<a name="lake-dashboard-cli-get"></a>

Führen Sie den `get-dashboard` Befehl aus, um ein Dashboard zurückzugeben. Geben Sie das an, `--dashboard-id` indem Sie den Dashboard-ARN oder den Dashboard-Namen angeben.

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

## Listet Dashboards mit dem auf AWS CLI
<a name="lake-dashboard-cli-list"></a>

Führen Sie den `list-dashboards` Befehl aus, um die Dashboards für Ihr Konto aufzulisten.
+ Fügen Sie den `--type` Parameter hinzu, um nur die `CUSTOM` oder `MANAGED` -Dashboards anzuzeigen.
+  Fügen Sie den `--max-results` Parameter hinzu, um die Anzahl der Ergebnisse zu begrenzen. Gültige Werte sind 1—100.
+ Schließen Sie die ein`--name-prefix`, um Dashboards zurückzugeben, die dem angegebenen Präfix entsprechen.

Das folgende Beispiel listet alle Dashboards auf.

```
aws cloudtrail list-dashboards
```

In diesem Beispiel werden nur die `CUSTOM` Dashboards aufgeführt.

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

Im nächsten Beispiel werden nur die `MANAGED` Dashboards aufgeführt.

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

Das letzte Beispiel listet die Dashboards auf, die dem angegebenen Präfix entsprechen.

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

## Hängen Sie eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher oder ein Dashboard mit dem AWS CLI
<a name="lake-dashboard-cli-add-rbp"></a>

Führen Sie den `put-resource-policy` Befehl aus, um eine ressourcenbasierte Richtlinie auf einen Ereignisdatenspeicher oder ein Dashboard anzuwenden.

### Hängen Sie eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher an
<a name="lake-dashboard-cli-add-rbp-eds"></a>

Um während einer manuellen oder geplanten Aktualisierung Abfragen in einem Dashboard auszuführen, müssen Sie jedem Ereignisdatenspeicher, der einem Widget auf dem Dashboard zugeordnet ist, eine ressourcenbasierte Richtlinie anhängen. Dadurch kann CloudTrail Lake die Abfragen in Ihrem Namen ausführen. Weitere Informationen zur ressourcenbasierten Richtlinie finden Sie unter. [Beispiel: Erlauben Sie CloudTrail die Ausführung von Abfragen zur Aktualisierung eines Dashboards](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard)

Im folgenden Beispiel wird eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher angehängt. {{account-id}}Ersetzen Sie es durch Ihre Konto-ID, {{eds-arn}} durch den ARN des Ereignisdatenspeichers, für den Abfragen ausgeführt CloudTrail werden, und {{dashboard-arn}} durch den ARN des Dashboards.

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

### Hängen Sie eine ressourcenbasierte Richtlinie an ein Dashboard an
<a name="lake-dashboard-cli-add-rbp-dashboard"></a>

Um einen Aktualisierungsplan für ein Dashboard festzulegen, müssen Sie eine ressourcenbasierte Richtlinie an das Dashboard anhängen, damit CloudTrail Lake das Dashboard in Ihrem Namen aktualisieren kann. Weitere Informationen zur ressourcenbasierten Richtlinie finden Sie unter. [Beispiel für eine ressourcenbasierte Richtlinie für ein Dashboard](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards)

Im folgenden Beispiel wird eine ressourcenbasierte Richtlinie an ein Dashboard angehängt. {{account-id}}Ersetzen Sie es durch Ihre Konto-ID und {{dashboard-arn}} durch den ARN des Dashboards.

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

## Aktualisieren Sie ein Dashboard manuell mit AWS CLI
<a name="lake-dashboard-cli-refresh"></a>

Führen Sie den `start-dashboard-refresh` Befehl aus, um das Dashboard manuell zu aktualisieren. Bevor Sie diesen Befehl ausführen können, müssen Sie jedem Ereignisdatenspeicher, der [einem Dashboard-Widget zugeordnet ist, eine ressourcenbasierte Richtlinie anhängen](#lake-dashboard-cli-add-rbp-eds).

Das folgende Beispiel zeigt, wie ein benutzerdefiniertes Dashboard manuell aktualisiert wird.

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

Das nächste Beispiel zeigt, wie ein verwaltetes Dashboard manuell aktualisiert wird. Da verwaltete Dashboards von konfiguriert werden CloudTrail, muss die Aktualisierungsanforderung die ID des Ereignisdatenspeichers enthalten, auf dem die Abfragen ausgeführt werden.

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

## Aktualisieren Sie ein Dashboard mit AWS CLI
<a name="lake-dashboard-cli-update"></a>

Führen Sie den `update-dashboard` Befehl aus, um ein Dashboard zu aktualisieren. Sie können das Dashboard aktualisieren, um einen Aktualisierungszeitplan festzulegen, einen Aktualisierungszeitplan zu aktivieren oder zu deaktivieren, die Widgets zu ändern und den Kündigungsschutz zu aktivieren oder zu deaktivieren.

### Aktualisieren Sie den Aktualisierungszeitplan mit AWS CLI
<a name="lake-dashboard-cli-update-schedule"></a>

Im folgenden Beispiel wird der Aktualisierungszeitplan für ein benutzerdefiniertes Dashboard mit dem Namen aktualisiert`AccountActivityDashboard`.

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

### Deaktivieren Sie den Kündigungsschutz und den Aktualisierungszeitplan auf einem benutzerdefinierten Dashboard mit AWS CLI
<a name="lake-dashboard-cli-update-termination-protection"></a>

Im folgenden Beispiel wird der Kündigungsschutz für ein benutzerdefiniertes Dashboard deaktiviert, das so benannt ist`AccountActivityDashboard`, dass das Dashboard gelöscht werden kann. Außerdem wird der Aktualisierungszeitplan deaktiviert.

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

### Fügen Sie einem benutzerdefinierten Dashboard ein Widget hinzu
<a name="lake-dashboard-cli-update-widget"></a>

Im folgenden Beispiel wird dem benutzerdefinierten Dashboard mit `TopServices` dem Namen ein neues Widget hinzugefügt`AccountActivityDashboard`. Das Widgets-Array umfasst die beiden Widgets, die bereits für das Dashboard erstellt wurden, und das neue Widget.

**Anmerkung**  
In diesem Beispiel `?` ist es von einfachen Anführungszeichen umgeben, weil es mit verwendet wird`eventTime`. Abhängig vom Betriebssystem, auf dem Sie arbeiten, müssen Sie einfache Anführungszeichen möglicherweise mit Escape-Anführungszeichen umgeben. Weitere Informationen finden Sie unter [Verwenden von Anführungszeichen und Literalen mit Zeichenfolgen in der 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$"]
    }
  ]'
```