Compute Engine ti consente di deprecare un'immagine personalizzata di tua proprietà impostando lo stato di deprecazione dell'immagine. Ogni stato di ritiro causa una risposta diversa dal server, aiutandoti a impedire l'utilizzo di 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 rimandano all'immagine più recente e attiva di una famiglia.DEPRECATED
: l'immagine è contrassegnata come ritirata, 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 è la più recente della famiglia.Se crei una VM con un'immagine ritirata utilizzando Google Cloud CLI, la richiesta va a buon fine con un avviso.
OBSOLETE
: l'immagine è contrassegnata come obsoleta e non è più disponibile per l'uso. 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. Viene restituito un messaggio di errore se provi a utilizzare un'immagine eliminata.
Puoi ripristinare un ritiro (rendere di nuovo attiva 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 ai Google Cloud servizi e alle API.
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
-
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.
Nella console Google Cloud vai alla pagina Immagini.
Per l'immagine che vuoi ritirare, fai clic su
Azioni.Seleziona Depreca.
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.
IMAGE_NAME
: il nome dell'immagine da ritirareSTATE
: lo stato di ritiroREPLACEMENT
: l'immagine da sostituire a quella ritirataPROJECT_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 ritirata.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a 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.
Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Depreca un'immagine personalizzata
Console
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:
Vai
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:
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-07-14 UTC.
-