O Compute Engine permite suspender o uso de uma imagem personalizada de sua propriedade definindo o status de suspensão de uso na imagem. Cada status de descontinuação causa uma resposta diferente do servidor, ajudando você a fazer a transição dos usuários de imagens não suportadas de maneira gerenciável. Use o console do Google Cloud, a CLI do Google Cloud ou o método da API Compute Engine para descontinuar uma imagem.
Estados de depreciação
Os seguintes estados de descontinuação são suportados:
-
ACTIVE
: a imagem está ativa e pode ser usada normalmente. As famílias de imagens apontam para a imagem mais recente e ativa de uma família. DEPRECATED
: a imagem está marcada como obsoleta, mas ainda pode ser usada para criar uma VM . Novos links para esta imagem são permitidos. As famílias de imagens não apontam mais para esta imagem, mesmo que seja a imagem 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. Uma mensagem de erro será retornada se você tentar usar esta imagem em uma solicitação. Links existentes para esta imagem ainda são permitidos.DELETED
: esta imagem é excluída. Uma mensagem de erro será retornada se você tentar usar uma imagem excluída.
Você pode reverter uma descontinuação (tornar uma imagem ativa novamente), alterando o estado de descontinuação para ACTIVE
.
Antes de começar
- Leia o documento Imagens .
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
No console do Google Cloud, acesse a página Imagens .
Para a imagem que você deseja descontinuar, clique em
Actions .Selecione Descontinuar .
Para estado, selecione Obsoleto ou Obsoleto . Para obter mais informações sobre estados, consulte Estados de descontinuação .
Opcional: Especifique uma imagem de substituição.
Clique em Descontinuar imagem .
-
IMAGE_NAME
: o nome da imagem a ser descontinuada -
STATE
: o estado de descontinuação -
REPLACEMENT
: a imagem para substituir aquela que está obsoleta -
PROJECT_ID
: o projeto ao qual a imagem pertence. -
RESOURCE_ID
: o nome da imagem que você está obsoleta. -
STATE
: o estado de descontinuação deste recurso. -
REPLACEMENT
: a imagem para substituir aquela que está obsoleta.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Descontinuar uma imagem personalizada
Console
gcloud
Use o comando
gcloud compute images deprecate
para definir o status de descontinuação de uma imagem.gcloud compute images deprecate IMAGE_NAME \ --state STATE \ --replacement REPLACEMENT
Substitua o seguinte:
Ir
Java
Pitão
DESCANSAR
Faça uma solicitação
POST
para o métodoimages().deprecate
. Especifique o nome da imagem que você deseja descontinuar.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/RESOURCE_ID/deprecate { "state": "STATE", "replacement": "REPLACEMENT" }
Substitua o seguinte:
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-04-21 UTC.
-