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. # Erstellen, aktualisieren und verwalten Sie Dashboards mit dem AWS CLI In diesem Abschnitt AWS CLI werden die Befehle beschrieben, mit denen Sie Ihre CloudTrail Lake-Dashboards erstellen, aktualisieren und verwalten können. 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. ## Verfügbare Befehle für Dashboards Zu den Befehlen zum Erstellen und Aktualisieren von Dashboards in CloudTrail Lake gehören: + `create-dashboard`um ein benutzerdefiniertes Dashboard zu erstellen oder das Highlights-Dashboard zu aktivieren. + `update-dashboard`um ein benutzerdefiniertes Dashboard oder das Highlights-Dashboard zu aktualisieren. + `delete-dashboard`um ein benutzerdefiniertes Dashboard oder das Highlights-Dashboard zu löschen. + `get-dashboard`gibt Informationen über das angegebene Dashboard zurück. + `list-dashboards`listet alle Dashboards für Ihren AWS-Konto oder für den angegebenen Filter auf. + `start-dashboard-refresh`startet eine Aktualisierung des Dashboards. + `get-resource-policy`ruft die ressourcenbasierte Richtlinie ab, die an das Dashboard angehängt wird. + `put-resource-policy`hängt eine ressourcenbasierte Richtlinie an ein Dashboard an, sodass das Dashboard in Ihrem Namen CloudTrail asynchron aktualisiert werden kann. Sie fügen auch eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher an, sodass Abfragen im Ereignisdatenspeicher ausgeführt werden können CloudTrail , um die Daten für Dashboard-Widgets aufzufüllen. + `delete-resource-policy`entfernt die einem Dashboard zugeordnete ressourcenbasierte Richtlinie. + `add-tags`fügt Tags hinzu, um das Dashboard zu identifizieren. + `remove-tags`entfernt Tags aus einem Dashboard. + `list-tags`listet Tags für ein Dashboard auf. Eine Liste der verfügbaren Befehle für CloudTrail Lake-Ereignisdatenspeicher finden Sie unter[Verfügbare Befehle für Ereignisdatenspeicher](lake-eds-cli.md#lake-eds-cli-commands). Eine Liste der verfügbaren Befehle für CloudTrail Lake-Abfragen finden Sie unter[Verfügbare Befehle für CloudTrail Lake-Abfragen](lake-queries-cli.md#lake-queries-cli-commands). Eine Liste der verfügbaren Befehle für CloudTrail Lake-Integrationen finden Sie unter[Verfügbare Befehle für CloudTrail Lake-Integrationen](lake-integrations-cli.md#lake-integrations-cli-commands). **Themen:** + [Erstellen Sie ein Dashboard mit AWS CLI](lake-dashboard-cli-create.md) + [Verwalten Sie Dashboards mit dem AWS CLI](lake-dashboard-cli-manage.md) + [Löschen Sie ein Dashboard mit AWS CLI](lake-dashboard-cli-delete.md) # Erstellen Sie ein Dashboard mit AWS CLI In diesem Abschnitt wird beschrieben, wie Sie den `create-dashboard` Befehl verwenden, um ein benutzerdefiniertes Dashboard oder das Highlights-Dashboard zu erstellen. 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. CloudTrail führt Abfragen aus, um die Widgets des Dashboards während einer manuellen oder geplanten Aktualisierung zu füllen. CloudTrail muss über Berechtigungen verfügen, um den `StartQuery` Vorgang für jeden Ereignisdatenspeicher auszuführen, der einem Dashboard-Widget zugeordnet ist. Um Berechtigungen bereitzustellen, führen Sie den `put-resource-policy` Befehl aus, um jedem Ereignisdatenspeicher eine ressourcenbasierte Richtlinie anzuhängen, oder bearbeiten Sie die Richtlinie des Ereignisdatenspeichers auf der CloudTrail Konsole. Eine Beispielrichtlinie 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). Um einen Aktualisierungszeitplan festzulegen, CloudTrail müssen Sie über Berechtigungen verfügen, um den `StartDashboardRefresh` Vorgang zur Aktualisierung des Dashboards in Ihrem Namen auszuführen. Um Berechtigungen bereitzustellen, führen Sie den `put-resource-policy` Vorgang aus, um eine ressourcenbasierte Richtlinie an das Dashboard anzuhängen, oder bearbeiten Sie die Dashboard-Richtlinie auf der CloudTrail Konsole. Eine Beispielrichtlinie 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). **Topics** + [Erstellen Sie ein benutzerdefiniertes Dashboard mit AWS CLI](#lake-dashboard-cli-create-custom) + [Aktivieren Sie das Highlights-Dashboard mit AWS CLI](#lake-dashboard-cli-create-highlights) + [Eigenschaften für Widgets anzeigen](lake-widget-properties.md) ## Erstellen Sie ein benutzerdefiniertes Dashboard mit AWS CLI Das folgende Verfahren zeigt, wie Sie ein benutzerdefiniertes Dashboard erstellen, die erforderlichen ressourcenbasierten Richtlinien an Ereignisdatenspeicher und das Dashboard anhängen und das Dashboard aktualisieren, um einen Aktualisierungszeitplan festzulegen und zu aktivieren. 1. Führen Sie den aus`create-dashboard`, um ein Dashboard zu erstellen. Wenn Sie ein benutzerdefiniertes Dashboard erstellen, können Sie ein Array mit bis zu 10 Widgets übergeben. Ein Widget bietet eine grafische Darstellung der Ergebnisse einer Abfrage. Jedes Widget besteht aus `ViewProperties``QueryStatement`, und`QueryParameters`. + `ViewProperties`— Gibt die Eigenschaften für den Ansichtstyp an. Weitere Informationen finden Sie unter [Eigenschaften für Widgets anzeigen](lake-widget-properties.md). + `QueryStatement`— Die Abfrage CloudTrail wird ausgeführt, wenn das Dashboard aktualisiert wird. Sie können Abfragen über mehrere Ereignisdatenspeicher durchführen, sofern die Ereignisdatenspeicher in Ihrem Konto vorhanden sind. + `QueryParameters`— Die folgenden `QueryParameters` Werte werden für benutzerdefinierte Dashboards unterstützt: `$Period$``$StartTime$`, und`$EndTime$`. Um zu verwenden, `QueryParameters` platzieren Sie a `?` an der `QueryStatement` Stelle, an der Sie den Parameter ersetzen möchten. CloudTrail füllt die Parameter aus, wenn die Abfrage ausgeführt wird. Im folgenden Beispiel wird ein Dashboard mit vier Widgets erstellt, eines für jeden Ansichtstyp. **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 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. Erstellen Sie eine separate Datei mit der Ressourcenrichtlinie, die für jeden Ereignisdatenspeicher erforderlich ist, der in einem Widget enthalten ist. `QueryStatement` Benennen Sie die Datei *policy.json* mit dem folgenden Beispiel für eine Richtlinienanweisung: *123456789012*Ersetzen Sie es durch Ihre Konto-ID, *arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard* durch den ARN des Dashboards. Weitere Informationen zu ressourcenbasierten Richtlinien für Dashboards 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) 1. Führen Sie den `put-resource-policy` Befehl aus, um die Richtlinie anzuhängen. Sie können die ressourcenbasierte Richtlinie eines Ereignisdatenspeichers auch auf der CloudTrail Konsole aktualisieren. Im folgenden Beispiel wird eine ressourcenbasierte Richtlinie an einen Ereignisdatenspeicher angehängt. ``` aws cloudtrail put-resource-policy \ --resource-arn eds-arn \ --resource-policy file://policy.json ``` 1. Führen Sie den `put-resource-policy` Befehl aus, um eine ressourcenbasierte Richtlinie an das Dashboard anzuhängen. Eine Beispielrichtlinie 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"}}}]}' ``` 1. Führen Sie den `update-dashboard` Befehl aus, um einen Aktualisierungszeitplan festzulegen und zu aktivieren, indem Sie den `--refresh-schedule` Parameter konfigurieren. Der `--refresh-schedule` besteht aus den folgenden optionalen Parametern: + `Frequency`— Das `Unit` und `Value` für den Zeitplan. Für benutzerdefinierte Dashboards kann die Einheit `HOURS` oder `DAYS` sein. Für benutzerdefinierte Dashboards sind die folgenden Werte gültig, wenn die Einheit`HOURS`:`1`,,, `6` `12` `24` Für benutzerdefinierte Dashboards ist der einzig gültige Wert, wenn die Einheit ist`DAYS`. `1` + `Status`— Gibt an, ob der Aktualisierungszeitplan aktiviert ist. Stellen Sie den Wert auf ein, `ENABLED` um den Aktualisierungszeitplan zu aktivieren oder `DISABLED` um den Aktualisierungszeitplan zu deaktivieren. + `TimeOfDay `— Die Uhrzeit in UTC für die Ausführung des Zeitplans; nur stündlich bezieht sich die Angabe auf Minuten; die Standardeinstellung ist 00:00 Uhr. Im folgenden Beispiel wird ein Aktualisierungszeitplan für alle sechs Stunden festgelegt und der Zeitplan aktiviert. ``` aws cloudtrail update-dashboard --dashboard-id AccountActivityDashboard \ --refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}' ``` ## Aktivieren Sie das Highlights-Dashboard mit AWS CLI Das folgende Verfahren zeigt, wie Sie das Highlights-Dashboard erstellen, die erforderlichen ressourcenbasierten Richtlinien an Ihre Ereignisdatenspeicher und das Dashboard anhängen und das Dashboard aktualisieren, um den Aktualisierungsplan festzulegen und zu aktivieren. 1. Führen Sie den `create-dashboard` Befehl aus, um das Highlights-Dashboard zu erstellen. Um dieses Dashboard zu erstellen, `--name` muss das sein`AWSCloudTrail-Highlights`. ``` aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights ``` 1. Führen Sie für jeden Ereignisdatenspeicher in Ihrem Konto den `put-resource-policy` Befehl aus, um eine ressourcenbasierte Richtlinie an den Ereignisdatenspeicher anzuhängen. Sie können die ressourcenbasierte Richtlinie eines Ereignisdatenspeichers auch auf der Konsole aktualisieren. CloudTrail Eine Beispielrichtlinie 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 Event-Datenspeichers 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"}}} ]}' ``` 1. Führen Sie den `put-resource-policy` Befehl aus, um eine ressourcenbasierte Richtlinie an das Dashboard anzuhängen. Eine Beispielrichtlinie 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"}}}]}' ``` 1. Führen Sie den `update-dashboard` Befehl aus, um einen Aktualisierungszeitplan festzulegen und zu aktivieren, indem Sie den `--refresh-schedule` Parameter konfigurieren. Für das Highlights-Dashboard `UNIT` ist das einzig gültige `HOURS` und das einzig gültige `Value` ist`6`. ``` aws cloudtrail update-dashboard --dashboard-id AWSCloudTrail-Highlights \ --refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}' ``` # Eigenschaften für Widgets anzeigen In diesem Abschnitt werden die konfigurierbaren Ansichtseigenschaften für die vier Ansichtstypen beschrieben: Tabelle, Liniendiagramm, Kreisdiagramm und Balkendiagramm. **Topics** + [Tabelle](#lake-widget-table) + [Liniendiagramm](#lake-widget-linechart) + [Kreisdiagramm](#lake-widget-piechart) + [Balkendiagramm](#lake-widget-barchart) ## Tabelle Das folgende Beispiel zeigt ein Widget, das als Tabelle konfiguriert ist. ``` { "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$"] } ``` In der folgenden Tabelle werden die konfigurierbaren Ansichtseigenschaften für eine Tabelle beschrieben. | Parameter | Erforderlich | Wert | | --- | --- | --- | | `Height` | Ja | Die Höhe der Tabelle in Zoll. | | `Width` | Ja | Die Breite der Tabelle in Zoll. | | `Title` | Ja | Der Titel der Tabelle. | | `View` | Ja | Der Widget-Ansichtstyp. Für eine Tabelle ist der Wert`Table`. | ## Liniendiagramm Das folgende Beispiel zeigt ein Widget, das als Liniendiagramm konfiguriert ist. ``` { "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$"] } ``` In der folgenden Tabelle werden die konfigurierbaren Ansichtseigenschaften für ein Liniendiagramm beschrieben. | Parameter | Erforderlich | Wert | | --- | --- | --- | | `Height` | Ja | Die Höhe des Liniendiagramms in Zoll. | | `Width` | Ja | Die Breite des Liniendiagramms in Zoll. | | `Title` | Ja | Der Titel des Liniendiagramms. | | `View` | Ja | Der Ansichtstyp des Widgets. Für ein Liniendiagramm ist der Wert`LineChart`. | | `YAxisColumn` | Ja | Das Feld aus den Abfrageergebnissen, das Sie für die Y-Achsenspalte verwenden möchten. Beispiel, `eventCount`. | | `XAxisColumn` | Ja | Das Feld aus den Abfrageergebnissen, das Sie für die X-Achsenspalte verwenden möchten. Beispiel, `eventDate`. | | `FilterColumn` | Nein | Das Feld aus den Abfrageergebnissen, nach dem Sie filtern möchten. Beispiel, `readOnly`. | ## Kreisdiagramm Das folgende Beispiel zeigt ein Widget, das als Kreisdiagramm konfiguriert ist. ``` { "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$"] } ``` In der folgenden Tabelle werden konfigurierbare Ansichtseigenschaften für ein Kreisdiagramm beschrieben. | Parameter | Erforderlich | Wert | | --- | --- | --- | | `Height` | Ja | Die Höhe des Kreisdiagramms in Zoll. | | `Width` | Ja | Die Breite des Kreisdiagramms in Zoll. | | `Title` | Ja | Der Titel des Kreisdiagramms. | | `View` | Ja | Der Widget-Ansichtstyp. Für ein Kreisdiagramm ist der Wert`PieChart`. | | `LabelColumn` | Ja | Die Bezeichnung für Segmente im Kreisdiagramm. Beispiel, `awsRegion`. | | `ValueColumn` | Ja | Der Wert für die Segmente im Kreisdiagramm. Beispiel, `ValueColumn`. | | `FilterColumn` | Nein | Das Feld aus den Abfrageergebnissen, nach dem Sie filtern möchten. Beispiel, `awsRegion`. | ## Balkendiagramm Das folgende Beispiel zeigt ein Widget, das als Balkendiagramm konfiguriert ist. ``` { "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$"] } ``` In der folgenden Tabelle werden die konfigurierbaren Ansichtseigenschaften für ein Balkendiagramm beschrieben. | Parameter | Erforderlich | Wert | | --- | --- | --- | | `Height` | Ja | Die Höhe des Balkendiagramms in Zoll. | | `Width` | Ja | Die Breite des Balkendiagramms in Zoll. | | `Title` | Ja | Der Titel des Balkendiagramms. | | `View` | Ja | Der Ansichtstyp des Widgets. Für ein Balkendiagramm ist der Wert`BarChart`. | | `LabelColumn` | Ja | Die Bezeichnung für Balken im Balkendiagramm. Beispiel, `service`. | | `ValueColumn` | Ja | Der Wert für die Balken im Balkendiagramm. Beispiel, `eventCount`. | | `FilterColumn` | Nein | Das Feld aus den Abfrageergebnissen, nach dem Sie filtern möchten. Beispiel, `service`. | | `Orientation` | Nein | Die Ausrichtung des Balkendiagramms, entweder `Horizontal` oder`Vertical`. | # Verwalten Sie Dashboards mit dem AWS CLI 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 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 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 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 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 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 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 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 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 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 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$"] } ]' ``` # Löschen Sie ein Dashboard mit AWS CLI In diesem Abschnitt wird beschrieben, wie Sie den AWS CLI `delete-dashboard` Befehl zum Löschen eines CloudTrail Lake-Dashboards verwenden. Um ein Dashboard zu löschen, geben Sie das an, `--dashboard-id` indem Sie den Dashboard-ARN oder den Dashboard-Namen angeben. ``` aws cloudtrail delete-dashboard --dashboard-id arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash ``` Wenn der Befehl erfolgreich ausgeführt wird, erfolgt keine Reaktion. **Anmerkung** Sie können ein Dashboard nicht löschen, wenn `--termination-protection-enabled` es gesetzt ist.