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 mit hierarchischer Dienstaktivierung aktivieren, werden die erforderlichen Abhängigkeiten automatisch dem ConsumerPolicy hinzugefügt. Eine Dienstabhängigkeitsgruppe enthält diese 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 „Project Creator“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Informationen zum Zuweisen von Rollen

    • Erstellen Sie ein Projekt in Google Cloud :

      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 Projekt Google Cloud aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

  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 „Project Creator“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Informationen zum Zuweisen von Rollen

    • Erstellen Sie ein Projekt in Google Cloud :

      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 Projekt Google Cloud aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

  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 aufgelistet.

    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-Betrachter (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:

  • Listen Sie die Mitglieder der Abhängigkeitsgruppe auf: 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 Mitglieder auflisten möchten. Die primäre unterstützte Gruppe ist dependencies.

  • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Mitglieder auflisten möchten. Gültige Werte sind project, folder und organization. Sie können dieses Flag ganz 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 aufgelisteten Mitglieder zu filtern und einzuschränken.

Mitglieder der maximierten Abhängigkeitsgruppe auflisten

Mit dem Befehl gcloud beta services groups list-expanded-members können Sie die erweiterten Mitglieder einer Dienstabhängigkeitsgruppe für ein Projekt, einen Ordner oder eine Organisation 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 bereitzustellen.

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 Mitglieder auflisten möchten. Die primäre unterstützte Gruppe ist dependencies.

  • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Mitglieder auflisten möchten. Gültige Werte sind project, folder und organization. Sie können dieses Flag ganz 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 aufgelisteten Mitglieder zu filtern und einzuschränken.

Beispiele

Mitglieder der Gruppe mit direkten 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üsseldienstes ohne entsprechende Dienstabhängigkeitsgruppe aufzulisten: 
    gcloud beta services groups list-members apikeys.googleapis.com dependencies --project=test-project

    Ausgabe:

    Listed 0 items.

Maximierte Mitglieder der Abhängigkeitsgruppe werden aufgelistet

  • 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