Suspender o uso de uma imagem personalizada

O Compute Engine permite suspender o uso de uma imagem personalizada de sua propriedade definindo o status de suspensão de uso dela. Cada status de suspensão de uso gera uma resposta diferente do servidor, o que facilita a transição dos usuários das imagens não compatíveis de uma maneira gerenciável. Use o console do Google Cloud, a Google Cloud CLI ou o método da API Compute Engine para descontinuar uma imagem.

Estados de suspensão de uso

Os estados de suspensão de uso abaixo são compatíveis:

  • ACTIVE: a imagem está ativa e pode ser usada normalmente. As famílias de imagens apontam para a imagem mais recente e ativa em uma família.

  • DEPRECATED: a imagem está marcada como obsoleta, mas ainda pode ser usada para criar uma VM. Novos links para essa imagem são permitidos. As famílias de imagens não apontam mais para essa imagem, mesmo que ela seja a mais recente da família.

    Se você criar uma VM com uma imagem obsoleta usando a CLI do Google Cloud, a solicitação será bem-sucedida com um aviso.

  • OBSOLETE: a imagem está marcada como obsoleta e não está mais disponível para uso. Ao tentar usar essa imagem em uma solicitação, uma mensagem de erro será retornada. Links atuais para essa imagem ainda são permitidos.

  • DELETED: esta imagem foi excluída. Ao tentar usar uma imagem excluída, uma mensagem de erro será retornada.

É possível reverter uma suspensão de uso (ativar uma imagem novamente) alterando o estado de suspensão de uso para ACTIVE.

Antes de começar

Suspender o uso de uma imagem personalizada

Console

  1. No console do Google Cloud, acesse a página Imagens.

    Acessar "Imagens"

  2. Para a imagem que você quer suspender o uso, clique em Ações.

  3. Selecione Suspender o uso.

  4. Para o estado, selecione Suspenso ou Obsoleto. Para mais informações sobre estados, consulte Estados com suspensão de uso.

  5. Opcional: especifique uma imagem de substituição.

  6. Clique em Suspender uso da imagem.

gcloud

Use o comando gcloud compute images deprecate para definir o status de suspensão de uso de uma imagem.

gcloud compute images deprecate IMAGE_NAME \
    --state STATE \
    --replacement REPLACEMENT

Substitua:

  • IMAGE_NAME: o nome da imagem que você quer suspender o uso.
  • STATE: o estado de suspensão de uso.
  • REPLACEMENT: a imagem para substituir a que teve o uso suspenso.

API

Faça uma solicitação POST ao método images().deprecate. Especifique o nome da imagem que você quer suspender.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/RESOURCE_ID/deprecate

{
  "state": "STATE",
  "replacement": "REPLACEMENT"
}

Substitua:

  • PROJECT_ID: o projeto que contém a imagem.
  • RESOURCE_ID: o nome da imagem que terá o uso suspenso.
  • STATE: o estado de suspensão de uso deste recurso.
  • REPLACEMENT: a imagem para substituir a que teve o uso suspenso.