Einige oder alle Informationen auf dieser Seite gelten möglicherweise nicht für Cloud de Confiance von S3NS. Weitere Informationen finden Sie unter Unterschiede zu Google Cloud.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Dienste aktivieren und deaktivieren

Auf dieser Seite wird beschrieben, wie Sie Dienste für ein Cloud de Confiance -Projekt aktivieren und deaktivieren. Mit „Service Usage“ können Sie alle verfügbarenCloud de Confiance by S3NS -Dienste aktivieren oder deaktivieren.

Die meisten Nutzer können Dienste mit der Cloud de Confiance Console aktivieren und deaktivieren. Verwenden Sie für Skripts die Google Cloud CLI. Wenn Sie programmatisch auf die Service Usage API zugreifen möchten, empfehlen wir die Verwendung einer Clientbibliothek. Wenn Sie die API ausprobieren möchten, können Sie eine Anfrage senden, ohne eine vollständige Entwicklungsumgebung einzurichten.

Informationen zu Kontingentlimits für Service Usage finden Sie unter Kontingente und Limits. Möglicherweise möchten Sie die abrechenbare Nutzung einschränken. Je nach API können Sie Anfragen explizit begrenzen.

Hinweis

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

Console

In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
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.

gcloud

Installieren Sie die Google Cloud CLI.
Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
```
gcloud init
```
Cloud de Confiance Projekt erstellen oder auswählen
Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts
- 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 „Project Creator“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Informationen zum Zuweisen von Rollen
Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.
- So erstellen Sie ein Cloud de Confiance Projekt:
```
gcloud projects create PROJECT_ID
```
  Ersetzen Sie PROJECT_ID durch einen Namen für das Cloud de Confiance Projekt, das Sie erstellen.
- Wählen Sie das von Ihnen erstellte Projekt in Cloud de Confiance aus:
```
gcloud config set project PROJECT_ID
```
  Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Cloud de Confiance .
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.

REST API

Sie haben ein Cloud de Confiance Projekt, für das Sie APIs aktivieren oder deaktivieren möchten.
Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Anleitung erforderlich sind. Wenn Sie ein Projekt verwenden, das Sie erstellt haben, haben Sie in der Regel bereits die erforderlichen Berechtigungen.

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 müssen Sie zuerst die Nutzungsbedingungen akzeptieren. Andere befinden sich in der Vorschau und erfordern eine Genehmigung, bevor Sie sie verwenden können. Bei anderen APIs werden möglicherweise zusätzliche Informationen angefordert, z. B. die Kontaktdaten Ihrer Organisation und der Name 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

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

Zur API-Bibliothek
Wählen Sie ein aktuelles Projekt aus oder verwenden Sie die Ressourcenauswahl in der Symbolleiste der Console, um das Cloud de Confiance -Projekt auszuwählen, für das Sie eine API aktivieren möchten.
Klicken Sie auf die API, die Sie aktivieren möchten, oder suchen Sie im Feld Nach APIs und Diensten suchen danach.
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

Verwenden Sie den Befehl gcloud services operations describe, um die Vorgangsdetails abzurufen:

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

Verwenden Sie die Methode services.enable, um einen einzelnen Dienst zu aktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID.
SERVICE: Der Name des Dienstes, den Sie aktivieren möchten.

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie diesen Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

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

{
  "name": "operations/OPERATION_ID"
}

Mehrere Dienste aktivieren

Verwenden Sie die Methode services.batchEnable, um bis zu 20 Dienste in einem einzigen Vorgang zu aktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-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:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

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. Sie müssen jedoch weiterhin alle ausstehenden Gebühren und die kostenpflichtige API-Nutzung in Ihren Projekten bezahlen. Weitere Informationen finden Sie im Startleitfaden für Cloud APIs.

Bei vielen Diensten wie Cloud Storage und BigQuery werden Gebühren für die Datenspeicherung erhoben. Wenn Sie die API für diese Dienste deaktivieren, werden Ihre Daten nicht gelöscht. Für diese Dienste wird Ihnen die Datenspeicherung auch nach der Deaktivierung der API weiterhin in Rechnung gestellt. Wenn Sie die Cloud Run API deaktivieren, werden die mit Cloud Run verknüpften Ressourcen gelöscht. Das ist möglicherweise nicht beabsichtigt.

In beiden Fällen und als allgemeine Best Practice sollten Sie vor dem Deaktivieren des Dienstes eine Bestandsaufnahme der mit Ihrem Dienst verknüpften Ressourcen durchführen. Wenn Sie Dienste wie Cloud Storage und BigQuery nicht mehr nutzen möchten und zukünftige Gebühren vermeiden wollen, löschen Sie alle zugehörigen Daten, bevor Sie die API deaktivieren. Deaktivieren Sie die API für Cloud Run erst, wenn Sie bestätigt haben, dass alle vorhandenen Cloud Run-Ressourcen sicher gelöscht werden können.

Wenn Sie die Kubernetes Engine API deaktivieren, werden laufende 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 wieder. Es kann bis zu 24 Stunden dauern, bis die Cluster wieder aktiviert werden. Weitere Informationen finden Sie unter Clusterlebenszyklus.

fest.

Console

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

Zur API-Bibliothek
Wählen Sie ein aktuelles Projekt aus oder verwenden Sie die Ressourcenauswahl in der Symbolleiste der Console, um das Cloud de Confiance -Projekt auszuwählen, in dem Sie eine API deaktivieren möchten.
Klicken Sie auf die API, die Sie deaktivieren möchten, oder suchen Sie im Feld Nach APIs und Diensten suchen danach.
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 der BigQuery- als auch der Pub/Sub-Dienst deaktiviert:

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

Verwenden Sie den Befehl gcloud services operations describe, um die Vorgangsdetails abzurufen:

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

Verwenden Sie die Methode services.disable, um einen Dienst zu deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID.
SERVICE: Der Name des Dienstes, den Sie deaktivieren möchten.

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

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie diesen Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

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 (Long-Running Operation, LRO) 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 Vorgangskennung. 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:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

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.