Habilitar e inhabilitar servicios

Puedes usar Uso de servicios para habilitar o inhabilitar cualquier servicio disponible en tus Google Cloud proyectos. Esto incluye los servicios privados creados con Cloud Endpoints. Para obtener más información sobre las diferencias entre los servicios públicos y privados, consulta Servicios públicos y privados.

La mayoría de los usuarios pueden habilitar e inhabilitar servicios con la consola de Google Cloud . Para las secuencias de comandos, usa Google Cloud CLI. Para acceder a la API de Uso de Servicio de forma programática, te recomendamos que uses una biblioteca de cliente. Para probar la API, puedes enviar una solicitud sin configurar un entorno de desarrollo completo.

Para conocer los límites de cuota de uso de servicios, consulta Cuotas y límites. Puede que quieras limitar el uso facturable. En función de la API, puedes limitar las solicitudes de forma explícita.

Antes de empezar

Antes de habilitar e inhabilitar servicios, debes configurar tuGoogle Cloud proyecto y tu entorno para el uso de servicios.

Consola

Inicia sesión en tu cuenta de Google Cloud . Si es la primera vez que utilizas Google Cloudo , crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito sin coste económico para ejecutar, probar y desplegar cargas de trabajo.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

gcloud

Inicia sesión en tu cuenta de Google Cloud . Si es la primera vez que utilizas Google Cloudo , crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito sin coste económico para ejecutar, probar y desplegar cargas de trabajo.

Instala Google Cloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Selecciona un proyecto: para seleccionar un proyecto, no necesitas un rol de gestión de identidades y accesos específico. Puedes seleccionar cualquier proyecto en el que se te haya asignado un rol.
• Crear un proyecto: para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Consulta cómo conceder roles.

Nota: Si no tienes la intención de guardar los recursos que obtendrás a lo largo de esta guía, crea un proyecto en lugar de seleccionar uno disponible. Después de completar estos pasos, podrás eliminar el proyecto y, con él, todos los recursos asociados.

• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Sustituye PROJECT_ID por el nombre del Google Cloud proyecto que vas a crear.

• Selecciona el Google Cloud proyecto que has creado:

  gcloud config set project PROJECT_ID

  Sustituye PROJECT_ID por el nombre de tu Google Cloud proyecto.

Si vas a usar un proyecto que ya tienes para seguir esta guía, comprueba que tienes los permisos necesarios para completarla. Si has creado un proyecto, ya tienes los permisos necesarios.

Instala Google Cloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Selecciona un proyecto: para seleccionar un proyecto, no necesitas un rol de gestión de identidades y accesos específico. Puedes seleccionar cualquier proyecto en el que se te haya asignado un rol.
• Crear un proyecto: para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Consulta cómo conceder roles.

Nota: Si no tienes la intención de guardar los recursos que obtendrás a lo largo de esta guía, crea un proyecto en lugar de seleccionar uno disponible. Después de completar estos pasos, podrás eliminar el proyecto y, con él, todos los recursos asociados.

• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Sustituye PROJECT_ID por el nombre del Google Cloud proyecto que vas a crear.

• Selecciona el Google Cloud proyecto que has creado:

  gcloud config set project PROJECT_ID

  Sustituye PROJECT_ID por el nombre de tu Google Cloud proyecto.

Si vas a usar un proyecto que ya tienes para seguir esta guía, comprueba que tienes los permisos necesarios para completarla. Si has creado un proyecto, ya tienes los permisos necesarios.

API REST

1. Tener un Google Cloud proyecto en el que quieras habilitar o inhabilitar APIs.

2. Comprueba que tienes los permisos necesarios para completar esta guía. Si usas un proyecto que has creado, normalmente ya tendrás los permisos necesarios.

Roles obligatorios

Para obtener los permisos que necesitas para habilitar e inhabilitar servicios, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Uso de Servicio (roles/serviceusage.serviceUsageAdmin) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Habilitar un servicio

El proceso para habilitar un servicio puede variar. Algunas APIs te piden que aceptes primero sus Términos del Servicio o están en vista previa y requieren aprobación antes de que puedas usarlas. Otras APIs pueden solicitar información adicional, como los datos de contacto de tu organización y el nombre de tu aplicación. La información solicitada sigue siendo confidencial en Google. La usamos para comprender el uso de la API y para ponernos en contacto contigo si es necesario.

Consola

1. En la Google Cloud consola, ve a la página APIs & Services > API Library.

   Ir a la biblioteca de APIs

2. Selecciona un proyecto reciente o usa el selector de recursos de la barra de herramientas de la consola para seleccionar el Google Cloud proyecto en el que quieras habilitar una API.

3. Haz clic en la API que quieras habilitar o búscala en el cuadro Buscar APIs y servicios.

4. Haz clic en Enable (Habilitar).

gcloud

El comando gcloud services enable habilita un servicio con el nombre especificado para el proyecto actual.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• SERVICE: el nombre del servicio que quieras habilitar.

Ejecuta el comando gcloud services enable:

Linux, macOS o Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

Deberías recibir una respuesta similar a la siguiente:

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Para habilitar varios servicios, usa nombres de servicios delimitados por espacios. Por ejemplo, el siguiente comando habilita los servicios BigQuery y Pub/Sub:

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

Para obtener los detalles de la operación, usa el comando gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Sustituye OPERATION_ID por el ID de operación que has recibido en respuesta a tu solicitud original.

API REST

Habilitar un solo servicio

Para habilitar un solo servicio, usa el método services.enable.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: tu ID de proyecto Google Cloud.
• SERVICE: el nombre del servicio que quieras habilitar.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

Si la solicitud se realiza correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Operation:

{
  "name": "operations/OPERATION_ID"
}

Nota: De forma predeterminada, la API Service Usage está habilitada en los proyectos, pero si la has inhabilitado en el proyecto que realiza la solicitud para habilitar un servicio, recibirás un error cuando intentes hacer la solicitud. Para solucionar este problema, usa la Google Cloud consola o Google Cloud CLI para volver a habilitar la API de Uso de Servicio en el proyecto que realiza la solicitud.

Habilitar varios servicios

Para habilitar hasta 20 servicios en una sola operación, usa el método services.batchEnable.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: tu ID de proyecto Google Cloud.
• SERVICE1: el nombre de un servicio que quieras habilitar.
• SERVICE2: el nombre de otro servicio que quieras habilitar.

Cuerpo JSON de la solicitud:

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

Si la solicitud se realiza correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Operation:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

Nota: De forma predeterminada, la API Service Usage está habilitada en los proyectos, pero si la has inhabilitado en el proyecto que realiza la solicitud para habilitar servicios, recibirás un error cuando intentes hacer la solicitud. Para solucionar este problema, usa la consola de Google Cloud o Google Cloud CLI para volver a habilitar la API de Uso de Servicio en el proyecto que realiza la solicitud.

Inhabilitar un servicio

Puedes inhabilitar una API de un proyecto en cualquier momento. Sin embargo, se te seguirá cobrando por las comisiones pendientes y el uso facturable de las APIs en tus proyectos. Para obtener más información, consulta la guía Empezar de las APIs de Cloud.

Muchos servicios, como Cloud Storage y BigQuery, cobran por el almacenamiento de datos, y inhabilitar la API de estos servicios no elimina los datos. En el caso de estos servicios, se te seguirá facturando por el almacenamiento de datos incluso después de que se haya inhabilitado la API. Por el contrario, si inhabilitas la API de Cloud Run, se eliminarán los recursos asociados a Cloud Run, lo que puede que no quieras hacer.

En ambos casos, y como práctica recomendada general, debes hacer un inventario de los recursos asociados a tu servicio antes de inhabilitarlo. En el caso de servicios como Cloud Storage y BigQuery, para dejar de recibir cargos y de usar el servicio, elimina todos los datos asociados antes de inhabilitar su API. En el caso de Cloud Run, no inhabilite la API hasta que haya confirmado que se pueden eliminar los recursos de Cloud Run que haya.

Si inhabilitas la API de Kubernetes Engine, los clústeres que se estén ejecutando en el proyecto se suspenderán. Transcurridos 30 días, estos clústeres suspendidos se eliminan. Para reactivar tus clústeres, vuelve a habilitar la API de GKE. Los clústeres pueden tardar hasta 24 horas en restaurarse. Para obtener más información, consulta Ciclo de vida de los clústeres.

Nota: Si intentas inhabilitar un servicio del que dependen otros servicios habilitados, la solicitud fallará y devolverá un error. Para inhabilitar el servicio especificado y todos los servicios que dependen de él, asigna el valor disableDependentServices al parámetro services.disable de la solicitud true.

Consola

1. En la Google Cloud consola, ve a la página APIs & Services > API Library.

   Ir a la biblioteca de APIs

2. Selecciona un proyecto reciente o usa el selector de recursos de la barra de herramientas de la consola para elegir el Google Cloud proyecto en el que quieras inhabilitar una API.

3. Haz clic en la API que quieras inhabilitar o búscala en el cuadro Buscar APIs y servicios.

4. Haz clic en Inhabilitar API.

gcloud

El comando gcloud services disable inhabilita un servicio con el nombre especificado para el proyecto actual.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• SERVICE: el nombre del servicio que quieras inhabilitar.

Ejecuta el comando gcloud services disable:

Linux, macOS o Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

Deberías recibir una respuesta similar a la siguiente:

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Para inhabilitar varios servicios, usa nombres de servicios delimitados por espacios. Por ejemplo, el siguiente comando inhabilita los servicios BigQuery y Pub/Sub:

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

Para obtener los detalles de la operación, usa el comando gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Sustituye OPERATION_ID por el ID de operación que has recibido en respuesta a tu solicitud original.

API REST

Para inhabilitar un servicio, utiliza el método services.disable.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: tu ID de proyecto Google Cloud.
• SERVICE: el nombre del servicio que quieras inhabilitar.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Ejecuta el comando siguiente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

Si la solicitud se realiza correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Operation:

{
  "name": "operations/OPERATION_ID"
}

Nota: De forma predeterminada, la API Service Usage está habilitada en los proyectos, pero si la has inhabilitado en el proyecto que realiza la solicitud para inhabilitar un servicio, recibirás un error cuando intentes hacer la solicitud. Para solucionar este problema, usa la consola de Google Cloud o Google Cloud CLI para volver a habilitar la API de Uso de Servicio en el proyecto que realiza la solicitud.

Comprobar el estado de una operación de larga duración

Si usas el método para habilitar o inhabilitar, se devuelve una operación de larga duración (LRO). La LRO monitoriza el estado de la solicitud e indica si se ha completado el cambio en el servicio.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

OPERATION_ID: el identificador de la operación. Recibes este ID en la respuesta a tu solicitud original.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Ejecuta el comando siguiente:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Puedes comprobar la cuenta activa en ese momento ejecutando gcloud auth list.

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

Cuando el campo done tiene el valor true, la operación se completa.