Cómo habilitar e inhabilitar servicios

Puedes usar Service Usage para habilitar o inhabilitar cualquier servicio disponible para tus Google Cloud proyectos. Esto incluye los Google Cloud servicios públicos y 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 los secuencias de comandos, usa Google Cloud CLI. Para acceder a la API de Service Usage de forma programática, te recomendamos que uses una biblioteca cliente. Para probar la API, puedes enviar una solicitud sin configurar un entorno de desarrollo completo.

Para conocer los límites de cuota de Service Usage, consulta Cuotas y límites. Es posible que desees limitar el uso facturable. Según la API, puedes limitar las solicitudes de forma explícita.

Antes de comenzar

Antes de habilitar y, luego, inhabilitar servicios, debes configurar tu proyecto y entorno deGoogle Cloud para Service Usage.

Console

Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar 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.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

gcloud

Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a 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 se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado 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. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un proyecto de Google Cloud :

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

Si usas un proyecto existente en esta guía, verifica que tengas los permisos necesarios para completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

Habilita la API de Service Usage:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

gcloud services enable serviceusage.googleapis.com

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a 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 se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado 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. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un proyecto de Google Cloud :

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

Si usas un proyecto existente en esta guía, verifica que tengas los permisos necesarios para completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

Habilita la API de Service Usage:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

gcloud services enable serviceusage.googleapis.com

Roles obligatorios

Si deseas obtener los permisos necesarios para habilitar y, luego, inhabilitar servicios, pídele a tu administrador que te otorgue el rol de IAM de Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Habilitar un servicio

El proceso para habilitar un servicio puede variar. Algunas APIs te solicitan que primero aceptes sus Condiciones del Servicio o están en versión preliminar y requieren aprobación antes de que puedas usarlas. Otras APIs podrían solicitar información adicional, como los detalles de contacto de tu organización y el nombre de tu aplicación. La información solicitada permanece confidencial dentro de Google. La usamos para comprender el uso de la API y comunicarnos contigo si es necesario.

Console

1. En la consola de Google Cloud , ve a la página Biblioteca de APIs en APIs y servicios >.

   Ir a la biblioteca de la API

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

3. Haz clic en la API que deseas habilitar o búscalo con el cuadro Buscar APIs y servicios.

4. Haz clic en Habilitar.

gcloud

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

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• SERVICE: Es el nombre del servicio que deseas 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 que figura a continuación:

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

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

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

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

gcloud services operations describe operations/OPERATION_ID

Reemplaza OPERATION_ID por el ID de operación que recibiste en respuesta a tu solicitud original.

API de REST

Habilita un solo servicio

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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 supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$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 el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation:

{
  "name": "operations/OPERATION_ID"
}

Habilita varios servicios

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: ID del proyecto de Google Cloud.
• SERVICE1: Es el nombre de un servicio que deseas habilitar.
• SERVICE2: Es el nombre de otro servicio que deseas habilitar.

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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

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

Luego, ejecuta el siguiente comando para enviar tu solicitud de 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 supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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

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

Luego, ejecuta el siguiente comando para enviar tu solicitud de 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 el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation:

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

Inhabilitar un servicio

Puedes inhabilitar una API para un proyecto en cualquier momento. Sin embargo, se te cobrarán las tarifas pendientes y el uso facturable de la API en tus proyectos. Para obtener más información, consulta la guía de Introducción a las API de Cloud.

Muchos servicios, como Cloud Storage y BigQuery, cobran por el almacenamiento de datos. Si inhabilitas la API de un servicio, no se borrarán tus datos y se te seguirá facturando por ella. Para detener los cargos futuros y dejar de usar un servicio, borra todos los datos asociados antes de inhabilitar su API.

Si inhabilitas la API de Google Kubernetes Engine, se suspenderán los clústeres en ejecución en el proyecto. Después de 30 días, se borran los clústeres suspendidos. Para reactivar tus clústeres, vuelve a habilitar la API de GKE. Los clústeres pueden tardar hasta 24 horas en restablecerse. Para obtener más información, consulta Ciclo de vida del clúster.

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

Console

1. En la consola de Google Cloud , ve a la página Biblioteca de APIs en APIs y servicios >.

   Ir a la biblioteca de la API

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

3. Haz clic en la API que deseas inhabilitar o búscalo con 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 cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• SERVICE: Es el nombre del servicio que deseas 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 que figura a continuación:

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

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

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

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

gcloud services operations describe operations/OPERATION_ID

Reemplaza OPERATION_ID por el ID de operación que recibiste en respuesta a tu solicitud original.

API de REST

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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 supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$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 el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation:

{
  "name": "operations/OPERATION_ID"
}

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

El uso del método enable o disable devuelve una operación (LRO) de larga duración. La LRO realiza un seguimiento del estado de la solicitud y también indica si se completó el cambio en el servicio.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

OPERATION_ID: Es el identificador de la operación. Recibirás este ID en la respuesta a tu solicitud original.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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 supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$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 que se muestra a continuación:

{
  "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 se establece como true, la operación está completa.