Habilitar e inhabilitar servicios

En esta página se describe cómo habilitar e inhabilitar servicios en un proyecto de Google Cloud . Puedes usar Uso de Servicios para habilitar o inhabilitar cualquier servicio disponible para tus proyectos, incluidos los Google Cloud servicios públicos y los servicios privados creados con Cloud Endpoints. Para obtener más información sobre las diferencias entre las APIs y los servicios públicos y privados, consulta Servicios públicos y privados.

En la mayoría de los casos prácticos, la forma más sencilla de habilitar e inhabilitar servicios es usar la consola Google Cloud . Si necesitas crear secuencias de comandos, también puedes usar la CLI de Google Cloud. Si necesitas programar con la API de Uso de Servicio, te recomendamos que utilices una de nuestras bibliotecas de cliente. Para experimentar con la API, puedes seguir las instrucciones alternativas de esta guía y usar el comando curl para probar la API sin configurar un entorno de desarrollo de aplicaciones completo.

Antes de empezar

Para habilitar e inhabilitar APIs y servicios, necesitas lo siguiente:

  • Un Google Cloud proyecto. Para saber cómo crear un Google Cloud proyecto, consulta el artículo Crear y gestionar proyectos.
  • Los permisos de Gestión de Identidades y Accesos correctos. Para obtener información sobre los requisitos de gestión de identidades y accesos de Uso del servicio, consulta Control de acceso.
  • Para instalar Google Cloud CLI.
  • Si quieres usar los curl ejemplos de esta guía, asegúrate de seguir las instrucciones para completar la configuración inicial en Empezar. Estos pasos incluyen la definición de gcurl, que es un alias autenticado del comando estándar curl, y la definición de la variable de entorno PROJECT_NUMBER.

Habilitar servicios

Al habilitar servicios, se usa la cuota de la métrica de cuota de serviceusage.googleapis.com/mutate_requests. La cuota predeterminada disponible es de 2 consultas por segundo (CPS).

consola

Para habilitar una API en un proyecto, sigue estos pasos:

  1. Ve a la página Google Cloud consola Biblioteca de APIs.
    Ve a la página Biblioteca de APIs

  2. Selecciona el Google Cloud proyecto en el que quieras habilitar una API de una de las siguientes formas:

    • Haz clic en un Google Cloud proyecto de Seleccionar un proyecto reciente.

    • Usa el navegador de proyectos Google Cloud siguiendo estos pasos:

      1. Haz clic en Seleccionar proyecto para abrir el Google Cloud explorador de proyectos.
      2. Busca tu proyecto y haz clic en su nombre Google Cloud .
      3. Haz clic en Abrir para abrir el proyecto.

  3. Haz clic en la API que quieras habilitar. Si necesitas ayuda para encontrar la API, usa el cuadro Buscar APIs y servicios situado cerca de la parte superior de la página. Aparecerá una página con información sobre la API.

  4. Haz clic en el botón Habilitar.

gcloud

Ejecuta el siguiente comando para habilitar el servicio de la API Pub/Sub en tu proyecto actual:

gcloud services enable pubsub.googleapis.com

El comando genera un resultado similar al siguiente:

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Puedes usar el siguiente comando 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 en una sola operación con el método services.batchEnable.

Habilitar un solo servicio

El siguiente comando habilita el servicio de la API 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 devuelve 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, aquí tienes 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 Uso de Servicio, envía 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}"

Habilitar varios servicios a la vez

Si quieres habilitar varios servicios de API en tu proyecto, puedes ejecutar un comando de habilitación para cada servicio de API por separado o ejecutar un comando de habilitación por lotes y especificar varias APIs. Por ejemplo, para habilitar los servicios de las APIs 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 devuelve un recurso de operación, que puedes sondear mediante su name.

Disabling services

Si inhabilitas servicios, se usará cuota de la métrica de cuota serviceusage.googleapis.com/mutate_requests. La cuota predeterminada disponible es de 2 consultas por segundo (CPS).

Puedes inhabilitar una API en un proyecto en cualquier momento, aunque los cargos pendientes se seguirán cobrando en tu cuenta y se te cobrará por el uso facturable de la API en tus proyectos. Para obtener más información, consulta APIs and Billing (APIs y facturación).

Muchos servicios, como Cloud Storage y BigQuery, cobran por almacenar datos. Si inhabilitas el acceso a la API de un servicio, no se eliminarán los datos subyacentes, por los que se seguirá facturando. Si quieres dejar de usar un servicio y que no se te cobre en el futuro, asegúrate de eliminar todos los datos asociados al servicio antes de inhabilitar el acceso a su API.

Si inhabilitas la API de GKE, se suspenderán todos los clústeres que se estén ejecutando en el proyecto. Transcurridos 30 días, los clústeres suspendidos se eliminan. Para restaurar los clústeres suspendidos, habilita la API de GKE. Los clústeres pueden tardar hasta 24 horas en restaurarse.

.

consola

Para inhabilitar una API en un proyecto, sigue estos pasos:

  1. Ve a la página Panel de control de APIs de la Google Cloud consola .
    Ve a la página Panel de control de APIs.

  2. Selecciona el Google Cloud proyecto en el que quieras inhabilitar una API de una de las siguientes formas:

    • Haz clic en un Google Cloud proyecto de Seleccionar un proyecto reciente.

    • Usa el navegador de proyectos Google Cloud siguiendo estos pasos:

      1. Haz clic en Seleccionar proyecto para abrir el Google Cloud explorador de proyectos.
      2. Busca tu proyecto y haz clic en su nombre Google Cloud .
      3. Haz clic en Abrir para abrir el proyecto.

  3. Haz clic en la API que quieras inhabilitar. Si necesitas ayuda para encontrar la API, usa el cuadro Buscar APIs y servicios situado cerca de la parte superior de la página. Aparecerá una página con información sobre la API.

  4. Haz clic en Inhabilitar API.

gcloud

Ejecuta el siguiente comando para inhabilitar el servicio de la API Pub/Sub en tu proyecto actual:

gcloud services disable pubsub.googleapis.com

El comando genera un resultado similar al siguiente:

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

Puedes usar el siguiente comando para obtener los detalles de la operación:

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

El siguiente comando inhabilita el servicio de la API 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 devuelve un recurso de operación, que puedes sondear mediante su name.