Activer et désactiver des services

Cette page décrit comment activer et désactiver les services pour un projet Google Cloud. Vous pouvez utiliser Service Usage pour activer ou désactiver tout service disponible pour vos projets, y compris les services Google Cloud publics et les services privés créés à l'aide de Cloud Endpoints. Pour plus d'informations sur les différences entre les API et les services publics et privés, consultez la page Services publics et services privés.

Pour la plupart des cas d'utilisation opérationnels, la manière la plus simple d'activer et de désactiver des services consiste à utiliser la console Google Cloud. Si vous devez créer des scripts, vous pouvez également utiliser la Google Cloud CLI. Si vous devez programmer à l'aide de l'API Service Usage, nous vous recommandons d'utiliser l'une des bibliothèques clientes que nous fournissons. Pour tester l'API, vous pouvez suivre les instructions alternatives de ce guide et utiliser la commande curl pour effectuer vos tests sans configurer un environnement de développement d'application complet.

Avant de commencer

Pour activer ou désactiver des API et des services, vous devez remplir les conditions préalables suivantes :

  • Un projet Google Cloud. Pour savoir comment créer un projet Google Cloud, consultez Créer et gérer des projets
  • Les autorisations de gestion de l'authentification et des accès appropriées. Pour en savoir plus sur les exigences relatives à IAM pour Service Usage, consultez la page Contrôle des accès.
  • Pour installer la Google Cloud CLI, procédez comme suit :
  • Si vous souhaitez utiliser les exemples curl de ce guide, assurez-vous de suivre les instructions pour terminer la configuration initiale dans Premiers pas. Ces étapes incluent la définition de gcurl, qui est un alias authentifié pour la commande curl standard, et la définition de la variable d'environnement PROJECT_NUMBER.

Activer des services

L'activation des services utilise le quota du serviceusage.googleapis.com/mutate_requests métrique de quota. La valeur par défaut le quota disponible est de 2 requêtes par seconde (RPS).

Console

Pour activer une API pour un projet :

  1. Accédez à la page Bibliothèque d'API de la console Google Cloud.
    Accédez à la page Bibliothèque d'API
  2. Sélectionnez le projet Google Cloud dans lequel vous souhaitez activer une API en effectuant l'une des opérations suivantes:

    • Cliquez sur un projet Google Cloud sous Sélectionner un projet récent.

    • Utilisez le navigateur de projet Google Cloud en procédant comme suit : étapes:

      1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet Google Cloud.
      2. Recherchez votre projet Google Cloud, puis cliquez sur son nom.
      3. Cliquez sur Ouvrir pour ouvrir le projet.
  3. Cliquez sur l'API que vous souhaitez activer. Si vous avez besoin d'aide pour trouver cette API, utilisez la zone Rechercher des API et des services en haut de la page. Une page décrivant l'API s'affiche.

  4. Cliquez sur le bouton ACTIVER.

gcloud

Exécutez la commande suivante pour activer le service API Pub/Sub dans votre projet actuel :

gcloud services enable pubsub.googleapis.com

Cette commande produit un résultat semblable à celui-ci :

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

La commande suivante vous permet d'obtenir les détails de l'opération :

gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687

curl

Vous pouvez activer un service unique à l'aide de la méthode services.enable. Pour activer entre 2 et 20 services en une seule opération, utilisez la méthode services.batchEnable.

Activer un service unique

La commande suivante active le service API Pub/Sub sur votre projet :

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

La méthode services.enable renvoie une ressource de type Opération de longue durée, qui représente le travail en cours sur le serveur. Chaque opération possède un nom de ressource unique. Par exemple, voici une opération nommée operations/acf.2e2fcfce-8327-4984-9040-a67777082687 :

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

Pour interroger l'état de l'opération à l'aide de la méthode operations.get de Service Usage, transmettez le nom de l'opération à l'API :

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

Activer plusieurs services à la fois

Si vous souhaitez activer plusieurs services d'API sur votre projet, vous pouvez émettre une commande d'activation pour chaque service d'API individuellement, ou une commande d'activation par lot en spécifiant plusieurs API. Par exemple, pour activer à la fois les services API Pub/Sub et Dataflow sur votre projet :

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

Comme services.enable, services.batchEnable renvoie une ressource d'opération que vous pouvez interroger à l'aide de son name.

Désactiver des services

La désactivation des services utilise le quota du serviceusage.googleapis.com/mutate_requests métrique de quota. La valeur par défaut le quota disponible est de 2 requêtes par seconde (RPS).

Vous pouvez désactiver une API pour un projet donné à tout moment, sachant que les frais en attente seront néanmoins facturés sur votre compte, de même que toute autre utilisation facturable de cette API dans le cadre de vos projets. Pour plus d'informations, consultez la section API et facturation.

De nombreux services, comme Cloud Storage et BigQuery, facturent le stockage de données. La désactivation de l'accès à l'API d'un service ne supprime pas les données sous-jacentes, qui continueront d'être facturées. Si vous souhaitez cesser d'utiliser un service et arrêter tous les futurs débits, veillez à supprimer toutes les données associées au service avant de désactiver l'accès de l'API au service.

console

Pour désactiver une API pour un projet :

  1. Accéder à la console Google Cloud Tableau de bord des API .
    Accéder à la page "Tableau de bord" des API
  2. Sélectionnez le projet Google Cloud pour lequel vous souhaitez désactiver une API en effectuant l'une des opérations suivantes :

    • Cliquez sur un projet Google Cloud sous Sélectionner un projet récent.

    • Utilisez le navigateur de projet Google Cloud en procédant comme suit : étapes:

      1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet Google Cloud.
      2. Recherchez votre projet Google Cloud, puis cliquez sur son nom.
      3. Cliquez sur Ouvrir pour ouvrir le projet.
  3. Cliquez sur l'API que vous souhaitez désactiver. Si vous avez besoin d'aide pour trouver cette API, utilisez la zone Rechercher des API et des services en haut de la page. Une page décrivant l'API s'affiche.

  4. Cliquez sur  Désactiver l'API.

gcloud

Exécutez la commande suivante pour désactiver le service API Pub/Sub pour votre projet actuel :

gcloud services disable pubsub.googleapis.com

Cette commande produit un résultat semblable à celui-ci :

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

La commande suivante vous permet d'obtenir les détails de l'opération :

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

La commande suivante désactive le service API Pub/Sub sur votre projet :

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

Comme services.enable, services.disable renvoie une ressource d'opération que vous pouvez interroger à l'aide de son name.

Étapes suivantes

Pour savoir comment afficher et gérer les métriques et les limites de quota qui s'appliquent à votre projet, consultez la page Gérer les quotas de service.