Cette page a été traduite par l'API Cloud Translation.
Switch to English

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 Google Cloud Console. Si vous devez créer des scripts, vous pouvez également utiliser 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 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 :

  • Posséder un projet Cloud. Pour savoir comment créer un projet Cloud, voir 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.
  • 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 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, ainsi que la définition de la variable d'environnement PROJECT_NUMBER.

Activer des services

Console

Pour activer une API pour un projet :

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

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

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

      1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet 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 l'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 seul service à 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 seul service

La commande suivante active le service d'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 affiche une ressource d'opération de longue durée, qui représente les tâches en cours sur le serveur. Chaque opération a 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 Service Usage operations.get, 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 exécuter une commande d'activation pour chaque service d'API individuellement, ou exécuter une commande d'activation par lot et spécifier plusieurs API. Par exemple, pour activer les services de l'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"

Tout comme le pipeline services.enable, services.batchEnable renvoie une ressource d'opération que vous pouvez interroger à l'aide de son objet name.

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 Cloud Console.
    Accéder au tableau de bord des API
  2. Sélectionnez le projet Cloud dans lequel vous souhaitez désactiver une API en effectuant l'une des opérations suivantes:

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

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

      1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet 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 l'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 Gérer.

  5. Cliquez sur Désactiver.

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 d'API Pub/Sub sur votre projet:

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

Tout comme le pipeline services.enable, services.disable renvoie une ressource d'opération que vous pouvez interroger à l'aide de son objet 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.