Dienste auflisten

In diesem Dokument wird beschrieben, wie Sie die APIs und Dienste auflisten, die in einem Google Cloud-Projekt aktiviert oder verfügbar sind. Die Liste der verfügbaren oder aktivierten APIs und Dienste kann sowohl öffentliche Google Cloud-Dienste wie Pub/Sub als auch alle privat mit Ihnen freigegebenen APIs und Dienste enthalten, z. B. Dienste, die mit Cloud-Endpunkten erstellt wurden. Weitere Informationen zu den Unterschieden zwischen öffentlichen und privaten APIs und Diensten finden Sie unter Öffentliche und private Dienste.

  • Informationen zum Abrufen oder Überwachen der aktivierten Dienste für eine Organisation finden Sie unter Aktivierte Dienste in einer Organisation auflisten.
  • Wir empfehlen, die Google Cloud Console oder die Google Cloud CLI zu verwenden, um Dienste in einem Projekt aufzulisten. In diesem Dokument wird beschrieben, wie Sie beide Oberflächen verwenden.
  • Für die Programmierung unter Einbindung der Service Usage API empfehlen wir eine unserer verfügbaren Clientbibliotheken.
  • Wenn Sie die API testen möchten, empfehlen wir den Befehl curl. Sie müssen keine vollständige Anwendungsumgebung einrichten. Es sind jedoch einige Schritte erforderlich.

Hinweise

Um die aktivierten und verfügbaren APIs und Dienste aufzulisten, brauchen Sie Folgendes:

  • Ein Google Cloud-Projekt. Informationen zum Erstellen eines Google Cloud-Projekts finden Sie unter Projekte erstellen und verwalten.
  • Die richtigen IAM-Berechtigungen (Identity and Access Management). Informationen zu den IAM-Anforderungen für Service Usage finden Sie unter Zugriffssteuerung.
  • Installieren Sie die Google Cloud CLI.
  • Wenn Sie die curl-Beispiele in dieser Anleitung verwenden möchten, folgen Sie den Anleitungen für die Ersteinrichtung unter Einstieg. Diese Schritte umfassen die Definition von gcurl, einem authentifizierten Alias für den Standardbefehl curl, und die Definition der Umgebungsvariablen PROJECT_NUMBER.

Aktivierte Dienste in einer Organisation auflisten

Mit Cloud Asset Inventory können Sie eine Liste der Dienste aufrufen, die in einer Organisation aktiviert sind. So lässt sich der Status aller Projekte, die von einer Organisation verwaltet werden, in einem einzigen RPC-Aufruf exportieren. Mit Cloud Asset Inventory können Sie auch Statusänderungen beobachten. Wenn Sie alle aktivierten Dienste für eine bestimmte Organisation exportieren möchten, folgen Sie der Anleitung zum Auflisten von Assets in der Cloud Asset Inventory-Dokumentation.

Wenn Sie die aktivierten APIs für eine Organisation auflisten möchten, führen Sie den folgenden Befehl aus, nachdem Sie die IDs Ihrer Organisation und Ihres Abrechnungsprojekts festgelegt haben:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--organization='ORGANIZATION_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

Wenn ein Nutzer mit ausreichenden Berechtigungen den vorherigen Befehl ausführt, kann er die Liste der aktivierten Dienste für alle Projekte in einer Organisation aufrufen.

Wenn Sie mit Cloud Asset Inventory-Befehlen experimentieren möchten, wenden Sie diese auf ein bestimmtes Projekt an. Mit dem folgenden Befehl werden beispielsweise alle aktivierten Dienste für ein bestimmtes Projekt aufgelistet:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--project='PROJECT_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

Aktivierte Dienste in einem Projekt auflisten

Für die Auflistung aktivierter Dienste wird das Kontingent aus dem Messwert serviceusage.googleapis.com/list_enabled_requests verwendet. Das standardmäßig verfügbare Kontingent beträgt 10 Abfragen pro Sekunde (QPS).

Console

So listen Sie die aktivierten APIs und Dienste in einem Projekt auf:

  1. Rufen Sie in der Google Cloud Console die Seite API-Dashboard auf.
    Weiter zur Seite „API-Dashboard“

  2. Wählen Sie Ihr Google Cloud-Projekt aus. Führen Sie dazu einen der folgenden Schritte aus:

    • Klicken Sie unter Aktuelles Projekt auswählen auf ein Google Cloud-Projekt.

    • Führen Sie die folgenden Schritte aus, um den Google Cloud-Projektbrowser zu verwenden:

      1. Klicken Sie auf Projekt auswählen, um den Google Cloud-Projektbrowser zu öffnen.
      2. Suchen Sie Ihr Projekt und klicken Sie auf den Namen des Google Cloud-Projekts.
      3. Klicken Sie auf Öffnen, um das Projekt zu öffnen.

    Die Seite APIs & Dienste wird angezeigt. Eine Liste der in Ihrem Google Cloud-Projekt aktivierten APIs finden Sie in der Tabelle auf dieser Seite.

gcloud

Führen Sie den folgenden Befehl aus, um die aktivierten APIs und Dienste in Ihrem aktuellen Projekt aufzulisten:

gcloud services list

Die Befehlsausgabe sieht in etwa wie folgt aus:

NAME                                              TITLE
pubsub.googleapis.com             Google Cloud Pub/Sub API
bigquery.googleapis.com           BigQuery API
cloudtrace.googleapis.com         Stackdriver Trace API
servicemanagement.googleapis.com  Google Service Management API
monitoring.googleapis.com         Stackdriver Monitoring API
storage-api.googleapis.com        Google Cloud Storage JSON API
logging.googleapis.com            Stackdriver Logging API
clouddebugger.googleapis.com      Stackdriver Debugger API
...

curl

Rufen Sie die Methode services.list mit dem Filter state:ENABLED auf, um aktivierte Dienste aufzulisten.

Führen Sie den folgenden Befehl aus, um die aktivierten APIs und Dienste in Ihrem Projekt aufzulisten:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"

Verfügbare Dienste in einem Projekt auflisten

Wenn Sie alle verfügbaren Dienste auflisten, wird das Kontingent aus dem serviceusage.googleapis.com/list_available_requests-Kontingent verwendet. Das standardmäßig verfügbare Kontingent beträgt 1 QPS. Die verfügbaren Dienste ändern sich selten und können über einen längeren Zeitraum im Cache gespeichert werden.

Console

So listen Sie die APIs und Dienste auf, die Ihnen in einem Projekt zur Verfügung stehen:

  1. Rufen Sie in der Google Cloud Console die Seite API-Bibliothek auf.
    Zur Seite "API-Bibliothek"

  2. Wählen Sie Ihr Google Cloud-Projekt aus. Führen Sie dazu einen der folgenden Schritte aus:

    • Klicken Sie unter Aktuelles Projekt auswählen auf ein Google Cloud-Projekt.

    • Führen Sie die folgenden Schritte aus, um den Google Cloud-Projektbrowser zu verwenden:

      1. Klicken Sie auf Projekt auswählen, um den Google Cloud-Projektbrowser zu öffnen.
      2. Suchen Sie Ihr Projekt und klicken Sie auf den Namen des Google Cloud-Projekts.
      3. Klicken Sie auf Öffnen, um das Projekt zu öffnen.

    Der Bildschirm API-Bibliothek wird angezeigt. Auf diesem Bildschirm können Sie nach verfügbaren APIs suchen oder scrollen.

gcloud

Führen Sie den folgenden Befehl aus, um die APIs und Dienste aufzulisten, die Ihnen in Ihrem aktuellen Projekt zur Verfügung stehen:

gcloud services list --available

Die Ergebnisse umfassen alle Dienste, die bereits aktiviert wurden, sowie Dienste, die für das aktuelle Projekt aktiviert werden können. Die Befehlsausgabe sieht in etwa wie folgt aus:

NAME                                              TITLE
places-backend.googleapis.com                  Google Places API Web Service
clouderrorreporting.googleapis.com             Stackdriver Error Reporting API
analyticsreporting.googleapis.com              Google Analytics Reporting API
youtube.googleapis.com                         YouTube Data API v3
adsense.googleapis.com                         AdSense Management API
sqladmin.googleapis.com                        Google Cloud SQL API
genomics.googleapis.com                        Genomics API
adexchangebuyer.googleapis.com                 Ad Exchange Buyer API II
...

curl

Rufen Sie die Methode services.list auf, um verfügbare Dienste aufzulisten.

Führen Sie den folgenden Befehl aus, um die verfügbaren APIs und Dienste in Ihrem Projekt aufzulisten:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"

Das Ergebnis umfasst alle öffentlichen Dienste, für die der aufrufende Nutzer die Berechtigung servicemanagement.services.bind hat, und alle Dienste, die für das Projekt bereits aktiviert wurden.

Du kannst die derzeit im Projekt aktiven Dienste ausschließen, indem du filter=state:DISABLED an den vorherigen Aufruf übergibst.

Nächste Schritte

Informationen zum Aktivieren oder Deaktivieren von Diensten in Ihrem Google Cloud-Projekt finden Sie unter Dienste aktivieren und deaktivieren.