Zugriff auf Personalized Service Health verwalten

In diesem Dokument wird beschrieben, wie Sie Berechtigungen festlegen und den Zugriff aktivieren, damit Sie Folgendes tun können:

• Service Health-Ereignisse über das Service Health-Dashboard aufrufen
• Service Health-Informationen über die Service Health API abrufen
• Benachrichtigungen konfigurieren, die für Ihre Projekte relevant sind

Hinweis

Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

Auf die Service Health API und das Dashboard zugreifen

Personalized Service Health bietet die vordefinierte Rolle servicehealth.viewer, mit der Sie Projektmitgliedern Zugriff gewähren können. Verwenden Sie diese Rolle, um auf die Service Health API und das Dashboard zuzugreifen.

Rollenname	Beschreibung	Berechtigungen für Personalized Service Health
roles/servicehealth.viewer Betrachter von Personalized Service Health	Lesezugriff auf Service Health-Ereignisse.	servicehealth.location.list servicehealth.location.get servicehealth.events.list servicehealth.events.get servicehealth.organizationEvents.list servicehealth.organizationEvents.get servicehealth.organizationImpacts.list servicehealth.organizationImpacts.get

Tipp: Wenn Sie die Berechtigungen für den Zugriff auf Personalized Service Health nach dem Prinzip der geringsten Berechtigung erhalten möchten, bitten Sie Ihren Administrator, Ihnen die roles/servicehealth.viewer (Betrachter von Personalized Service Health) zuzuweisen. Wenn Ihnen bereits eine der grundlegenden Rollen (Betrachter, Bearbeiter oder Inhaber) zugewiesen wurde, haben Sie bereits die Berechtigungen, die für den Zugriff auf Personalized Service Health erforderlich sind.

Sie können die Rollen und Berechtigungen direkt über die gcloud CLI verwenden, um die entsprechenden Zugriffssteuerungen einzurichten. Sie können die Rolle beispielsweise mit dem folgenden Befehl direkt zuweisen:

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member {USER|GROUP|SERVICE_ACCOUNT} \
  --role roles/servicehealth.viewer

Mit dem folgenden Befehl können Sie die IAM-Richtlinie (Identity and Access Management) für das angegebene Projekt aufrufen:

gcloud projects get-iam-policy PROJECT_ID

Alternativ können Sie die Berechtigungen einer vorhandenen Rolle direkt hinzufügen:

gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.events.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.events.get
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.locations.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.locations.get

APIs und Dienste in Ihren Projekten verwenden

1. Aktivieren Sie die Service Health API für das Projekt.
2. Weisen Sie die Rolle „Service Usage-Nutzer“ (roles/serviceusage.serviceUsageConsumer) zu.

Auf Logs zugreifen und Logbenachrichtigungen konfigurieren

Gehen Sie dazu so vor:

1. Aktivieren Sie die Service Health API für das Projekt.
2. Rufen Sie Berechtigungen für logbasierte Benachrichtigungen ab.

Wenn Sie die Rolle „Bearbeiter von Monitoring-Benachrichtigungskanälen“ (roles/monitoring.notificationChannelEditor) nicht zuweisen möchten, können Sie stattdessen die Rolle „Betrachter von Monitoring-Benachrichtigungskanälen“ (roles/monitoring.notificationChannelViewer) zuweisen, damit Sie einen Benachrichtigungskanal mit einer Benachrichtigungsrichtlinie verknüpfen können.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Service Health API für ein einzelnes Projekt aktivieren

Zum Einrichten von Benachrichtigungen und Abrufen von Service Health-Informationen muss die Service Health API aktiviert sein. Sie können die API über die Google Cloud Console oder die Google Cloud CLI aktivieren.

Console

1. Rufen Sie in der Bibliothek „APIs und Dienste“ die Service Health API auf.

   Zur Service Health API

   Alternativ können Sie die API-Bibliothek aufrufen und nach "Service Health API" suchen.

2. Wählen Sie das Projekt aus.

3. Wählen Sie die Schaltfläche Aktivieren aus.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

2. Prüfen Sie, ob die neueste Version der Google Cloud CLI installiert ist. Führen Sie den folgenden Befehl in der Cloud Shell aus:

     gcloud components update

3. Erstellen oder wählen Sie ein neues Projekt aus, PROJECT_ID.

   • Google Cloud Projekt erstellen:

     gcloud projects create PROJECT_ID

   • Wählen Sie das Google Cloud erstellte Projekt aus:

     gcloud projects config set project PROJECT_ID

4. Aktivieren Sie die Service Health API in dem gerade erstellten Projekt.

   gcloud services enable servicehealth.googleapis.com \
    --project PROJECT_ID
   

Skript

Sie können ein Skript verwenden, um die Service Health API für Projekte in Ihrer Organisation oder Ihrem Ordner zu aktivieren.

Hintergrundinformationen finden Sie unter API im Google Cloud Projekt aktivieren.

Die Service Health API und Benachrichtigungen erkennen neue Ereignisse einige Stunden nach der Aktivierung der API.