Benutzerdefiniertes Image verwerfen

Linux Windows

Mit Compute Engine können Sie ein benutzerdefiniertes Image verwerfen, dessen Inhaber Sie sind. Hierzu legen Sie den Verwerfungsstatus des Images fest. Jeder Einstellungsstatus führt zu einer anderen Antwort des Servers. Dies hilft Ihnen dabei, Nutzer auf organisierte Art und Weise von nicht mehr unterstützten Images wegzuführen. Zum Verwerfen eines Images können Sie die Google Cloud Console, die Google Cloud-Befehlszeile oder die Compute Engine API verwenden.

Verwerfungsstatus

Die folgenden Verwerfungsstatus werden unterstützt:

ACTIVE: Das Image ist aktiv und kann wie gewohnt verwendet werden. Image-Familien verweisen auf das neueste und aktive Image in einer Familie.
DEPRECATED: Das Image wird als verworfen gekennzeichnet, kann aber weiterhin zum Erstellen einer VM verwendet werden. Neue Links auf dieses Image sind erlaubt. Image-Familien verweisen nicht mehr auf dieses Image, selbst wenn es das neueste Image der Familie ist.

Wenn Sie mit der Google Cloud CLI eine VM mit einem verworfenen Image erstellen, wird die Anfrage mit einer Warnung erfolgreich ausgeführt.
OBSOLETE: Das Image wird als veraltet gekennzeichnet und steht nicht mehr zur Verfügung. Wenn Sie versuchen, dieses Image in einer Anfrage zu verwenden, erhalten Sie eine Fehlermeldung. Vorhandene Links zu diesem Image sind weiterhin zulässig.
DELETED: Dieses Image wurde gelöscht. Wenn Sie versuchen, ein gelöschtes Image zu verwenden, erhalten Sie eine Fehlermeldung.

Sie können eine Einstellung rückgängig machen (ein Image wieder aktivieren). Ändern Sie dazu den Verwerfungsstatus in ACTIVE.

Vorbereitung

Wenn Sie die Befehlszeilenbeispiele in dieser Anleitung verwenden möchten, gehen Sie so vor:
1. Installieren Sie die Google Cloud CLI oder aktualisieren Sie sie auf die neueste Version.
2. Legen Sie eine Standardregion und -zone fest.
Wenn Sie die API-Beispiele dieser Anleitung verwenden möchten, richten Sie den API-Zugang ein.
Lesen Sie das Dokument zu Images.

Benutzerdefiniertes Image verwerfen

Console

Rufen Sie in der Google Cloud Console die Seite Images auf.

Zur Seite „Images“
Klicken Sie für das Image, das Sie verwerfen möchten, auf Aktionen .
Wählen Sie Verwerfen aus.
Für den Status wählen Sie entweder Verworfen oder Veraltet aus. Weitere Informationen zum Status finden Sie unter Verwerfungsstatus.
Optional: Geben Sie ein Ersatz-Image an.
Klicken Sie auf Image verwerfen.

gcloud

Verwenden Sie den Befehl gcloud compute images deprecate, um den Einstellungsstatus eines Images festzulegen.

gcloud compute images deprecate IMAGE_NAME \
    --state STATE \
    --replacement REPLACEMENT

Dabei gilt:

IMAGE_NAME ist der Name des Images, das Sie verwerfen möchten.
STATE ist der Verwerfungsstatus.
REPLACEMENT ist das Image, mit dem das verworfene Image ersetzt werden soll.

API

Stellen Sie eine POST-Anfrage an die Methode images().deprecate. Geben Sie den Namen des Images an, das Sie verwerfen möchten.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/RESOURCE_ID/deprecate

{
  "state": "STATE",
  "replacement": "REPLACEMENT"
}

Dabei gilt:

PROJECT_ID ist das Projekt, zu dem das Image gehört.
RESOURCE_ID ist der Name des Images, das Sie verwerfen.
STATE ist der Verwerfungsstatus dieser Ressource.
REPLACEMENT ist das Image, mit dem das verworfene Image ersetzt werden soll.