Ritirare un'immagine personalizzata

Compute Engine ti consente di ritirare un'immagine personalizzata di tua proprietà impostando lo stato di deprecazione sull'immagine. Ogni stato di deprecazione causa una risposta diversa dal server, aiutandoti a trasferire gli utenti dalle immagini non supportate in modo gestibile. Utilizza Google Cloud Console, Google Cloud CLI o il metodo 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 deprecata, ma può comunque essere utilizzata per creare una VM. Sono consentiti nuovi link a questa immagine. Le famiglie di immagini non rimandano più 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 ha esito positivo con un avviso.

  • OBSOLETE: l'immagine è contrassegnata come obsoleta e non può più essere utilizzata. Se provi a utilizzare questa immagine in una richiesta, viene visualizzato 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 un ritiro (rendere di nuovo attiva un'immagine) modificandone lo stato in ACTIVE.

Prima di iniziare

Ritirare un'immagine personalizzata

console

  1. In Google Cloud Console, vai alla pagina Immagini.

    Vai a Immagini

  2. Per l'immagine che vuoi ritirare, fai clic su Azioni.

  3. Seleziona Ritira.

  4. Per stato, seleziona Deprecato o Obsoleto. Per ulteriori informazioni sugli stati, consulta Stati di ritiro.

  5. (Facoltativo) Specifica un'immagine sostitutiva.

  6. Fai clic su Ritira immagine.

gcloud

Usa 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 ritirare
  • STATE: lo stato di ritiro
  • REPLACEMENT: l'immagine per sostituire quella ritirata

Server

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 che ritiri.
  • STATE: lo stato di deprecazione di questa risorsa.
  • REPLACEMENT: l'immagine per sostituire quella ritirata.