Compute Engine ti consente di ritirare un'immagine personalizzata di tua proprietà impostando lo stato di ritiro sull'immagine. Ogni stato di ritiro provoca una risposta diversa del server, consentendoti di eseguire la transizione degli utenti dalle immagini non supportate in modo gestibile. Utilizza la console Google Cloud , Google Cloud CLI o il metodo dell'API Compute Engine per ritirare un'immagine.
Stati di ritiro
Sono supportati i seguenti stati di ritiro:
ACTIVE
: l'immagine è attiva e può essere utilizzata normalmente. Le famiglie di immagini fanno riferimento all'immagine più recente e attiva di una famiglia.DEPRECATED
: l'immagine è contrassegnata come deprecata, ma può comunque essere utilizzata per creare una VM. Sono consentiti nuovi link a questa immagine. Le famiglie di immagini non fanno più riferimento a questa immagine, anche se è l'immagine più recente della famiglia.Se crei una VM con un'immagine deprecata utilizzando Google Cloud CLI, la richiesta viene completata con un avviso.
OBSOLETE
: l'immagine è contrassegnata come obsoleta e non è più disponibile per l'utilizzo. Se provi a utilizzare questa immagine in una richiesta, viene restituito un messaggio di errore. I link esistenti a questa immagine sono ancora consentiti.DELETED
: questa immagine è stata eliminata. Se provi a utilizzare un'immagine eliminata viene visualizzato un messaggio di errore.
Puoi annullare il ritiro (riattivare un'immagine) modificando lo stato di ritiro in ACTIVE
.
Prima di iniziare
- Leggi il documento Immagini.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è
il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Google Cloud .
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su
Compute Engine selezionando una delle seguenti opzioni:
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
-
Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI 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.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI 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.
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Ritira un'immagine personalizzata
Console
Nella console Google Cloud , vai alla pagina Immagini.
Per l'immagine che vuoi ritirare, fai clic su
Azioni.Seleziona Ritira.
Per lo stato, seleziona Deprecato o Obsoleto. Per ulteriori informazioni sugli stati, consulta Stati di ritiro.
(Facoltativo) Specifica un'immagine sostitutiva.
Fai clic su Ritira immagine.
gcloud
Utilizza il comando
gcloud compute images deprecate
per impostare lo stato di ritiro di un'immagine.gcloud compute images deprecate IMAGE_NAME \ --state STATE \ --replacement REPLACEMENT
Sostituisci quanto segue:
IMAGE_NAME
: il nome dell'immagine da ritirareSTATE
: lo stato di ritiroREPLACEMENT
: l'immagine da sostituire a quella deprecata
Go
Java
Python
REST
Invia una richiesta
POST
al metodoimages().deprecate
. Specifica il nome dell'immagine che vuoi ritirare.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/RESOURCE_ID/deprecate { "state": "STATE", "replacement": "REPLACEMENT" }
Sostituisci quanto segue:
PROJECT_ID
: il progetto a cui appartiene l'immagine.RESOURCE_ID
: il nome dell'immagine che stai ritirando.STATE
: lo stato di ritiro di questa risorsa.REPLACEMENT
: l'immagine da sostituire a quella deprecata.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-11 UTC.
-