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, einschließlich öffentlicher Google Cloud-Dienste und mit Cloud Endpoints erstellter privater Dienste, aktivieren oder deaktivieren. 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. Diese Schritte umfassen das Definieren von gcurl, das ein authentifizierter Alias für den Standardbefehl curl ist, und die Umgebungsvariable PROJECT_NUMBER.

Dienste aktivieren

Console

So aktivieren Sie eine API für ein Projekt:

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

2. Wählen Sie das Cloudprojekt aus, in dem Sie eine API aktivieren möchten. Führen Sie dazu einen der folgenden Schritte aus:

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

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

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

3. Klicken Sie auf die API, die Sie aktivieren möchten. Wenn Sie Hilfe bei der Suche nach der API benötigen, verwenden Sie das Feld Nach APIs und Diensten suchen oben auf der Seite. Daraufhin wird eine Seite angezeigt, die die API beschreibt.

4. Klicke 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 der Methode services.enable aktivieren. Mit der Methode services.batchEnable können Sie zwei bis 20 Dienste in einem einzigen Vorgang aktivieren.

Einzelne Dienste aktivieren

Der folgende Befehl aktiviert den Pub/Sub API-Dienst für Ihr Projekt:

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable"

Die Methode services.enable gibt eine Ressource für einen lange laufenden Vorgang zurück, der die laufende Arbeit auf dem Server darstellt. Jeder Vorgang hat einen eindeutigen Ressourcennamen. Hier sehen Sie beispielsweise einen Vorgang mit dem Namen operations/acf.2e2fcfce-8327-4984-9040-a67777082687:

{
  "name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}

Um den Vorgangsstatus mithilfe der Methode operations.get der Service Usage abzufragen, übergeben Sie den Namen des Vorgangs an die API:

OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

Mehrere Dienste gleichzeitig aktivieren

Wenn Sie mehrere API-Dienste für Ihr Projekt aktivieren möchten, können Sie für jeden API-Dienst einen Aktivierungsbefehl ausführen oder einen Batch-Aktivierungsbefehl ausgeben und mehrere APIs angeben. So aktivieren Sie beispielsweise sowohl die Pub/Sub- als auch die Dataflow API-Dienste für Ihr Projekt:

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

Wie services.enable, gibt services.batchEnable eine Vorgangsressource zurück, die Sie über name abfragen.

Hinweis: Die Vorgehensweise zum Aktivieren von APIs kann variieren. Bei einigen APIs werden Sie aufgefordert, deren Nutzungsbedingungen zu akzeptieren, bevor Sie sie aktivieren können. Einige APIs befinden sich im Vorschaumodus und erfordern eine spezielle Anmeldung und Freischaltung, bevor Sie sie verwenden können. Andere APIs benötigen möglicherweise zusätzliche Informationen wie die Kontaktinformationen Ihrer Organisation und den Namen der Anwendung, die Sie entwickeln. Werden solche zusätzlichen Informationen angefordert, werden diese nicht außerhalb von Google weitergegeben. Google analysiert damit, wie die API verwendet wird. Außerdem dienen sie als sekundäre Kontaktdaten, falls wir Sie bezüglich Ihrer Nutzung des Dienstes kontaktieren müssen.

Dienste deaktivieren

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

Hinweis: Wenn Sie mit Version 1 der API versuchen, einen Dienst zu deaktivieren, von dem andere aktivierte Dienste abhängig sind, schlägt der Aufruf fehl. Der API-Aufruf zum Deaktivieren des Dienstes führt zu einer Fehlermeldung. Legen Sie für den Parameter disable_dependent_services in der Anfrage services.disable den Wert true fest, um den jeweiligen Dienst und alle von ihm abhängigen Dienste zu deaktivieren.

Console

So deaktivieren Sie eine API für ein Projekt:

1. Rufen Sie die Seite API-Dashboard der Cloud Console auf.
   Zur Seite "API-Dashboard"

2. Wählen Sie das Cloud-Projekt aus, in dem Sie eine API deaktivieren möchten. Führen Sie dazu einen der folgenden Schritte aus:

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

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

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

3. Klicken Sie auf die API, die Sie deaktivieren möchten. Wenn Sie Hilfe zur Suche nach der API benötigen, verwenden Sie das Feld Nach APIs und Diensten suchen oben auf der Seite. Daraufhin wird eine Seite angezeigt, die die API beschreibt.

4. Klicken Sie auf Verwalten.

5. Klicken Sie 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 für Ihr Projekt:

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable"

Wie services.enable, gibt services.disable eine Vorgangsressource zurück, die Sie über name abfragen.

Tipp

Informationen zum Anzeigen und Verwalten der für Ihr Projekt geltenden Kontingentmesswerte und Limits finden Sie unter Dienstkontingente verwalten.