Activer et désactiver des services

Vous pouvez utiliser Service Usage pour activer ou désactiver tout service disponible pour vos projets Google Cloud . Cela inclut les Google Cloud services publics et les services privés créés avec Cloud Endpoints. Pour en savoir plus sur les différences entre les services publics et privés, consultez Services publics et privés.

La plupart des utilisateurs peuvent activer et désactiver des services avec la console Google Cloud . Pour les scripts, utilisez la Google Cloud CLI. Pour accéder à l'API Service Usage de manière programmatique, nous vous recommandons d'utiliser une bibliothèque cliente. Pour essayer l'API, vous pouvez envoyer une requête sans configurer d'environnement de développement complet.

Pour connaître les limites de quota d'utilisation des services, consultez Quotas et limites. Vous voudrez peut-être limiter l'utilisation facturable. En fonction de l'API, vous pouvez explicitement limiter les requêtes.

Avant de commencer

Avant d'activer et de désactiver des services, vous devez configurer votre projetGoogle Cloud et votre environnement pour Service Usage.

Console

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

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.

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.

Verify that billing is enabled for your Google Cloud project.

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

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.

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.

Verify that billing is enabled for your Google Cloud project.

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

gcloud

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

Installez la Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour initialiser la gcloud CLI, exécutez la commande suivante :

gcloud init

Créez ou sélectionnez un projet Google Cloud .

Rôles requis pour sélectionner ou créer un projet

• Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

• Créez un projet Google Cloud  :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

• Sélectionnez le projet Google Cloud que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Vérifiez que la facturation est activée pour votre projet Google Cloud .

Activez l'API Service Usage :

Rôles requis pour activer les API

Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

gcloud services enable serviceusage.googleapis.com

Installez la Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour initialiser la gcloud CLI, exécutez la commande suivante :

gcloud init

Créez ou sélectionnez un projet Google Cloud .

Rôles requis pour sélectionner ou créer un projet

• Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

• Créez un projet Google Cloud  :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par le nom du projet Google Cloud que vous créez.

• Sélectionnez le projet Google Cloud que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre projet Google Cloud .

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Vérifiez que la facturation est activée pour votre projet Google Cloud .

Activez l'API Service Usage :

Rôles requis pour activer les API

Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

gcloud services enable serviceusage.googleapis.com

Rôles requis

Pour obtenir les autorisations nécessaires pour activer et désactiver des services, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Activer un service

La procédure d'activation d'un service peut varier. Certaines API vous demandent d'abord d'accepter leurs conditions d'utilisation ou sont en mode aperçu et nécessitent une approbation avant de pouvoir être utilisées. Enfin, certaines peuvent demander des informations supplémentaires, telles que les coordonnées de votre organisation ou le nom de votre application. Toutes les informations demandées restent confidentielles au sein de Google. Nous l'utilisons pour comprendre l'utilisation de l'API et pour vous contacter si nécessaire.

Console

1. Dans la console Google Cloud , accédez à la page API et services > Bibliothèque d'API.

   Accéder à la bibliothèque d'API

2. Sélectionnez un projet récent ou utilisez le sélecteur de ressources de la barre d'outils de la console pour sélectionner le projet Google Cloud dans lequel vous souhaitez activer une API.

3. Cliquez sur l'API que vous souhaitez activer ou recherchez-la à l'aide de la zone Rechercher des API et des services.

4. Cliquez sur Activer.

gcloud

La commande gcloud services enable active un service portant le nom spécifié pour le projet actuel.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• SERVICE : nom du service que vous souhaitez activer.

Exécutez la commande gcloud services enable :

Linux, macOS ou Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

Vous devriez obtenir un résultat semblable à celui-ci :

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

Pour activer plusieurs services, utilisez des noms de services séparés par des espaces. Par exemple, la commande suivante active les services BigQuery et Pub/Sub :

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

Pour récupérer les détails de l'opération, utilisez la commande gcloud services operations describe :

gcloud services operations describe operations/OPERATION_ID

Remplacez OPERATION_ID par l'ID d'opération que vous avez reçu en réponse à votre demande initiale.

API REST

Activer un service unique

Pour activer un seul service, utilisez la méthode services.enable.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud.
• SERVICE : nom du service que vous souhaitez activer.

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation :

{
  "name": "operations/OPERATION_ID"
}

Activer plusieurs services

Pour activer jusqu'à 20 services en une seule opération, utilisez la méthode services.batchEnable.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud.
• SERVICE1 : nom d'un service que vous souhaitez activer.
• SERVICE2 : nom d'un autre service que vous souhaitez activer.

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

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

Exécutez ensuite la commande suivante pour envoyer votre requête REST :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json. Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :

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

Exécutez ensuite la commande suivante pour envoyer votre requête REST :

$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

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation :

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

Désactiver un service

Vous pouvez désactiver une API pour un projet à tout moment. Toutefois, les frais en attente et l'utilisation d'API facturables dans vos projets vous seront toujours facturés. Pour en savoir plus, consultez le guide Premiers pas pour les APIs Cloud.

De nombreux services, tels que Cloud Storage et BigQuery, facturent le stockage des données. La désactivation de l'API d'un service ne supprime pas vos données, et vous continuerez à être facturé pour ce service. Pour éviter de futurs frais et arrêter d'utiliser un service, supprimez toutes les données associées avant de désactiver son API.

Si vous désactivez l'API Google Kubernetes Engine, les clusters en cours d'exécution dans le projet sont suspendus. Au bout de 30 jours, ces clusters suspendus sont supprimés. Pour réactiver vos clusters, réactivez l'API GKE. Un délai de 24 heures peut être nécessaire pour que les clusters soient rétablis. Pour en savoir plus, consultez la section Cycle de vie des clusters.

Remarque : Si vous essayez de désactiver un service dont dépendent d'autres services activés, la requête échouera et renverra une erreur. Pour désactiver le service spécifié et tous les services qui en dépendent, définissez le paramètre disableDependentServices de la requête services.disable sur true.

Console

1. Dans la console Google Cloud , accédez à la page API et services > Bibliothèque d'API.

   Accéder à la bibliothèque d'API

2. Sélectionnez un projet récent ou utilisez le sélecteur de ressources de la barre d'outils de la console pour sélectionner le projet Google Cloud dans lequel vous souhaitez désactiver une API.

3. Cliquez sur l'API que vous souhaitez désactiver ou recherchez-la à l'aide de la zone Rechercher des API et des services.

4. Cliquez sur Désactiver l'API.

gcloud

La commande gcloud services disable désactive un service portant le nom spécifié pour le projet actuel.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• SERVICE : nom du service que vous souhaitez désactiver.

Exécutez la commande gcloud services disable :

Linux, macOS ou Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

Vous devriez obtenir un résultat semblable à celui-ci :

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

Pour désactiver plusieurs services, utilisez des noms de service séparés par des espaces. Par exemple, la commande suivante désactive les services BigQuery et Pub/Sub :

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

Pour récupérer les détails de l'opération, utilisez la commande gcloud services operations describe :

gcloud services operations describe operations/OPERATION_ID

Remplacez OPERATION_ID par l'ID d'opération que vous avez reçu en réponse à votre demande initiale.

API REST

Pour désactiver un service, utilisez la méthode services.disable.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud.
• SERVICE : nom du service que vous souhaitez désactiver.

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation :

{
  "name": "operations/OPERATION_ID"
}

Vérifier l'état d'une opération de longue durée

L'utilisation de la méthode d'activation ou de désactivation renvoie une opération de longue durée (LRO). L'opération de longue durée suit l'état de la requête et indique si la modification du service est terminée.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

OPERATION_ID : identifiant de l'opération. Vous recevez cet ID dans la réponse à votre requête d'origine.

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

{
  "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"
    }
  }
}

Lorsque le champ done est défini sur true, l'opération est terminée.