Compute Engine te permite desactivar una imagen personalizada de tu propiedad configurando el estado de obsolescencia de la imagen. Cada estado de discontinuación provoca una respuesta diferente del servidor, lo que te ayuda a evitar que los usuarios accedan a imágenes que no se admiten de forma sencilla. Usa la Google Cloud consola, Google Cloud CLI o el método de la API de Compute Engine para dejar de usar una imagen.
Estados de desactivación
Se admiten los siguientes estados de obsolescencia:
ACTIVE
: la imagen está activa y se puede usar con normalidad. Las familias de imágenes apuntan a la imagen más reciente y activa de una familia.DEPRECATED
: la imagen está marcada como obsoleta, pero se puede seguir usando para crear una VM. Se permiten nuevos enlaces a esta imagen. Las familias de imágenes ya no hacen referencia a esta imagen, aunque sea la más reciente de la familia.Si creas una VM con una imagen obsoleta mediante la CLI de Google Cloud, la solicitud se completará correctamente, pero se mostrará una advertencia.
OBSOLETE
: la imagen está marcada como obsoleta y ya no se puede usar. Si intentas usar esta imagen en una solicitud, se devuelve un mensaje de error. Se siguen permitiendo los enlaces a esta imagen.DELETED
: esta imagen se ha eliminado. Si intentas usar una imagen eliminada, se devuelve un mensaje de error.
Para revertir una obsolescencia (es decir, volver a activar una imagen), cambia el estado de obsolescencia a ACTIVE
.
Antes de empezar
- Consulta el documento Imágenes.
-
Si aún no lo has hecho, configura la autenticación.
La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
- Set a default region and zone.
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Desactivar una imagen personalizada
Consola
En la Google Cloud consola, ve a la página Imágenes.
En la imagen que quieras retirar, haz clic en
Acciones.Selecciona Obsoleto.
En Estado, selecciona Obsoleto o Antiguo. Para obtener más información sobre los estados, consulta Estados de desactivación.
Opcional: especifique una imagen de sustitución.
Haz clic en Desactivar imagen.
gcloud
Usa el comando
gcloud compute images deprecate
para definir el estado de obsolescencia de una imagen.gcloud compute images deprecate IMAGE_NAME \ --state STATE \ --replacement REPLACEMENT
Haz los cambios siguientes:
IMAGE_NAME
: el nombre de la imagen que se va a dejar de usarSTATE
: el estado de desactivaciónREPLACEMENT
: la imagen que sustituirá a la que ya no está disponible
Go
Java
Python
REST
Realiza una solicitud
POST
al métodoimages().deprecate
. Especifica el nombre de la imagen que quieras retirar.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/RESOURCE_ID/deprecate { "state": "STATE", "replacement": "REPLACEMENT" }
Haz los cambios siguientes:
PROJECT_ID
: el proyecto al que pertenece la imagen.RESOURCE_ID
: el nombre de la imagen que vas a obsoletar.STATE
: el estado de obsolescencia de este recurso.REPLACEMENT
: la imagen que sustituirá a la que ya no está disponible.
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-10 (UTC).
-