Activer et désactiver des services

Cette page explique comment activer et désactiver des services pour un projet Google Cloud Platform. Service Usage vous permet d'activer ou de désactiver tout service disponible dans le cadre de vos projets, qu'il s'agisse d'un service Google Cloud Platform public ou d'un service privé créé à l'aide de Cloud Endpoints. Pour plus d'informations sur les différences entre les API et services publics et privés, consultez la page Services publics et services privés.

Dans la plupart des cas d'utilisation opérationnels, le moyen le plus simple d'activer ou de désactiver des services consiste à utiliser la console Google Cloud Platform. Si vous devez créer des scripts, vous pouvez également passer par l'interface de ligne de commande gcloud. 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 expérimenter l'API, vous pouvez suivre les instructions alternatives fournies dans ce guide, qui montrent comment utiliser la commande curl pour tester l'API sans configurer un environnement de développement d'applications complet.

Avant de commencer

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

  • Vous devez disposer d'un projet GCP. Pour savoir comment créer un projet GCP, consultez la section Créer et gérer des projets.
  • Vous devez détenir les autorisations Cloud Identity and Access Management (IAM) appropriées. Pour en savoir plus sur les exigences relatives à Cloud IAM pour Service Usage, consultez la page Contrôle des accès.
  • Si vous souhaitez exécuter les exemples de ligne de commande gcloud de ce guide, vous devez installer le SDK Cloud.
  • Si vous souhaitez utiliser les exemples reposant sur curl fournis dans ce guide, procédez à la configuration initiale en suivant les instructions de la page Premiers pas.

Activer des services

Console

Pour activer une API pour un projet :

  1. Accédez à la page Bibliothèque des API de la console GCP.
    Accéder à la page "Bibliothèque" des API
  2. Cliquez sur Sélectionner pour choisir le projet GCP.
  3. Cliquez sur l'API que vous souhaitez activer. Si vous avez besoin d'aide pour trouver cette API, utilisez le champ de recherche.
  4. Cliquez sur Activer.

gcloud

Pour activer le service d'API Cloud Pub/Sub dans votre projet actuel, exécutez la commande suivante :

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

La méthode services.enable vous permet d'activer un service unique. Pour activer entre 2 et 20 services en une seule opération, utilisez la méthode services.batchEnable.

La commande suivante active le service d'API Cloud Pub/Sub dans le projet numéro 357084163378 :

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:enable

La méthode services.enable renvoie une ressource d'opération de longue durée qui vous permet de vérifier l'état de l'opération. Vous pouvez obtenir l'état de l'opération à l'aide de la méthode Service Usage operations.get.

La commande suivante active simultanément les services d'API Cloud Pub/Sub et Cloud Dataflow dans le projet numéro 357084163378 :

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

La méthode services.batchEnable renvoie une ressource d'opération de longue durée qui vous permet de vérifier l'état de l'opération. Vous pouvez obtenir l'état de l'opération à l'aide de la méthode Service Usage operations.get.

Désactiver des services

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.

Console

Pour désactiver une API pour un projet :

  1. Accédez à la page Tableau de bord des API de la console GCP.
    Accéder à la page "Tableau de bord" des API
  2. Cliquez sur Sélectionner pour choisir le projet GCP.
  3. À côté de l'API que vous souhaitez désactiver, cliquez sur Désactiver.

gcloud

Pour désactiver le service d'API Cloud Pub/Sub dans votre projet actuel, exécutez la commande suivante :

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 d'API Cloud Pub/Sub dans le projet numéro 357084163378 :

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:disable

La méthode services.disable renvoie une ressource d'opération de longue durée qui vous permet de vérifier l'état de l'opération. Vous pouvez obtenir l'état de l'opération à l'aide de la méthode Service Usage operations.get.