Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Habilitar e inhabilitar servicios
En esta página, se describe cómo habilitar e inhabilitar servicios en un proyecto de Google Cloud .
Puedes usar Service Usage para habilitar o inhabilitar cualquier servicio disponible para tus proyectos, incluidos los servicios públicos deGoogle Cloud y los servicios privados creados con Cloud Endpoints. Para obtener más información acerca de las diferencias entre las APIs y los servicios públicos y privados, consulta Servicios públicos y privados.
Para la mayoría de los casos prácticos operativos, la forma más sencilla de habilitar e inhabilitar servicios es usar la consola de Google Cloud . Si necesitas crear secuencias de comandos, también puedes usar Google Cloud CLI. Si quieres programar soluciones basadas en la API de Service Usage, te recomendamos que uses una de nuestras bibliotecas cliente. Para experimentar con la API, puedes seguir las instrucciones alternativas que aparecen en esta guía y usar el comando curl para probar la API sin configurar un entorno completo de desarrollo de aplicaciones.
Antes de comenzar
Para inhabilitar y habilitar API y servicios, necesitas los elementos siguientes:
Un Google Cloud proyecto. Para obtener información sobre cómo crear un proyecto de Google Cloud , consulta Cómo crear y administrar proyectos.
Si quieres usar los ejemplos de curl que aparecen en esta guía, asegúrate de seguir las instrucciones para completar la configuración inicial que se indican en Cómo comenzar. En estos pasos, se incluye la definición de gcurl, que es un alias autenticado para el comando estándar curl, y la de la variable de entorno PROJECT_NUMBER.
Cómo habilitar servicios
La habilitación de servicios usa la cuota de la métrica de cuota serviceusage.googleapis.com/mutate_requests. La cuota disponible predeterminada es de 2 consultas por segundo (QPS).
Console
Para habilitar una API en un proyecto, sigue estos pasos:
Selecciona el Google Cloud proyecto en el que deseas habilitar una API mediante una de las siguientes opciones:
Haz clic en un Google Cloud proyecto en Selecciona un proyecto reciente.
Para usar el navegador de proyectos de Google Cloud , sigue estos pasos:
Haz clic en Seleccionar proyecto para abrir el Google Cloud navegador de proyectos.
Busca tu proyecto y haz clic en el Google Cloud nombre del proyecto.
Haz clic en Abrir para abrir el proyecto.
Haz clic en la API que deseas habilitar. Si necesitas ayuda para encontrar la API, usa el cuadro Buscar API y servicios cerca de la parte superior de la página. Aparecerá una página que describe la API.
Haz clic en el botón Habilitar.
gcloud
Ejecuta el siguiente comando para habilitar el servicio de la API de Pub/Sub en el proyecto actual:
gcloud services enable pubsub.googleapis.com
El comando muestra un resultado similar al siguiente:
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
Puedes usar el comando siguiente para obtener los detalles de la operación:
Puedes habilitar un solo servicio con el método services.enable. También puedes habilitar entre 2 y 20 servicios en una sola operación con el método services.batchEnable.
Habilita un solo servicio
El siguiente comando habilita el servicio de la API de Pub/Sub en el proyecto:
El método services.enable muestra un recurso de operación de larga duración que representa el trabajo en curso en el servidor. Cada operación tiene un nombre de recurso único. Por ejemplo, esta es una operación con el nombre operations/acf.2e2fcfce-8327-4984-9040-a67777082687:
Si deseas habilitar varios servicios de API en tu proyecto, puedes emitir un comando de habilitación para cada servicio de API de forma individual o uno por lotes y especificar varias API. Por ejemplo, para habilitar los servicios de la API de Pub/Sub y Dataflow en tu proyecto, haz lo siguiente:
Al igual que services.enable, services.batchEnable muestra un recurso de operación, que puedes sondear con su name.
Cómo inhabilitar servicios
La inhabilitación de servicios usa la cuota de la métrica de cuota serviceusage.googleapis.com/mutate_requests. La cuota disponible predeterminada es de 2 consultas por segundo (QPS).
Puedes inhabilitar una API en un proyecto en cualquier momento, aunque se cobrarán las tarifas pendientes de tu cuenta y todo el uso facturable de la API en tu proyecto. Para obtener más información, consulta API y facturación.
Muchos servicios, como Cloud Storage y BigQuery, cobran por almacenar datos. Inhabilitar el acceso a la API de un servicio no borra los datos subyacentes, que se seguirán facturando. Si tu intención es dejar de usar un servicio y detener todos los cargos futuros, asegúrate de borrar todos los datos asociados con el servicio antes de inhabilitar el acceso a la API del servicio.
Si inhabilitas la API de GKE, se suspenderán todos los clústeres en ejecución del proyecto. Después de 30 días, se borran los clústeres suspendidos. Para restablecer los clústeres suspendidos, habilita la API de GKE. Los clústeres pueden tardar hasta 24 horas en restablecerse.
Console
Para inhabilitar una API en un proyecto, sigue estos pasos:
Selecciona el Google Cloud proyecto en el que deseas inhabilitar una API mediante una de las siguientes opciones:
Haz clic en un Google Cloud proyecto en Selecciona un proyecto reciente.
Para usar el navegador de proyectos de Google Cloud , sigue estos pasos:
Haz clic en Seleccionar proyecto para abrir el Google Cloud navegador de proyectos.
Busca tu proyecto y haz clic en el Google Cloud nombre del proyecto.
Haz clic en Abrir para abrir el proyecto.
Haz clic en la API que deseas inhabilitar. Si necesitas ayuda para encontrar la API, usa el cuadro Buscar API y servicios cerca de la parte superior de la página. Aparecerá una página que describe la API.
Haz clic en stopInhabilitar API.
gcloud
Ejecuta el siguiente comando para inhabilitar el servicio de la API de Pub/Sub para el proyecto actual:
gcloud services disable pubsub.googleapis.com
El comando muestra un resultado similar al siguiente:
Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.
Puedes usar el comando siguiente para obtener los detalles de la operación:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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`."]]
