Dienstabhängigkeiten auflisten

Mit der hierarchischen Dienstaktivierung können Sie die Dienstaktivierung verwalten, die über die Google Cloud Ressourcenhierarchie übernommen wird. Weitere Informationen finden Sie in der Übersicht.

Viele Google Cloud Dienste benötigen andere Dienste, um zu funktionieren. Wenn Sie einen Dienst mithilfe der hierarchischen Dienstaktivierung aktivieren, werden die erforderlichen Abhängigkeiten automatisch der ConsumerPolicy hinzugefügt. Eine Dienstabhängigkeitsgruppe enthält diese abhängigen Dienste, die Sie auflisten können, um sie besser zu verstehen und zu verwalten.

In diesem Dokument wird beschrieben, wie Sie mit der Google Cloud CLI Dienstabhängigkeiten für Projekte, Ordner und Organisationen auflisten.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. Installieren Sie die Google Cloud CLI.

  3. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  4. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  5. Google Cloud Projekt erstellen oder auswählen

    Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Informationen zum Zuweisen von Rollen

    • So erstellen Sie ein Google Cloud Projekt:

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud Projekt, das Sie erstellen.

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

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

  6. Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.

  7. Installieren Sie die Google Cloud CLI.

  8. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  9. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  10. Google Cloud Projekt erstellen oder auswählen

    Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Informationen zum Zuweisen von Rollen

    • So erstellen Sie ein Google Cloud Projekt:

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud Projekt, das Sie erstellen.

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

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

  11. Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.

  12. Wenn Sie die Google Cloud Ressource, die Sie verwalten möchten, nicht angeben, werden die Befehle in diesem Dokument standardmäßig auf das aktuelle Projekt angewendet. Mit gcloud beta services groups list-members bigquery.googleapis.com dependencies werden beispielsweise die Mitglieder für das aktuelle Projekt aufgeführt.

    Sie können die aktuelle Projekt-ID abrufen:

    gcloud config list --format='text(core.project)'

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Service Usage Viewer (roles/serviceusage.serviceUsageViewer) für Ihre Zielressource zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Auflisten von Dienstabhängigkeiten benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Auflisten von Dienstabhängigkeiten erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Dienstabhängigkeiten aufzulisten:

  • Mitglieder der Abhängigkeitsgruppe auflisten: serviceusage.groups.listMembers
  • Erweiterte Mitglieder der Abhängigkeitsgruppe auflisten: serviceusage.groups.listExpandedMembers

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Mitglieder der Abhängigkeitsgruppe auflisten

Sie können die direkten Mitglieder einer Dienstabhängigkeitsgruppe für ein Projekt, einen Ordner oder eine Organisation mit dem Befehl gcloud beta services groups list-members auflisten:

gcloud beta services groups list-members SERVICE GROUP \
    --RESOURCE_TYPE=RESOURCE_ID

Ersetzen Sie Folgendes:

  • SERVICE: der Name des Dienstes, für den Sie Mitglieder auflisten möchten.

  • GROUP: Der Name der Dienstabhängigkeitsgruppe, für die Sie die Mitglieder auflisten möchten. Die primär unterstützte Gruppe ist dependencies.

  • RESOURCE_TYPE: Der Typ der Ressource, für die Sie Mitglieder auflisten möchten. Gültige Werte sind project, folder und organization. Sie können dieses Flag auch weglassen, um Ergebnisse für das aktuelle Projekt zurückzugeben.

  • RESOURCE_ID: die Projekt-ID, Ordner-ID oder Organisations-ID, je nach dem Wert, den Sie für RESOURCE_TYPE verwendet haben.

Sie können andere Flags verwenden, um die aufgeführten Mitglieder zu filtern und zu begrenzen.

Maximierte Mitglieder der Abhängigkeitsgruppe auflisten

Sie können die erweiterten Mitglieder einer Dienstabhängigkeitsgruppe für ein Projekt, einen Ordner oder eine Organisation mit dem Befehl gcloud beta services groups list-expanded-members auflisten.

Dieser Befehl gibt eine vereinfachte Liste aller Abhängigkeiten zurück, einschließlich derer in verschachtelten Gruppen, um eine vollständige, kombinierte Liste aller Dienstabhängigkeiten zu erhalten.

gcloud beta services groups list-expanded-members SERVICE GROUP \
    --RESOURCE_TYPE=RESOURCE_ID

Ersetzen Sie Folgendes:

  • SERVICE: der Name des Dienstes, für den Sie Mitglieder auflisten möchten.

  • GROUP: Der Name der Dienstabhängigkeitsgruppe, für die Sie die Mitglieder auflisten möchten. Die primär unterstützte Gruppe ist dependencies.

  • RESOURCE_TYPE: Der Typ der Ressource, für die Sie Mitglieder auflisten möchten. Gültige Werte sind project, folder und organization. Sie können dieses Flag auch weglassen, um Ergebnisse für das aktuelle Projekt zurückzugeben.

  • RESOURCE_ID: die Projekt-ID, Ordner-ID oder Organisations-ID, je nach dem Wert, den Sie für RESOURCE_TYPE verwendet haben.

Sie können andere Flags verwenden, um die aufgeführten Mitglieder zu filtern und zu begrenzen.

Beispiele

Mitglieder der Gruppe für direkte Abhängigkeiten auflisten

  • Direkte Abhängigkeiten des BigQuery-Dienstes für das aktuelle Projekt auflisten: 
    gcloud beta services groups list-members bigquery.googleapis.com dependencies

    Ausgabe:

    NAME: services/analyticshub.googleapis.com
REASON: BigQuery depends on this group to allow users to exchange data and analytics assets.

NAME: services/bigquery.googleapis.com
REASON: The service representing BigQuery which owns this dependency group and depends on the other members of this group.

NAME: services/bigqueryconnection.googleapis.com
REASON: BigQuery depends on this group to allow users to manage connections to external data sources.

NAME: services/bigquerydatapolicy.googleapis.com
REASON: BigQuery depends on this group to allow users to manage their data policies.

...
  • Versuch, Abhängigkeiten des API-Schlüssel-Dienstes ohne entsprechende Dienstabhängigkeitsgruppe aufzulisten: 
    gcloud beta services groups list-members apikeys.googleapis.com dependencies --project=test-project

    Ausgabe:

    Listed 0 items.

Mitglieder der erweiterten Abhängigkeitsgruppe auflisten

  • Erweiterte Abhängigkeiten des BigQuery-Dienstes für das aktuelle Projekt auflisten: 
    gcloud beta services groups list-expanded-members bigquery.googleapis.com dependencies

    Ausgabe:

    services/analyticshub.googleapis.com
services/bigquery.googleapis.com
services/bigqueryconnection.googleapis.com
services/bigquerydatapolicy.googleapis.com
services/bigquerydatatransfer.googleapis.com
services/bigquerymigration.googleapis.com
services/bigqueryreservation.googleapis.com
services/bigquerystorage.googleapis.com
services/cloudresourcemanager.googleapis.com
services/dataform.googleapis.com
services/dataplex.googleapis.com

Nächste Schritte