Dienste aktivieren und deaktivieren

Auf dieser Seite wird beschrieben, wie Sie Dienste für ein Google Cloud-Projekt aktivieren und deaktivieren. Sie können mit Service Usage alle verfügbaren Dienste für Ihre Projekte aktivieren oder deaktivieren, einschließlich öffentlicher Google Cloud-Dienste und privater Dienste, die mit Cloud Endpoints erstellt wurden. Weitere Informationen zu den Unterschieden zwischen öffentlichen und privaten APIs und Diensten finden Sie unter Öffentliche und private Dienste.

Für die meisten betrieblichen Anwendungsfälle ist es am einfachsten, die Dienste mit der Google Cloud Console zu aktivieren und zu deaktivieren. Wenn Sie Skripts erstellen müssen, können Sie auch die gcloud-Befehlszeile verwenden. Wenn Sie Programme unter Verwendung der Service Usage API schreiben müssen, empfehlen wir Ihnen, eine der von uns bereitgestellten Clientbibliotheken zu verwenden. Um die API auszuprobieren, ohne gleich eine komplette Entwicklungsumgebung für Anwendungen einzurichten, können Sie der alternativen Anleitung in diesem Dokument folgen und den curl-Befehl verwenden. Einige der in dieser Anleitung verlinkten Ressourcen stehen ggf. nur auf Englisch zur Verfügung.

Vorbereitung

Um APIs und Dienste zu aktivieren und zu deaktivieren, brauchen Sie Folgendes:

  • Ein Cloud-Projekt. Informationen zum Erstellen eines 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.
  • Wenn Sie die Beispiele für die gcloud-Befehlszeile aus dieser Anleitung ausführen möchten, müssen Sie das Cloud SDK installieren.
  • Wenn Sie die curl-Beispiele in dieser Anleitung verwenden möchten, folgen Sie den Anleitungen für die Ersteinrichtung unter Einstieg.

Dienste aktivieren

Console

So aktivieren Sie eine API für ein Projekt:

  1. Rufen Sie die Seite API-Bibliothek in der Cloud Console auf.
    Weiter zur Seite "API-Bibliothek".
  2. Klicken Sie auf Auswählen, um das Cloud-Projekt auszuwählen.
  3. Klicken Sie auf die API, die Sie aktivieren möchten. Wenn Sie die API nicht finden, können Sie das Suchfeld verwenden.
  4. Klicken Sie auf Aktivieren.

gcloud

Führen Sie den folgenden Befehl aus, um den Pub/Sub API-Dienst in Ihrem aktuellen Projekt zu aktivieren:

gcloud services enable pubsub.googleapis.com

Die Befehlsausgabe sieht in etwa so aus:

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Sie können den folgenden Befehl verwenden, um die Vorgangsdetails abzurufen:

gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687

curl

Sie können einen einzelnen Dienst mit services.enable aktivieren. Mit der Methode services.batchEnable können Sie 2 bis 20 Dienste in einem einzigen Vorgang aktivieren.

Der folgende Befehl aktiviert den Pub/Sub API-Dienst im Projekt mit der Nummer 357084163378:

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:enable

Die Methode services.enable liefert eine Ressource für Vorgänge mit langer Ausführungszeit, mit der Sie den Vorgangsstatus prüfen können. Dieser lässt sich mit der Service Usage-Methode operations.get abfragen.

Der folgende Befehl aktiviert sowohl die Pub/Sub- als auch die Dataflow API-Dienste im Projekt mit der Nummer 357084163378:

gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' https://serviceusage.googleapis.com/v1/projects/357084163378/services:batchEnable

Die Methode services.batchEnable liefert eine Ressource für Vorgänge mit langer Ausführungszeit, mit der Sie den Vorgangsstatus prüfen können. Dieser lässt sich mit der Service Usage-Methode operations.get abfragen.

Dienste deaktivieren

Sie können eine API für ein Projekt jederzeit deaktivieren. Ausstehende Gebühren werden aber noch von Ihrem Konto abgebucht und jede kostenpflichtige API-Nutzung innerhalb Ihrer Projekte wird Ihnen noch in Rechnung gestellt. Weitere Informationen finden Sie unter APIs und Abrechnung.

Console

So deaktivieren Sie eine API für ein Projekt:

  1. Rufen Sie die Seite API-Dashboard in der Cloud Console auf.
    Weiter zur Seite "API-Dashboard".
  2. Klicken Sie auf Auswählen, um das Cloud-Projekt auszuwählen.
  3. Klicken Sie neben der API, die Sie deaktivieren möchten, auf Deaktivieren.

gcloud

Führen Sie den folgenden Befehl aus, um den Pub/Sub API-Dienst für Ihr aktuelles Projekt zu deaktivieren:

gcloud services disable pubsub.googleapis.com

Die Befehlsausgabe sieht in etwa so aus:

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

Sie können den folgenden Befehl verwenden, um die Vorgangsdetails abzurufen:

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

Der folgende Befehl deaktiviert den Pub/Sub API-Dienst im Projekt mit der Nummer 357084163378:

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:disable

Die Methode services.disable gibt eine Ressource für Vorgänge mit langer Ausführungszeit zurück, mit der Sie den Vorgangsstatus prüfen können. Dieser lässt sich mit der Service Usage-Methode operations.get abfragen.