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.

Dans la plupart des cas d'utilisation opérationnels, le moyen le 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 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 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 :

• Un projet Google Cloud. Pour savoir comment créer un projet Google Cloud, consultez la page 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,
• 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 de la métrique de quota serviceusage.googleapis.com/mutate_requests. Le quota par défaut disponible est de deux 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.

   • Pour utiliser le navigateur de projet Google Cloud, procédez comme suit:

     1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet Google Cloud.
     2. Recherchez votre projet, 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.

Remarque : Le processus d'activation peut varier selon les API. Certaines API vous invitent à accepter leurs conditions d'utilisation en préalable à l'activation. D'autres sont en mode aperçu et requièrent des procédures spéciales d'inscription et d'ajout à une liste blanche avant toute utilisation. Enfin, certaines peuvent demander des informations supplémentaires, telles que les coordonnées de votre organisation ou le nom de l'application que vous développez. Les informations supplémentaires qui vous sont éventuellement demandées ne sont pas partagées en dehors de Google. Nous les utilisons afin de mieux comprendre comment l'API est utilisée, ainsi que comme contact secondaire dans le cas où nous aurions besoin de communiquer avec vous au sujet de votre utilisation du service.

Désactiver des services

La désactivation de services utilise le quota de la métrique de quota serviceusage.googleapis.com/mutate_requests. Le quota par défaut disponible est de deux 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, tels que Cloud Storage et BigQuery, facturent le stockage de données. La désactivation de l'accès aux API d'un service ne supprime pas les données sous-jacentes qui continueront d'être facturées. Si votre intention est de cesser d'utiliser un service et de cesser tous les frais futurs, veillez à supprimer toutes les données associées au service avant de désactiver son accès aux API.

Remarque : Dans la v1 de l'API, si vous tentez de désactiver un service dont dépendent d'autres services activés, l'appel échoue. L'appel d'API visant à désactiver le service engendre un message d'erreur. Pour désactiver le service spécifié et tous les services qui en dépendent, définissez le paramètre disable_dependent_services de la requête services.disable sur true.

Console

Pour désactiver une API pour un projet :

1. Accédez à la page Tableau de bord des API de la console Google Cloud.
   Accéder au tableau de bord des API

2. Sélectionnez le projet Google Cloud dans 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.

   • Pour utiliser le navigateur de projet Google Cloud, procédez comme suit:

     1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet Google Cloud.
     2. Recherchez votre projet, 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.