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 allontanare gli 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 ritirata 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. Viene restituito un messaggio di errore se provi a utilizzare un'immagine eliminata.
Puoi annullare il ritiro (riattivare un'immagine) modificando lo stato del 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. 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:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.
-
Ritirare un'immagine personalizzata
Nella console Google Cloud, vai alla pagina Immagini.
Per l'immagine che vuoi ritirare, fai clic su
Azioni.Seleziona Rimuovi.
Per lo stato, seleziona Ritirato o Obsoleto. Per ulteriori informazioni sugli stati, consulta Stati di ritiro.
(Facoltativo) Specifica un'immagine sostitutiva.
Fai clic su Ritira immagine.
Utilizza il
comando gcloud compute images deprecate
per impostare lo stato di ritiro di un'immagine.
gcloud compute images deprecateIMAGE_NAME \ --stateSTATE \ --replacementREPLACEMENT
Sostituisci quanto segue:
IMAGE_NAME
: il nome dell'immagine da ritirareSTATE
: lo stato di ritiroREPLACEMENT
: l'immagine da sostituire a quella ritirata
Invia una richiesta POST
al
metodo images().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 di cui stai ritirando il supporto.STATE
: lo stato di ritiro di questa risorsa.REPLACEMENT
: l'immagine da sostituire a quella ritirata.