Habilitar e inhabilitar servicios

En esta página, se describe cómo habilitar e inhabilitar servicios en un proyecto de Trusted Cloud . Puedes usar Service Usage para habilitar o inhabilitar cualquier servicio deTrusted Cloud by S3NS público disponible.

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 Trusted 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 Trusted Cloud proyecto. Para obtener información sobre cómo crear un proyecto de Trusted Cloud , consulta Cómo crear y administrar 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.
  • Instala Google Cloud CLI.
  • 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:

  1. Ve a la página Biblioteca de API de Trusted Cloud console.
    Ir a la página Biblioteca de API

  2. Selecciona el Trusted Cloud proyecto en el que deseas habilitar una API mediante una de las siguientes opciones:

    • Haz clic en un Trusted Cloud proyecto en Selecciona un proyecto reciente.

    • Para usar el navegador de proyectos de Trusted Cloud , sigue estos pasos:

      1. Haz clic en Seleccionar proyecto para abrir el Trusted Cloud navegador de proyectos.
      2. Busca tu proyecto y haz clic en el Trusted Cloud nombre del proyecto.
      3. Haz clic en Abrir para abrir el proyecto.

  3. 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.

  4. 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. 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:

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 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:

{
  "name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}

Para sondear el estado operativo 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 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:

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

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:

  1. Ve a la página Panel de API de la Trusted Cloud consola.
    Ve a la página Panel de API

  2. Selecciona el Trusted Cloud proyecto en el que deseas inhabilitar una API mediante una de las siguientes opciones:

    • Haz clic en un Trusted Cloud proyecto en Selecciona un proyecto reciente.

    • Para usar el navegador de proyectos de Trusted Cloud , sigue estos pasos:

      1. Haz clic en Seleccionar proyecto para abrir el Trusted Cloud navegador de proyectos.
      2. Busca tu proyecto y haz clic en el Trusted Cloud nombre del proyecto.
      3. Haz clic en Abrir para abrir el proyecto.

  3. 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.

  4. Haz clic en Inhabilitar 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:

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

curl

El siguiente comando inhabilita el servicio de la API de Pub/Sub en el 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.