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 Trusted Cloud , a Google Cloud CLI ou o método da API Compute Engine para suspender o uso de 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
- Leia o documento Imagens.
-
Configure a autenticação, caso ainda não tenha feito isso.
A autenticação é
o processo de verificação da sua identidade para acesso a serviços e APIs do Trusted Cloud by S3NS .
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instale a Google Cloud CLI e faça login CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
- Set a default region and zone.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a Google Cloud CLI e faça login CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted Cloud .
Suspender o uso de uma imagem personalizada
Console
No console Trusted Cloud , acesse a página Imagens.
Para a imagem que você quer suspender o uso, clique em
Ações.Selecione Suspender o uso.
Para o estado, selecione Suspenso ou Obsoleto. Para mais informações sobre estados, consulte Estados com suspensão de uso.
Opcional: especifique uma imagem de substituição.
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.
Go
Java
Python
REST
Faça uma solicitação
POST
ao métodoimages().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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-19 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eCompute Engine allows users to deprecate custom images, transitioning users away from unsupported images using different deprecation states.\u003c/p\u003e\n"],["\u003cp\u003eThere are four deprecation states for images: \u003ccode\u003eACTIVE\u003c/code\u003e, \u003ccode\u003eDEPRECATED\u003c/code\u003e, \u003ccode\u003eOBSOLETE\u003c/code\u003e, and \u003ccode\u003eDELETED\u003c/code\u003e, each with different effects on image availability and usage.\u003c/p\u003e\n"],["\u003cp\u003eDeprecated images can still be used to create VMs, but image families no longer point to them, and using them with the gcloud CLI will trigger a warning.\u003c/p\u003e\n"],["\u003cp\u003eObsolete images are no longer available for use, while deleted images are permanently removed, and both will return an error message upon any attempt to be used.\u003c/p\u003e\n"],["\u003cp\u003eUsers can change the deprecation state of an image back to \u003ccode\u003eACTIVE\u003c/code\u003e to make it usable again, which can be done through the Google Cloud Console, gcloud CLI, or the Compute Engine API.\u003c/p\u003e\n"]]],[],null,[]] -