Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Activer et désactiver des services
Cette page explique comment activer et désactiver des 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 servicesGoogle Cloud publics et les services privés créés à l'aide de Cloud Endpoints. Pour en savoir plus 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 la section Créer et gérer des projets.
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 disponible par défaut est de deux requêtes par seconde (RPS).
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 projets Google Cloud , procédez comme suit:
Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projets Google Cloud .
Recherchez votre projet, puis cliquez sur son Google Cloud nom.
Cliquez sur Ouvrir pour ouvrir le projet.
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.
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 :
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 :
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 :
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 :
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 de services utilise le quota de la métrique de quota serviceusage.googleapis.com/mutate_requests. Le quota disponible par défaut 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, 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.
Si vous désactivez l'API GKE, tous les clusters en cours d'exécution du projet sont suspendus. Passé ce délai, les clusters suspendus sont supprimés. Pour rétablir vos clusters suspendus, activez l'API GKE. La réactivation des clusters peut prendre jusqu'à 24 heures.
Sélectionnez le Google Cloud projet 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.
Pour utiliser le navigateur de projets Google Cloud , procédez comme suit:
Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projets Google Cloud .
Recherchez votre projet, puis cliquez sur son Google Cloud nom.
Cliquez sur Ouvrir pour ouvrir le projet.
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.
Cliquez sur stopDé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 :
Comme services.enable, services.disable renvoie une ressource d'opération que vous pouvez interroger à l'aide de son name.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/13 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/13 (UTC)."],[],[],null,["# Enabling and Disabling Services\n===============================\n\nThis page describes how to enable and disable services for a Google Cloud project.\nYou can use Service Usage to enable or disable any available service\nfor your projects, including public\n[Google Cloud services](/terms/services) and private services created\nusing [Cloud Endpoints](/endpoints/docs). For more information on the\ndifferences between public and private APIs and services, see\n[Public and Private Services](/service-usage/docs/public-vs-private).\n\nFor most operational use cases, the simplest way to enable and disable services\nis to use the Google Cloud console. If you need to create scripts, you can also use the\nGoogle Cloud CLI. If you need to program against the\nService Usage API, we recommend that you use one of our provided\n[client libraries](/service-usage/docs/libraries). To experiment with the API,\nyou can follow the alternative instructions in this guide and use the `curl`\ncommand to test the API without setting up a full application development\nenvironment.\n\nBefore you begin\n----------------\n\nTo enable and disable APIs and services you need:\n\n- A Google Cloud project. To learn how to create a Google Cloud project, see [Creating and Managing Projects](/resource-manager/docs/creating-managing-projects).\n- The correct [Identity and Access Management](/iam) permissions. To learn about the IAM requirements for Service Usage, see [Access Control](/service-usage/docs/access-control).\n- To install the [Google Cloud CLI](/sdk/docs/install).\n- If you want to use the `curl` examples in this guide, make sure you follow the instructions to complete the initial setup in [Getting Started](/service-usage/docs/set-up-development-environment). These steps include defining `gcurl`, which is an authenticated alias for the standard `curl` command, and defining the environment variable `PROJECT_NUMBER`.\n\nEnabling services\n-----------------\n\nEnabling services uses quota from the\n`serviceusage.googleapis.com/mutate_requests` quota metric. The default\navailable quota is 2 queries per second (QPS). \n\n### console\n\nTo enable an API for a project:\n\n1. Go to the Google Cloud console [API Library](https://console.cloud.google.com/project/_/apis/library) page. \n [Go to the API Library page](https://console.cloud.google.com/project/_/apis/library)\n2. Select the Google Cloud project where you want to enable\n an API by performing one of the following:\n\n - Click on a Google Cloud project under **Select a recent project**.\n\n - Use the Google Cloud project browser by performing the following\n steps:\n\n 1. Click **Select project** to open the Google Cloud project browser.\n 2. Find your project and then click on the Google Cloud project name.\n 3. Click **Open** to open the project.\n3. Click the API you want to enable. If you need help finding the API, use\n the **Search for APIs \\& Services** box near the top of the page. A page\n describing the API appears.\n\n4. Click the **Enable** button.\n\n### gcloud\n\nRun the following command to enable the Pub/Sub API service in your\ncurrent project: \n\n```\ngcloud services enable pubsub.googleapis.com\n```\n\nThe command produces output similar to the following: \n\n```\nWaiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...\nOperation finished successfully.\n```\n\nYou can use the following command to get the operation details: \n\n```\ngcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687\n```\n\n### curl\n\nYou can enable a single service using the\n[`services.enable`](/service-usage/docs/reference/rest/v1/services/enable)\nmethod. You can enable between 2 and 20 services in a single operation using\nthe [`services.batchEnable`](/service-usage/docs/reference/rest/v1/services/batchEnable)\nmethod.\n\n### Enable a single service\n\nThe following command enables the Pub/Sub API service on your\nproject: \n\n gcurl -d '{}' \"https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable\"\n\nThe\n[`services.enable`](/service-usage/docs/reference/rest/v1/services/enable)\nmethod returns a\n[Long Running Operation](/service-usage/docs/reference/rest/v1/operations)\nresource, which represents ongoing work on the server. Each operation has\na unique resource name. For example, here is an operation\nwith the name `operations/acf.2e2fcfce-8327-4984-9040-a67777082687`: \n\n {\n \"name\": \"operations/acf.2e2fcfce-8327-4984-9040-a67777082687\"\n }\n\nTo poll the operation status by using the Service Usage\n[`operations.get`](/service-usage/docs/reference/rest/v1/operations/get)\nmethod, pass the name of the operation to the API: \n\n OPERATION_NAME=\"operations/acf.2e2fcfce-8327-4984-9040-a67777082687\"\n gcurl \"https://serviceusage.googleapis.com/v1/${OPERATION_NAME}\"\n\n### Enable multiple services at once\n\nIf you want to enable multiple API services on your project, you can issue\nan enable command for each API service individually, or you can issue one\nbatch enable command and specify multiple APIs. For example, to enable both\nthe Pub/Sub and Dataflow API services on your project: \n\n gcurl -d '{\n \"serviceIds\": [\"pubsub.googleapis.com\", \"dataflow.googleapis.com\"]\n }' \"https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services:batchEnable\"\n\nLike `services.enable`, [`services.batchEnable`](/service-usage/docs/reference/rest/v1/services/batchEnable)\nreturns an operation resource, which you can poll by using its `name`.\n| **Note:** The process for enabling APIs can vary. Some APIs prompt you to accept their Terms of Service before you can enable them. Some APIs are in preview mode and require special signup and whitelisting before you can use them. Other APIs might ask for additional information, such as your organization's contact information and the name of the application you are developing. When more information is requested, it will not be shared outside of Google; it's used to help Google understand how the API is being used and as a secondary contact should we need to contact you regarding your use of the service.\n\nDisabling services\n------------------\n\nDisabling services uses quota from the\n`serviceusage.googleapis.com/mutate_requests` quota metric. The default\navailable quota is 2 queries per second (QPS).\n\nYou can disable an API for a project at any time, although any pending fees will\nstill be charged to your account and you'll be charged for any billable API use\nin your projects. For more information, see\n[APIs and Billing](https://support.google.com/cloud/answer/6158867).\n\nMany services like Cloud Storage and BigQuery charge to store data. Disabling a\nservice's API access does not delete the underlying data which will continue\nto be billed. If your intent is to discontinue using a service and stop all\nfuture charges, be sure to delete all data associated with the service before\ndisabling the service's API access.\n\nIf you disable the GKE API, any running clusters in the project become suspended. After 30 days, the suspended clusters are deleted. To reinstate your suspended clusters, enable the GKE API. It may take up to 24 hours for the clusters to be reinstated.\n**Note:** In v1 of the API, if you attempt to disable a service that other enabled services depend on, the call will fail. The API call to disable the service will result in an error message. To disable the specified service and all of the services that depend on it, set the `disable_dependent_services` parameter on the [`services.disable`](/service-usage/docs/reference/rest/v1/services/disable) request to `true`. \n\n### console\n\nTo disable an API for a project:\n\n1. Go to the Google Cloud console [API Dashboard](https://console.cloud.google.com/project/_/apis/dashboard) page. \n [Go to the API Dashboard page](https://console.cloud.google.com/project/_/apis/dashboard)\n2. Select the Google Cloud project where you want to disable\n an API by performing one of the following:\n\n - Click on a Google Cloud project under **Select a recent project**.\n\n - Use the Google Cloud project browser by performing the following\n steps:\n\n 1. Click **Select project** to open the Google Cloud project browser.\n 2. Find your project and then click on the Google Cloud project name.\n 3. Click **Open** to open the project.\n3. Click the API you want to disable. If you need help finding the API, use\n the **Search for APIs \\& Services** box near the top of the page. A page\n describing the API appears.\n\n4. Click *stop* **Disable API**.\n\n### gcloud\n\nRun the following command to disable the Pub/Sub API service for\nyour current project: \n\n```\ngcloud services disable pubsub.googleapis.com\n```\n\nThe command produces output similar to the following: \n\n```\nWaiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...\nOperation finished successfully.\n```\n\nYou can use the following command to get the operation details: \n\n```\ngcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8\n```\n\n### curl\n\nThe following command disables the Pub/Sub API service on\nyour project: \n\n gcurl -d '{}' \"https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable\"\n\nLike `services.enable`, [`services.disable`](/service-usage/docs/reference/rest/v1/services/disable)\nreturns an operation resource, which you can poll by using its `name`."]]
