Google usa tecnología de IA para traducir contenido al idioma que prefieras. Las traducciones generadas por IA pueden contener errores.

Habilitar e inhabilitar servicios

Puedes usar Service Usage 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 Google Cloud consola. 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 consultar los límites de cuota de Service Usage, consulta Cuotas y límites. Es posible 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 entorno para Service Usage.

Consola

Inicia sesión en tu cuenta de Google Cloud . Si es la primera vez que utilizas Google Cloud, 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 para ejecutar, hacer pruebas 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.

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.

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

Instala Google Cloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en 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

Seleccionar un proyecto: para seleccionar un proyecto, no se necesita un rol de gestión de identidades y accesos específico. Puedes seleccionar cualquier proyecto en el que se te haya concedido 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.

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

Seleccionar un proyecto: para seleccionar un proyecto, no se necesita un rol de gestión de identidades y accesos específico. Puedes seleccionar cualquier proyecto en el que se te haya concedido 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.

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

Tener un Google Cloud proyecto en el que quieras habilitar o inhabilitar APIs.
Comprueba que tienes los permisos necesarios para completar esta guía. Si usas un proyecto que has creado, normalmente ya tienes los permisos necesarios.

Roles obligatorios

Para obtener los permisos que necesitas para habilitar e inhabilitar servicios, pide a tu administrador que te asigne el rol de gestión de identidades y accesos de administrador de uso de servicios (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 versión preliminar y requieren aprobación para poder 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 se mantiene confidencial en Google. Lo usamos para conocer el uso de la API y para ponernos en contacto contigo si es necesario.

Consola

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

Ir a la biblioteca de APIs
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.
Haz clic en la API que quieras habilitar o búscala en el cuadro Buscar APIs y servicios.
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 cualquiera de los datos de comando que se indican a continuación, haz las siguientes sustituciones:

SERVICE: el nombre del servicio que quieres 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 servicio 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 cualquiera de los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: tu Google Cloud ID de proyecto.
SERVICE: el nombre del servicio que quieres 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. Para comprobar qué cuenta está activa, ejecuta 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: 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. Para comprobar qué cuenta está activa, ejecuta 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 de Operation recién creada:

{
  "name": "operations/OPERATION_ID"
}

Habilitar 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 la solicitud, haz las siguientes sustituciones:

PROJECT_ID: tu Google Cloud ID de proyecto.
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)

Guarda el cuerpo de la solicitud en un archivo denominado 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)

Guarda el cuerpo de la solicitud en un archivo denominado 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 de Operation recién creada:

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

Inhabilitar un servicio

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

Muchos servicios, como Cloud Storage y BigQuery, cobran por el almacenamiento de datos, y, si inhabilitas la API de estos servicios, no se eliminarán tus datos. En el caso de estos servicios, se te seguirá facturando por el almacenamiento de datos incluso después de que se inhabilite la API. En cambio, si inhabilitas la API de Cloud Run, se eliminarán los recursos asociados a Cloud Run, lo que puede que no sea lo que quieres.

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 evitar cargos futuros y dejar de usar el servicio, elimina todos los datos asociados antes de inhabilitar su API. En el caso de Cloud Run, no inhabilites la API hasta que hayas confirmado que los recursos de Cloud Run que haya se pueden eliminar de forma segura.

Si inhabilitas la API de Kubernetes Engine, los clústeres que se estén ejecutando en el proyecto se suspenderán. Transcurrido ese tiempo, los 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 el artículo Ciclo de vida de los clústeres.

Consola

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

Ir a la biblioteca de APIs
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 inhabilitar una API.
Haz clic en la API que quieras inhabilitar o búscala en el cuadro Buscar APIs y servicios.
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 que se indican a continuación, haz las siguientes sustituciones:

SERVICE: el nombre del servicio que quieres 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 servicio 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 cualquiera de los datos de la solicitud, haz las siguientes sustituciones:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

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)

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 de Operation recién creada:

{
  "name": "operations/OPERATION_ID"
}

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

Si usas el método de habilitación o inhabilitación, se devuelve una operación de larga duración. La LRO hace un seguimiento del estado de la solicitud e indica si se ha completado el cambio en el servicio.

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

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

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)

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 tenga el valor true, la operación se habrá completado.