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 de Google Cloud y los servicios privados creados con Cloud Endpoints. Para obtener más información acerca de las diferencias entre las API 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 los servicios es usar Google Cloud Console. Si quieres crear secuencias de comandos, también puedes usar la interfaz de línea de comandos de gcloud
. 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 proyecto de Cloud. Para aprender a crear un proyecto de Cloud, consulta Crea y administra proyectos.
- Los permisos de la administración de identidades y accesos correctos. Si quieres obtener información sobre los requisitos de IAM para Service Usage, consulta Control de acceso.
- Para ejecutar los ejemplos de la línea de comandos de
gcloud
que aparecen en esta guía, debes instalar el SDK de Cloud. - 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 define la definición degcurl
, que es un alias autenticado para el comando estándarcurl
y la definición de la variable de entornoPROJECT_NUMBER
.
Cómo habilitar servicios
Console
Para habilitar una API en un proyecto, sigue estos pasos:
- Ve a la página Biblioteca de la API de Cloud Console.
Ir a la página Biblioteca de API Selecciona el proyecto de Cloud en el que deseas habilitar una API mediante una de las siguientes acciones:
Haz clic en un proyecto de Cloud en Seleccionar un proyecto reciente.
Usa el navegador de proyectos de Cloud mediante los siguientes pasos:
- Haz clic en Seleccionar proyecto para abrir el navegador del proyecto de Cloud.
- Busca tu proyecto y haz clic en el nombre del proyecto de Cloud.
- Para abrir el proyecto, haz clic en Abrir.
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:
gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687
curl
Puedes habilitar un solo servicio con el método services.enable
. Puedes habilitar entre 2 y 20 servicios con una sola operación mediante el método services.batchEnable
.
Habilitar un solo servicio
El comando habilita el servicio de la API de Pub/Sub en tu proyecto:
gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable"
El método services.enable
muestra un recurso de operación de larga duración, que representa un trabajo continuo en el servidor. Cada operación tiene un nombre de recurso único. Por ejemplo, la siguiente es una operación con el nombre operations/acf.2e2fcfce-8327-4984-9040-a67777082687
:
{
"name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}
Para sondear el estado de la operación mediante el método operations.get
de Service Usage, pasa el nombre de la operación a la API:
OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"
Habilita varios servicios a la vez
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 puedes enviar un comando de habilitación 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:
gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services:batchEnable"
Al igual que services.enable
, services.batchEnable
muestra un recurso de operación, que puedes sondear con su name
.
Cómo inhabilitar servicios
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.
Console
Para inhabilitar una API en un proyecto, sigue estos pasos:
- Ve a la página Panel de API en Cloud Console.
Ir a la página Panel de API Selecciona el proyecto de Cloud en el que deseas inhabilitar una API mediante una de las siguientes acciones:
Haz clic en un proyecto de Cloud en Seleccionar un proyecto reciente.
Usa el navegador de proyectos de Cloud mediante los siguientes pasos:
- Haz clic en Seleccionar proyecto para abrir el navegador del proyecto de Cloud.
- Busca tu proyecto y haz clic en el nombre del proyecto de Cloud.
- Para abrir el proyecto, haz clic en Abrir.
Haz clic en la API que quieres 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 el botón Administrar.
Haz clic en stop Inhabilitar.
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:
gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8
curl
El comando siguiente inhabilita el servicio de la API de Pub/Sub en tu proyecto:
gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable"
Al igual que services.enable
, services.disable
muestra un recurso de operación, que puedes sondear con su name
.
Próximos pasos
Para obtener más información sobre cómo ver y administrar las métricas y los límites de cuota que se aplican a tu proyecto, consulta cómo administrar la cuota de servicio.