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 über die Google Cloud Console zu aktivieren und zu deaktivieren. Wenn Sie Skripts erstellen müssen, können Sie auch die Google Cloud-Befehlszeile verwenden. Wenn Sie Programme unter Verwendung der Service Usage API schreiben müssen, empfehlen wir Ihnen, eine unserer bereitgestellten Clientbibliotheken zu verwenden. Wenn Sie mit der API experimentieren möchten, können Sie den alternativen Anleitungen in diesem Leitfaden folgen und den Befehl curl
verwenden, um die API zu testen, ohne eine vollständige Anwendungsentwicklungsumgebung einzurichten.
Hinweis
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.
- Installieren Sie die Google Cloud-Befehlszeile.
- 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 vongcurl
, einem authentifizierten Alias für den Standardbefehlcurl
, und die Definition der UmgebungsvariablenPROJECT_NUMBER
.
Dienste aktivieren
Console
So aktivieren Sie eine API für ein Projekt:
- Rufen Sie in der Console die Seite API-Bibliothek auf.
Zur Seite "API-Bibliothek" Wählen Sie das Cloud-Projekt, 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 folgende Schritte zur Verwendung des Cloud-Projektbrowsers aus:
- Klicken Sie auf Projekt auswählen, um den Cloud-Projektbrowser zu öffnen.
- Lokalisieren Sie Ihr Projekt und klicken Sie auf den Namen des Cloud-Projekts.
- Klicken Sie auf Öffnen, um das Projekt zu öffnen.
Klicken Sie auf die API, die Sie aktivieren möchten. Wenn Sie die API nicht finden, können Sie das Feld Nach APIs und Diensten suchen oben auf der Seite verwenden. Es wird eine Seite mit der Beschreibung der API angezeigt.
Klicken Sie auf die Schaltfläche 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.
Eiinen enzelnen Dienst 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 Vorgänge mit langer Ausführungszeit zurück, die 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 mit der Service Usage-Methode operations.get
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 in Ihrem Projekt mehrere API-Dienste aktivieren möchten, können Sie pro API-Dienst einen Aktivierungsbefehl ausführen oder einen Batch-Aktivierungsbefehl ausgeben und dabei 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 mit ihrer name
abfragen können.
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.
Konsole
So deaktivieren Sie eine API für ein Projekt:
- Rufe in der Console die Seite API-Dashboard auf.
Zur Seite „API-Dashboard“ Wählen Sie das Cloud-Projekt, 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 folgende Schritte zur Verwendung des Cloud-Projektbrowsers aus:
- Klicken Sie auf Projekt auswählen, um den Cloud-Projektbrowser zu öffnen.
- Lokalisieren Sie Ihr Projekt und klicken Sie auf den Namen des Cloud-Projekts.
- Klicken Sie auf Öffnen, um das Projekt zu öffnen.
Klicken Sie auf die API, die Sie deaktivieren möchten. Wenn Sie die API nicht finden, können Sie das Feld Nach APIs und Diensten suchen oben auf der Seite verwenden. Es wird eine Seite mit der Beschreibung der API angezeigt.
Klicke auf stop API 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 in Ihrem 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 mit deren name
abfragen können.
Weitere Informationen
Informationen zum Aufrufen und Verwalten der Kontingentmesswerte und -limits, die für Ihr Projekt gelten, finden Sie unter Dienstkontingente verwalten.