Dienste aktivieren und deaktivieren

Mit Service Usage können Sie alle verfügbaren Dienste für Ihre Google Cloud Projekte aktivieren oder deaktivieren. Dazu gehören öffentliche Google Cloud -Dienste und private Dienste, die mit Cloud Endpoints erstellt wurden. Weitere Informationen zu den Unterschieden zwischen öffentlichen und privaten Diensten finden Sie unter Öffentliche und private Dienste.

Die meisten Nutzer können Dienste mit der Google Cloud Console aktivieren und deaktivieren. Verwenden Sie für Skripts die Google Cloud CLI. Für den programmatischen Zugriff auf die Service Usage API empfehlen wir die Verwendung einer Clientbibliothek. Sie können die API ausprobieren, indem Sie eine Anfrage senden, ohne eine vollständige Entwicklungsumgebung einzurichten.

Informationen zu Kontingentlimits für die Dienstnutzung finden Sie unter Kontingente und Limits. Es kann sinnvoll sein, die kostenpflichtige Nutzung zu beschränken. Je nach API können Sie Anfragen explizit begrenzen.

Hinweis

Bevor Sie Dienste aktivieren und deaktivieren können, müssen Sie IhrGoogle Cloud -Projekt und Ihre Umgebung für Service Usage einrichten.

Console

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Service Usage API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Service Usage API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    10.

gcloud

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie 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. Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

    Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

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

    • So erstellen Sie ein Google Cloud -Projekt:

      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 Google Cloud Projekt 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. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

  8. Aktivieren Sie die Service Usage API:

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen 

    gcloud services enable serviceusage.googleapis.com

  9. Installieren Sie die Google Cloud CLI.

  10. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  11. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  12. Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

    Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

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

    • So erstellen Sie ein Google Cloud -Projekt:

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

      gcloud config set project PROJECT_ID

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

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

  14. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

  15. Aktivieren Sie die Service Usage API:

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen 

    gcloud services enable serviceusage.googleapis.com
    16.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Service Usage Admin (roles/serviceusage.serviceUsageAdmin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktivieren und Deaktivieren von Diensten benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Dienst aktivieren

Das Verfahren zum Aktivieren eines Dienstes kann variieren. Bei einigen APIs werden Sie aufgefordert, zuerst deren Nutzungsbedingungen zu akzeptieren. Andere APIs befinden sich in der Vorschauphase und erfordern eine Genehmigung, bevor Sie sie verwenden können. Andere APIs benötigen möglicherweise zusätzliche Informationen wie die Kontaktdaten Ihrer Organisation und den Namen Ihrer Anwendung. Alle angeforderten Informationen werden bei Google vertraulich behandelt. Wir verwenden sie, um die API-Nutzung nachzuvollziehen und Sie bei Bedarf zu kontaktieren.

Console

  1. Rufen Sie in der Google Cloud Console die Seite APIs & Dienste > API-Bibliothek auf.

    Zur API-Bibliothek

  2. Wählen Sie ein aktuelles Projekt aus oder verwenden Sie die Ressourcenauswahl in der Symbolleiste der Console, um das Google Cloud -Projekt auszuwählen, für das Sie eine API aktivieren möchten.

  3. Klicken Sie auf die API, die Sie aktivieren möchten, oder suchen Sie im Feld Nach APIs und Diensten suchen danach.

  4. Klicken Sie auf Aktivieren.

gcloud

Mit dem Befehl gcloud services enable wird ein Dienst mit dem für das aktuelle Projekt angegebenen Namen aktiviert.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • SERVICE: der Name des Dienstes, den Sie aktivieren möchten.

Führen Sie den Befehl gcloud services enable aus:

Linux, macOS oder Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

Sie sollten eine Antwort ähnlich der folgenden erhalten:


Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Wenn Sie mehrere Dienste aktivieren möchten, verwenden Sie durch Leerzeichen getrennte Dienstnamen. Mit dem folgenden Befehl werden beispielsweise sowohl der BigQuery- als auch der Pub/Sub-Dienst aktiviert:

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

Mit dem Befehl gcloud services operations describe können Sie die Vorgangsdetails abrufen:

gcloud services operations describe operations/OPERATION_ID

Ersetzen Sie OPERATION_ID durch die Vorgangs-ID, die Sie als Antwort auf Ihre ursprüngliche Anfrage erhalten haben.

REST API

Eiinen enzelnen Dienst aktivieren

Wenn Sie einen einzelnen Dienst aktivieren möchten, verwenden Sie die Methode services.enable.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google CloudProjekt-ID.
  • SERVICE: Der Name des Dienstes, den Sie aktivieren möchten.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation. 

{
  "name": "operations/OPERATION_ID"
}

Mehrere Dienste aktivieren

Mit der Methode services.batchEnable können Sie bis zu 20 Dienste in einem einzigen Vorgang aktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google CloudProjekt-ID.
  • SERVICE1: Der Name eines Dienstes, den Sie aktivieren möchten.
  • SERVICE2: Der Name eines anderen Dienstes, den Sie aktivieren möchten.

JSON-Text der Anfrage:

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation. 

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

Dienst deaktivieren

Sie können eine API für ein Projekt jederzeit deaktivieren. Ausstehende Gebühren und die Nutzung kostenpflichtiger APIs in Ihren Projekten werden Ihnen jedoch weiterhin in Rechnung gestellt. Weitere Informationen finden Sie im Leitfaden „Erste Schritte“ für Cloud APIs.

Für viele Dienste wie Cloud Storage und BigQuery fallen Gebühren für die Datenspeicherung an. Wenn Sie die API eines Dienstes deaktivieren, werden Ihre Daten nicht gelöscht und die Abrechnung erfolgt weiterhin. Wenn Sie zukünftige Gebühren vermeiden und einen Dienst nicht mehr verwenden möchten, löschen Sie alle zugehörigen Daten, bevor Sie die API deaktivieren.

Wenn Sie die Google Kubernetes Engine API deaktivieren, werden ausgeführte Cluster im Projekt angehalten. Nach 30 Tagen werden diese gesperrten Cluster gelöscht. Wenn Sie Ihre Cluster reaktivieren möchten, aktivieren Sie die GKE API noch einmal. Es kann bis zu 24 Stunden dauern, bis die Cluster wieder aktiviert werden. Weitere Informationen finden Sie unter Clusterlebenszyklus.

Console

  1. Rufen Sie in der Google Cloud Console die Seite APIs & Dienste > API-Bibliothek auf.

    Zur API-Bibliothek

  2. Wählen Sie ein aktuelles Projekt aus oder verwenden Sie die Ressourcenauswahl in der Symbolleiste der Console, um das Google Cloud -Projekt auszuwählen, in dem Sie eine API deaktivieren möchten.

  3. Klicken Sie auf die API, die Sie deaktivieren möchten, oder suchen Sie im Feld Nach APIs und Diensten suchen danach.

  4. Klicken Sie auf  API deaktivieren.

gcloud

Mit dem Befehl gcloud services disable wird ein Dienst mit dem für das aktuelle Projekt angegebenen Namen deaktiviert.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • SERVICE: der Name des Dienstes, den Sie deaktivieren möchten.

Führen Sie den Befehl gcloud services disable aus:

Linux, macOS oder Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

Sie sollten eine Antwort ähnlich der folgenden erhalten:


Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Wenn Sie mehrere Dienste deaktivieren möchten, verwenden Sie durch Leerzeichen getrennte Dienstnamen. Mit dem folgenden Befehl werden beispielsweise sowohl BigQuery als auch Pub/Sub deaktiviert:

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

Mit dem Befehl gcloud services operations describe können Sie die Vorgangsdetails abrufen:

gcloud services operations describe operations/OPERATION_ID

Ersetzen Sie OPERATION_ID durch die Vorgangs-ID, die Sie als Antwort auf Ihre ursprüngliche Anfrage erhalten haben.

REST API

Wenn Sie einen Dienst deaktivieren möchten, verwenden Sie die Methode services.disable.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google CloudProjekt-ID.
  • SERVICE: Der Name des Dienstes, den Sie deaktivieren möchten.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation. 

{
  "name": "operations/OPERATION_ID"
}

Status eines Vorgangs mit langer Ausführungszeit prüfen

Wenn Sie die Methode „enable“ oder „disable“ verwenden, wird ein Vorgang mit langer Ausführungszeit zurückgegeben. Der Vorgang mit langer Ausführungszeit verfolgt den Status der Anfrage und gibt an, ob die Änderung des Dienstes abgeschlossen ist.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

OPERATION_ID: die Vorgangs-ID. Sie erhalten diese ID in der Antwort auf Ihre ursprüngliche Anfrage.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

Wenn das Feld done auf true gesetzt ist, ist der Vorgang abgeschlossen.