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.
Verwenden Sie API-Schlüssel, um sich mit Grafana-HTTP-APIs zu authentifizieren
Eine Möglichkeit, auf Grafana-APIs zuzugreifen, besteht darin, einen API-Schlüssel zu verwenden, der auch als API-Token bezeichnet wird. Verwenden Sie eines der folgenden Verfahren, um einen API-Schlüssel zu erstellen. Ein API-Schlüssel ist für eine begrenzte Zeit gültig, die Sie bei der Erstellung angeben, bis zu 30 Tage.
Themen
Wichtig
API-Schlüssel sind veraltet und wurden in Amazon Managed Grafana-Version 12 entfernt. Verwenden Sie stattdessen Dienstkonten. Weitere Informationen finden Sie unter Verwenden Sie Dienstkonten, um sich mit den Grafana-HTTP-APIs zu authentifizieren.
Wenn Sie einen API-Schlüssel erstellen, geben Sie eine Rolle für den Schlüssel an. Die Rolle bestimmt die Ebene der Verwaltungsbefugnisse, die Benutzer des Schlüssels haben.
Die folgenden Tabellen zeigen die Berechtigungen, die den Rollen Admin, Editor und Viewer gewährt wurden. Die erste Tabelle zeigt allgemeine organisatorische Berechtigungen. In dieser Tabelle steht „Vollständig“ für die Möglichkeit, Berechtigungen einzusehen, zu bearbeiten, hinzuzufügen und zu löschen. In der Spalte Erkunden wird angezeigt, ob die Rolle die Explore-Ansicht verwenden kann. In der Spalte „Andere Berechtigungen“ wird angezeigt, ob die Rolle über Berechtigungen für die Verwaltung von Benutzern, Teams, Plug-ins und Organisationseinstellungen verfügt.
| Rolle | Dashboards | Playlisten | Ordner | Erkunden | Datenquellen | Andere Berechtigungen |
|---|---|---|---|---|---|---|
|
Betrachter |
Anzeigen | Anzeigen | Nein | Nein | Nein | Nein |
|
Editor (Editor) |
Voll | Voll | Voll | Ja | Nein | Nein |
|
Admin. |
Voll | Voll | Voll | Ja | Voll | Voll |
Die folgende Tabelle zeigt die zusätzlichen Berechtigungen auf Dashboard- und Ordnerebene, die Sie festlegen können. Diese unterscheiden sich von den Rollen Admin, Editor und Viewer.
| Rolle | Dashboards | Ordner | Berechtigungen ändern |
|---|---|---|---|
|
Anzeigen |
Anzeigen | Anzeigen | Nein |
|
Edit (Bearbeiten) |
Erstellen, bearbeiten | Anzeigen | Nein |
|
Admin. |
Erstellen, bearbeiten, löschen | Erstellen, bearbeiten, löschen | Ja |
Anmerkung
Eine umfassendere Berechtigung mit einer niedrigeren Berechtigungsstufe hat keine Wirkung, wenn eine allgemeinere Regel mit mehr Berechtigungen existiert. Wenn Sie beispielsweise einem Benutzer die organisatorische Editor-Rolle zuweisen und diesem Benutzer dann nur die Anzeigeberechtigungen für ein Dashboard zuweisen, hat die restriktivere Anzeigeberechtigung keine Wirkung, da der Benutzer aufgrund seiner Editor-Rolle vollen Bearbeitungszugriff hat.
Erstellen eines Grafana-API-Schlüssels zur Verwendung mit Grafana-APIs im Arbeitsbereich (Konsole)
Anmerkung
In Amazon Managed Grafana-Arbeitsbereichen, die mit Grafana-Version 10 und höher kompatibel sind, wurde die Möglichkeit, API-Schlüssel im Workspace zu erstellen, entfernt. Wenn es sich bei Ihrem Workspace um einen Grafana-Arbeitsbereich der Version 10 handelt, können Sie API-Schlüssel nur über die AWS CLI oder API erstellen.
API-Schlüssel sind veraltet und wurden in Amazon Managed Grafana-Version 12 entfernt. Verwenden Sie stattdessen Dienstkonten. Weitere Informationen finden Sie unter Verwenden Sie Dienstkonten, um sich mit den Grafana-HTTP-APIs zu authentifizieren.
Um einen Grafana-API-Schlüssel zur Verwendung mit Grafana-APIs in der Workspace-Konsole zu erstellen
-
Öffnen Sie die Amazon Managed Grafana-Konsole unter. https://console.aws.amazon.com/grafana/
-
Wählen Sie in der oberen linken Ecke der Seite das Menüsymbol und dann Alle Workspaces.
-
Wählen Sie den Namen des Amazon Managed Grafana-Arbeitsbereichs.
-
Wählen Sie auf der Seite mit den Workspace-Details die URL aus, die unter Grafana-Workspace-URL angezeigt wird.
-
Halten Sie im Seitenmenü der Grafana-Konsole eine Pause auf das Konfigurationssymbol (Zahnrad) und wählen Sie dann API-Schlüssel aus.
-
Wählen Sie Neuer API-Schlüssel.
-
Geben Sie einen eindeutigen Namen für den Schlüssel ein.
-
Wählen Sie für Rolle die Zugriffsebene aus, der der Schlüssel gewährt werden soll. Wählen Sie Admin aus, um einem Benutzer mit diesem Schlüssel die Verwendung von APIs auf der umfassendsten und leistungsfähigsten Verwaltungsebene zu ermöglichen. Wählen Sie Editor oder Viewer, um die Benutzer des Schlüssels auf diese Leistungsstufen zu beschränken. Weitere Informationen finden Sie in den vorherigen Tabellen.
-
Geben Sie unter Gültigkeitsdauer an, wie lange der Schlüssel gültig sein soll. Das Maximum ist 30 Tage (ein Monat). Sie geben eine Zahl und einen Buchstaben ein. Die gültigen Buchstaben sind s für Sekunden, m für Minuten, h für Stunden, d für Tage, w für Wochen und M für Monat. 12h steht beispielsweise für 12 Stunden und 1M für 1 Monat (30 Tage).
Es wird dringend empfohlen, die Lebensdauer des Schlüssels auf einen kürzeren Zeitraum festzulegen, z. B. auf ein paar Stunden oder weniger. Dies birgt ein viel geringeres Risiko als API-Schlüssel, die für eine lange Zeit gültig sind.
-
Wählen Sie Hinzufügen aus.
-
(Optional) Sie können die Erstellung von API-Schlüsseln mit der Create API Key API mithilfe von Terraform automatisieren. Weitere Informationen zur Automatisierung der API-Schlüsselerstellung mit Terraform finden Sie unter Erstellen eines Grafana-API-Schlüssels mit Terraform. https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/
Erstellen eines Amazon Managed Grafana-Workspace-API-Schlüssels mit AWS CLI
Um einen Amazon Managed Grafana-Workspace-API-Schlüssel zu erstellen, verwenden Sie AWS CLI
Ersetzen Sie im folgenden Beispiel das key_namekey_role, seconds_to_live und workspace_id durch Ihre eigenen Informationen. Informationen zum Format von Schlüsselnamen, Schlüsselrolle und Seconds-to-Live finden Sie im API-Handbuch. https://docs.aws.amazon.com/grafana/latest/APIReference/API_CreateWorkspaceApiKey.html
aws grafana create-workspace-api-key --key-name "key_name" --key-role "key_role" --seconds-to-liveseconds_to_live--workspace-id "workspace_id"
Im Folgenden finden Sie ein Beispiel für eine CLI-Antwort:
Sie können den Ihres Workspace finden, indem Sie workspace_id den folgenden Befehl ausführen:
aws grafana list-workspaces
