Angepasste Images verwalten

Nachdem Sie ein benutzerdefiniertes Image in IBM Cloud VPC importiert haben, können Sie Details zum Image anzeigen, den Lebenszyklus des Images verwalten, das Image zur Erstellung einer virtuellen Serverinstanz verwenden, das Image exportieren und sogar mit einem privaten Katalog gemeinsam nutzen.

IBM Cloud® Identity and Access Management (IAM) ermöglicht es Ihnen, Benutzer für Plattformdienste sicher zu authentifizieren und den Zugriff auf Ressourcen plattformübergreifend in der IBM Cloud einheitlich zu steuern. Weitere Informationen zu den Zugriffsanforderungen für angepasste Images finden Sie in den IAM-Rollen und -Aktionen unter Image Service for VPC.

Weitere Informationen zu den $iam_token Variablen und $vpc_api_endpoint in den folgenden Beispielen finden Sie in den Abschnitten Authentifizierung und Endpunkt-URLs in der Einführung in die Virtual Private Cloud-API.

Angepasste Images über die Benutzerschnittstelle verwalten

Zum Verwalten eines Images können Sie die IBM Cloud-Konsole verwenden.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Symbol Infrastruktur VPC > Compute > Images.
  2. Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen' Symbol für weitere Aktionen für ein bestimmtes Image und wählen Sie eine der verfügbaren Optionen aus. Verschlüsselte angepasste Images werden durch ein Schlosssymbol hinter dem Imagenamen gekennzeichnet. Folgende Aktionen stehen zur Auswahl:
Benutzerdefinierte Bildaktionen
Aktion Beschreibung
Umbenennen von Benennen Sie das angepasste Bild um.
Virtuelle Serverinstanz erstellen Erstellen Sie einen neuen virtuellen Server aus dem angepassten Image.
Exportieren Kopieren Sie das angepasste Image nach IBM Cloud Object Storage.
Mit Katalog teilen Geben Sie das angepasste Image IBM Cloud VPC für einen vorhandenen privaten Katalog frei.
Kopieren Kopieren Sie die UUID des angepassten Image.
Kontrollsumme anzeigen Zeigen Sie die Kontrollsumme für das angepasste Image an.
Lebenszyklus planen Öffnet die Anzeige Bildlebenszyklus planen. Sie können eine sofortige Statusänderung vornehmen oder eine Statusänderung für ein zukünftiges Datum und eine zukünftige Zeit planen. Sie können eine einzelne Statusänderung planen oder den vollständigen Lebenszyklus der Images planen. Imagestatus:

  • available: Mit dem Image kann eine Instanz erstellt werden.

  • deprecated: Das Image ist weiterhin für die Bereitstellung und Instanz verfügbar. Die Verwendung des Status deprecated kann die Verwendung des Bildes verhindern, bevor der Status zu obsolete wechselt.

  • obsolete: Das Bild kann nicht zur Bereitstellung einer Instanz verwendet werden.

  • Gesamten Lebenszyklus planen: Sie können sowohl die obsolete Statusänderungen von als deprecated auch von gleichzeitig planen.

Sie können zwischen den drei Status hin- und herwechseln. Es werden nur die Status angezeigt, die Sie ändern können. Sie können Statusänderungen anhand des Kalenderdatums, der Uhrzeit oder der Anzahl der Tage planen. Die veralteten Daten müssen immer nach dem Veraltungsdatum liegen.

Löschen Löschen Sie das angepasste Image.

Wenn Sie ein angepasstes Image in einem privaten Katalog löschen wollen, lesen Sie den Abschnitt Angepasstes Image in einem privaten Katalog löschen.

Angepasste Images über die Befehlszeilenschnittstelle auflisten

Sie können alle angepassten IBM Cloud VPC-Images in Ihrer Region über die Befehlszeilenschnittstelle (CLI) auflisten.

Verwenden Sie den Befehl ibmcloud is images, um alle angepassten Images über die Befehlszeilenschnittstelle aufzulisten. Angepasste Images sind für das Konto, in dem sie erstellt werden, privat, sodass die Option --visibility private lautet.

ibmcloud is images --visibility private

Weitere Informationen finden Sie unter ibmcloud is images auf der Referenzseite zur VPC-CLI.

Alle Bilder mithilfe der API auflisten

Sie können alle IBM Cloud VPC-Images in Ihrer Region mithilfe der Anwendungsprogrammierschnittstelle (API) auflisten.

Verwenden Sie Alle Images auflisten, um alle Images mithilfe der API aufzulisten. Angepasste Images sind privat für das Konto, in dem sie erstellt werden, sodass Sie die Eigenschaft visibility auf private setzen können, um nur angepasste Images abzurufen.

curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Alle Images mit Terraform auflisten

Sie können alle IBM Cloud VPC-Images in Ihrer Region mithilfe von Terraform auflisten.

Verwenden Sie zum Auflisten aller Images mithilfe von Terraform den Terraform-Datenquellenbefehl ibm_is_images. Angepasste Images sind privat für das Konto, in dem sie erstellt wurden, sodass Sie das Attribut visibility auf private setzen können, um nur angepasste Images abzurufen.

data "ibm_is_images" "images" {
  visibility = "public"
}

Anzeigen von Details zu benutzerdefinierten Images über die Benutzeroberfläche

Sie können die folgenden Details eines angepassten Image anzeigen:

  • „allowed-use“-Ausdrücke
  • Zugeordnete Ressourcengruppe
  • Kontrollsumme
  • Erstellungsdatum
  • CRN
  • Datum der Nichtweiterverwendung (falls festgelegt)
  • Verschlüsselungs­typ
  • Standort
  • Name und ID
  • Veraltete Daten (falls festgelegt)
  • Betriebssystem und Version
  • Größe
  • Quellentyp

Sie können den Namen des angepassten Image bearbeiten, Tags für die Suchbarkeit hinzufügen und den eindeutigen Cloudressourcennamen (CRN) anzeigen und kopieren. Der SHA256 Prüfsummenwert für das Bild ist zugänglich.

Führen Sie die folgenden Schritte aus, um Details zu einem angepassten Image anzuzeigen:

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Symbol Infrastruktur VPC > Compute > Images.
  2. Klicken Sie auf der Registerkarte " Benutzerdefinierte Bilder" auf den Namen eines benutzerdefinierten Bildes und dann im nächsten Fenster auf View image details.
  3. Auf der Seite Bilddetails können Sie den Namen des Bildes bearbeiten, die Prüfsumme kopieren, Tags hinzufügen, die CRN für das Bild kopieren und die Ausdrücke für die zulässige Verwendung des Bildes bearbeiten.
  4. Über das Menü Aktionen auf der Seite Image-Details können Sie Aktionen ausführen, z. B. eine virtuelle Serverinstanz aus dem benutzerdefinierten Image erstellen oder das Image löschen. Eine vollständige Liste der möglichen Aktionen finden Sie unter Angepasste Images mithilfe der Benutzerschnittstelle verwalten.

Angepasste Imagedetails über die Befehlszeilenschnittstelle anzeigen

Sie können die Details eines angepassten Image, wie z. B. Name und ID, Betriebssystem und Version, Verschlüsselungsstatus, veraltete oder veraltete Daten und zugeordnete Ressourcengruppe, über die Befehlszeilenschnittstelle anzeigen.

Um die Details eines benutzerdefinierten Images über die CLI anzuzeigen, verwenden Sie den Befehl ibmcloud is image. Geben Sie den Namen oder die ID des angepassten Images mit der Variablen IMAGE an.

ibmcloud is image IMAGE

Weitere Informationen finden Sie unter ibmcloud is image auf der Referenzseite zur VPC-CLI.

Angepasste Imagedetails mithilfe der API abrufen

Sie können die Details eines angepassten Image, wie z. B. Name und ID, Betriebssystem und Version, Verschlüsselungsstatus, veraltete oder veraltete Daten und zugeordnete Ressourcengruppe, über die Anwendungsprogrammierschnittstelle (API) anzeigen.

Um die Details eines bestimmten angepassten Image mithilfe der API abzurufen, verwenden Sie Bild abrufen. Geben Sie für die Variable $image_id die ID des angepassten Image an, das Sie abrufen wollen.

curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Angepasste Imagedetails mithilfe von Terraform abrufen

Mithilfe von Terraform können Sie die Details eines angepassten Image anzeigen, z. B. Name und ID, Betriebssystem und Version, Verschlüsselungsstatus, veraltete oder veraltete Daten und zugeordnete Ressourcengruppe.

Um die Details eines Image mit Terraform anzuzeigen, verwenden Sie den Terraform-Datenquellenbefehl ibm_is_images. Geben Sie für die Variable name den Namen des angepassten Images an, das Sie abrufen wollen.

data "ibm_is_images" "image_name" {
}

Angepasstes Image in IBM Cloud Object Storage exportieren

Sie können ein angepasstes Image in IBM Cloud Object Storageexportieren. Später möchten Sie das Bild möglicherweise in eine neue Region kopieren, indem Sie es erneut importieren. Oder Sie möchten das Bild außerhalb der VPC extrahieren, um es an einem anderen Ort, z. B. vor Ort, zu verwenden. Für das Speichern von Images in IBM Cloud Object Storagekönnen Gebühren anfallen. Weitere Informationen finden Sie unter Abrechnung.

Voraussetzungen

Zum Exportieren eines angepassten Image müssen die folgenden Voraussetzungen erfüllt sein:

Wenn das zu exportierende Image gelöscht wird, während ein Exportjob in Bearbeitung ist, wird der Imagestatus auf deleting gesetzt. Der Exportjob kann abgeschlossen werden, bevor das Image gelöscht wird. Wenn das Löschen des Images abgeschlossen ist, ist der zugehörige Exportjobverlauf nicht verfügbar. Sie können die Ereignisse der Aktivitätsverfolgung für den Exportauftrag verwenden, um seinen endgültigen Status zu bestimmen.

Angepasstes Image über die Benutzerschnittstelle exportieren

Führen Sie die folgenden Schritte aus, um ein angepasstes Image nach IBM Cloud Object Storagezu exportieren.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Symbol Infrastruktur VPC > Compute > Images.
  2. Klicken Sie auf der Registerkarte Angepasste Images auf den Namen des angepassten Images, das Sie exportieren möchten.
  3. Klicken Sie auf der Seite mit den Imagedetails auf das Menü Aktionen und wählen Sie Exportieren aus.
  4. In der Anzeige Angepasstes Image exportieren können Sie optional einen Namen für den Exportjob angeben. Der Name wird zusammen mit dem Imagenamen verwendet, um den Namen des exportierten Objekts in IBM Cloud Object Storagezu erstellen. Wenn Sie keinen Namen angeben, wird automatisch ein Name generiert.
  5. Wählen Sie das Dateiformat für den Export aus. Gültige Dateiformate sind QCOW2 und VHD. Wenn das angepasste Image ein verschlüsseltes Image ist, ist das Format QCOW2 erforderlich.
  6. Geben Sie die IBM Cloud Object Storage-Serviceinstanz und das Bucket an, in die das angepasste Image exportiert werden soll. Alternativ können Sie den CRN für das Bucket IBM Cloud Object Storage angeben, in das Sie das Image exportieren wollen.
  7. Klicken Sie auf Benutzerdefiniertes Bild exportieren.

Angepasstes Image über die Befehlszeilenschnittstelle exportieren

Sie können ein angepasstes IBM Cloud VPC-Image über die Befehlszeilenschnittstelle (CLI) in IBM Cloud Object Storage exportieren.

Verwenden Sie den Befehl ibmcloud is image-export-job-create, um ein angepasstes Image über die Befehlszeilenschnittstelle zu exportieren. Geben Sie mit der Variablen IMAGE den Namen oder die ID des angepassten Image an, das exportiert werden soll. Sie können einen Namen für den Exportjob mit NEW_NAME angeben. Sie können auch das Dateiformat für den Export des Image angeben, entweder qcow2 oder vhd. Das Format qcow2 ist das Standarddateiformat und das erforderliche Format, wenn das angepasste Image verschlüsselt ist. Geben Sie außerdem IBM Cloud Object Storage BUCKET an, wo Sie das angepasste Image exportieren möchten.

ibmcloud is image-export-job-create IMAGE [--name NEW_NAME] [--format qcow2 | vhd] --bucket BUCKET

Im folgenden Beispiel wird ein angepasstes Image mit der ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 exportiert. Der Exportjob hat den Namen my-export-job. Das Dateiformat für den Export des Image ist qcow2. Das Bucket IBM Cloud Object Storage, in dem das exportierte Image den Namen my-bucket hat.

ibmcloud is image-export-job-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-export-job --format qcow2 --bucket my-bucket

Weitere Informationen finden Sie unter ibmcloud is image-export-job-create auf der Referenzseite der VPC-CLI.

Angepasstes Bild mit der API exportieren

Sie können ein angepasstes IBM Cloud VPC-Image mithilfe der Anwendungsprogrammierschnittstelle (API) in IBM Cloud Object Storage exportieren.

Wenn Sie ein angepasstes Image mithilfe der API exportieren möchten, verwenden Sie Imageexportjob erstellen.

Geben Sie für die Variable $image_id die ID des angepassten Image an, das Sie exportieren möchten. Sie können optional eine aussagekräftige name für den Imageexportjob angeben. In diesem Beispiel lautet der Exportjobname my-image-export. Geben Sie für die Untereigenschaft storage_bucket name den Namen des Buckets IBM Cloud Object Storage an, in das Sie das angepasste Image exportieren möchten. In diesem Beispiel lautet der Bucketname bucket-27200-lwx4cfvcue. Alternativ können Sie die Untereigenschaft crn verwenden, um den CRN des Buckets anzugeben.

curl -X POST \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
  "name": "my-image-export",
  "storage_bucket": {
    "name": "bucket-27200-lwx4cfvcue"
  }
}'

Angepassten Imageexportverlauf anzeigen und verwalten

Sie können den benutzerdefinierten Imageexportverlauf anzeigen, um Details wie den Namen des Exportjobs, den Status, das Zielbucket in IBM Cloud Object Storage, den zugeordneten Objektnamen IBM Cloud Object Storage, das Datum, an dem der Exportjob gestartet wurde, und, wenn der Exportjob abgeschlossen ist, das Fertigstellungsdatum anzuzeigen.

Sie können auch einen abgeschlossenen Imageexportjob löschen. Sie können auch einen in Bearbeitung befindlichen Imageexportjob löschen (und abbrechen), wenn Sie über eine IAM-Rolle verfügen, die die Aktion is.image.image.export enthält.

Wenn Sie einen Imageexportjob löschen, wird er nur aus dem Exportprotokoll entfernt. Die exportierte Bilddatei wird nicht aus dem IBM Cloud Object Storage Bucket entfernt. Sie müssen Dateien, die in IBM Cloud Object Storage gespeichert sind, über die Schnittstellen IBM Cloud Object Storage verwalten.

Schließlich können Sie einen Imageexportjob umbenennen. Durch das Umbenennen des Imageexportjobs wird der Name des Objekts, das in IBM Cloud Object Storageerstellt wird, nicht geändert.

Grenzwerte für Imageexportjobs

Für Imageexportjobs gelten die folgenden Grenzwerte:

  • Fünf aktive Exportjobanforderungen pro Image
  • Insgesamt zehn Exportjobs pro Image
  • Zwanzig aktive Exportjobs pro Konto und Region

Angepasstes Imageexportprotokoll über die Benutzerschnittstelle anzeigen

Führen Sie die folgenden Schritte aus, um den Exportverlauf eines angepassten Image anzuzeigen:

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Symbol Infrastruktur VPC > Compute > Images.
  2. Klicken Sie auf der Registerkarte Benutzerdefinierte Images auf den Namen eines benutzerdefinierten Images, um Details zu diesem Image anzuzeigen.
  3. Klicken Sie auf der Seite Imagedetails auf die Registerkarte Exportprotokoll.

Imageexportjob über die Benutzerschnittstelle löschen oder abbrechen

Führen Sie die folgenden Schritte aus, um einen abgeschlossenen Imageexportjob zu löschen oder einen in Bearbeitung befindlichen Imageexportjob abzubrechen (und zu löschen).

  1. Klicken Sie auf der Seite mit den Bilddetails auf die Registerkarte Exportprotokoll.
  2. Klicken Sie für den Exportjob, den Sie löschen oder abbrechen möchten, auf das Aktionssymbol Symbol für weitere Aktionen und wählen Sie Löschen aus.

Imageexportjob über die Benutzerschnittstelle umbenennen

Führen Sie die folgenden Schritte aus, um einen Imageexportjob umzubenennen.

  1. Klicken Sie auf der Seite mit den Bilddetails auf die Registerkarte Exportprotokoll.
  2. Klicken Sie für den Exportjob, den Sie umbenennen möchten, auf das Aktionssymbol Symbol für weitere Aktionen und wählen Sie Umbenennen aus.

Angepasstes Imageexportprotokoll über die Befehlszeilenschnittstelle anzeigen

Um den Exportverlauf eines bestimmten angepassten Image über die Befehlszeilenschnittstelle anzuzeigen, verwenden Sie den Befehl ibmcloud is image-export-jobs. Geben Sie den Namen oder die ID des angepassten Image an, das mit der Variablen IMAGE exportiert wurde.

ibmcloud is image-export-jobs IMAGE

Das folgende Beispiel zeigt den Exportjobverlauf für ein angepasstes Image mit der ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479.

ibmcloud is image-export-jobs 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479

Weitere Informationen finden Sie unter ibmcloud is image-export-jobs auf der Referenzseite zur VPC-CLI.

Details zum Imageexportjob über die Befehlszeilenschnittstelle anzeigen

Verwenden Sie den Befehl ibmcloud is image-export-job, um die Details eines bestimmten Imageexportjobs über die Befehlszeilenschnittstelle anzuzeigen. Geben Sie den Namen oder die ID des angepassten Image an, das mit der Variablen IMAGE exportiert wurde. Geben Sie den Namen oder die ID des Imageexportjobs mit der Variablen JOB an.

ibmcloud is image-export-job IMAGE JOB

Weitere Informationen finden Sie unter ibmcloud is image-export-job auf der VPC-CLI-Referenzseite.

Imageexportjob über die Befehlszeilenschnittstelle löschen oder abbrechen

Verwenden Sie den Befehl ibmcloud is image-export-job-delete, um einen abgeschlossenen Imageexportjob zu löschen oder einen in Bearbeitung befindlichen Imageexportjob abzubrechen (und zu löschen). Geben Sie den Namen oder die ID des angepassten Image an, das mit der Variablen IMAGE exportiert wurde. Geben Sie den Namen oder die ID des Imageexportjobs mit der Variablen JOB an.

ibmcloud is image-export-job-delete IMAGE JOB

Weitere Informationen finden Sie unter ibmcloud is image-export-job-delete auf der Referenzseite der VPC-CLI.

Imageexportjob über die Befehlszeilenschnittstelle umbenennen

Verwenden Sie den Befehl ibmcloud is image-export-job-update, um einen angepassten Imageexportjob über die Befehlszeilenschnittstelle umzubenennen. Geben Sie den Namen oder die ID des angepassten Image an, das mit der Variablen IMAGE exportiert wurde. Geben Sie den Namen oder die ID des Imageexportjobs mit der Variablen JOB an. Geben Sie mit der Variablen NAME den neuen Namen an, den Sie dem Imageexportjob zuordnen möchten.

ibmcloud is image-export-job-update IMAGE JOB --name NAME

Weitere Informationen finden Sie unter ibmcloud is image-export-job-update auf der VPC-CLI-Referenzseite.

Angepasstes Imageexportprotokoll über die API anzeigen

Um den Exportverlauf eines bestimmten angepassten Image mithilfe der API anzuzeigen, verwenden Sie Alle Imageexportjobs auflisten.

Geben Sie für die Variable $image_id die ID des angepassten Images an, für das Sie Exportjobs anzeigen wollen.

curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Details eines Imageexportjobs über die API anzeigen

Zum Anzeigen der Details eines bestimmten Imageexportjobs mithilfe der API verwenden Sie Imageexportjob abrufen.

Geben Sie für die Variable $image_id die ID des angepassten Image an, das exportiert wurde. Geben Sie für die Variable $export_job_id die ID des Imageexportjobs an, für den Sie Details abrufen wollen.

curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Imageexportjob über die API löschen oder abbrechen

Zum Löschen eines abgeschlossenen Imageexportjobs oder zum Abbrechen (und Löschen) eines in Bearbeitung befindlichen Imageexportjobs mithilfe der API verwenden Sie Imageexportjob löschen.

Geben Sie für die Variable $image_id die ID des angepassten Image an, für die Sie einen Exportjob löschen wollen. Geben Sie für die Variable $export_job_id die ID des Imageexportjobs an, den Sie löschen wollen.

curl -X DELETE \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Imageexportjob über die API umbenennen

Um einen angepassten Imageexportjob mithilfe der API umzubenennen, verwenden Sie Imageexportjob aktualisieren.

Geben Sie für die Variable $image_id die ID des angepassten Image an, für das Sie einen Exportjob umbenennen wollen. Geben Sie für die Variable $export_job_id die ID des Imageexportjobs an, den Sie umbenennen möchten. Der neue Name, der dem Imageexportjob im folgenden Beispiel zugeordnet werden muss, lautet my-export-job-patched.

curl -X PATCH \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-export-job-patched"
    }'

Angepasstes Image über die Benutzerschnittstelle mit einem privaten Katalog gemeinsam nutzen

Sie können ein vorhandenes angepasstes IBM Cloud VPC-Image für einen vorhandenen privaten Katalog freigeben. Wenn Sie noch keinen privaten Katalog haben, finden Sie weitere Informationen unter Onboarding eines virtuellen Server-Images für VPC.

Die Aktion Image im privaten Katalog teilen ist für die folgenden Images nicht verfügbar:

  • Das Image wurde bereits in einem privaten Katalog freigegeben. Ein Image in einem privaten Katalog kann nur in einer Version innerhalb eines Produktangebots in einem privaten Katalog vorhanden sein. Sie müssen das Image aus der Version entfernen, in der es sich befindet, bevor es in einer anderen Version gemeinsam genutzt werden kann.
  • Das Image ist verschlüsselt.
  • Das Image ist kein x86-Image.

Führen Sie die folgenden Schritte aus, um ein angepasstes Image für einen privaten Katalog freizugeben.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü-Symbol > Symbol Infrastruktur VPC > Compute > Images.
  2. Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen' Symbol für weitere Aktionen und wählen Sie Im Katalog gemeinsam nutzen aus.
  3. Wählen Sie auf der Seite Image für privaten Katalog freigeben einen privaten Katalog aus der Liste der verfügbaren privaten Kataloge aus.
  4. Geben Sie eine Versionsnummer in Softwareversion ein.
  5. Klicken Sie auf Katalogangebot erstellen, um das Image für den privaten Katalog freizugeben.
  6. Nachdem das Image erstellt wurde, klicken Sie auf Image validieren.

Bei diesem Vorgang wird das benutzerdefinierte Bild nur für den privaten Katalog freigegeben. Der Validierungsprozess findet im privaten Katalog statt. Wenn Sie auf Image validieren klicken, wird eine neue Seite angezeigt. In dieser Anzeige können Sie mit Schritt 3: Image des virtuellen Servers im Onboarding eines Image eines virtuellen Servers für VPC validieren beginnen, um den Validierungsprozess abzuschließen.

Angepasstes Image über die Befehlszeilenschnittstelle für einen privaten Katalog freigeben

Sie können ein benutzerdefiniertes Bild nur über die Benutzeroberfläche in einem privaten Katalog von IBM Cloud VPC teilen. Weitere Informationen zum Onboarding in einen privaten Katalog mithilfe der CLI finden Sie unter Onboarding von Software in Ihr Konto.

Angepasstes Image mithilfe der API in einem privaten Katalog gemeinsam nutzen

Sie können ein benutzerdefiniertes Bild nur über die Benutzeroberfläche in einem privaten Katalog von IBM Cloud VPC teilen. Weitere Informationen zum Onboarding in einen privaten Katalog mithilfe der API finden Sie unter Onboarding von Software in Ihr Konto.

Angepasstes Image mit Terraform in einem privaten Katalog gemeinsam nutzen

Sie können ein benutzerdefiniertes Bild nur über die Benutzeroberfläche in einem privaten Katalog von IBM Cloud VPC teilen. Weitere Informationen zum Onboarding in einen privaten Katalog mithilfe von Terraform finden Sie unter Onboarding von Software in Ihr Konto.

Planen Sie eine benutzerdefinierte Änderung des Image-Lebenszyklusstatus in der Konsole

Sie können eine Änderung des Lebenszyklusstatus eines einzelnen Images oder die Statusänderungen für den gesamten Lebenszyklus des Image planen. Sie können eine sofortige Statusänderung nur vornehmen, wenn Sie keine zukünftige Statusänderung geplant haben.

Führen Sie die folgenden Schritte aus, um eine einzelne Statusänderung zu planen:

Sie können eine einzelne Statusänderung für ein Image planen.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenüsymbol Menüsymbol > Infrastruktur- VPC-Symbol > Compute > Images.
  2. Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen' Symbol für weitere Aktionen für ein bestimmtes Image und wählen Sie eine der verfügbaren Optionen aus.
  3. Wählen Sie Lebenszyklus planen aus.
  4. Wählen Sie unter Imagestatus die Statusänderung für das Image aus.
  5. Wählen Sie unter Details zu veralteten Features aus, ob der Status Sofort oder Datum in der Zukunft planen geändert werden soll.
  6. Wenn Sie "Termin in der Zukunft" gewählt haben, müssen Sie die folgenden Felder ausfüllen:
    • Wählen Sie Nach Kalenderdatum oder Nach Anzahl der Tage aus.
      • Wenn Sie Nach Kalenderdatum ausgewählt haben, geben Sie das Datum und die Uhrzeit ein. Dies ist der Zeitpunkt (Datum und Uhrzeit), zu dem die Statusänderung erfolgt.
      • Wenn Sie Nach Anzahl der Tage ausgewählt haben, geben Sie an, wie viele Tage vergehen, bevor der Status geändert wird.
  7. Klicken Sie auf Speichern.

Führen Sie die folgenden Schritte aus, um den gesamten Lebenszyklus des Image zu planen:

Sie können den vollständigen Lebenszyklus für das Image planen. Das Image ist zunächst veraltet und wird dann entsprechend dem von Ihnen definierten Zeitplan in veraltet geändert. Verwenden Sie die folgenden Schritte, um eine Lebenszyklusänderung zu planen.

  1. Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenüsymbol Menüsymbol > Infrastruktur- VPC-Symbol > Compute > Images.

  2. Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen' Symbol für weitere Aktionen für ein bestimmtes Image und wählen Sie eine der verfügbaren Optionen aus.

  3. Wählen Sie Lebenszyklus planen aus.

  4. Wählen Sie Kompletten Lebenszyklus planen.

    • Wenn Sie Nach Kalenderdatum ausgewählt haben, geben Sie das Datum und die Uhrzeit für die Statusänderung ein.
    • Wenn Sie Nach Anzahl von Tagen ausgewählt haben, geben Sie die Anzahl der Tage an, die vergehen sollen, bis der Status geändert wird.

    Das veraltete Datum muss nach dem veralteten Datum liegen.

  5. Klicken Sie auf Zeitplan.

Lebenszyklusstatus des angepassten Image über die Befehlszeilenschnittstelle ändern

Sie können den Lebenszyklusstatus eines angepassten IBM Cloud VPC-Image über die Befehlszeilenschnittstelle (CLI) ändern. Sie können eine sofortige Statusänderung vornehmen, indem Sie den Befehl ibmcloud is image-deprecate oder ibmcloud is image-obsolete verwenden. Sie können diese Statusänderungen auch für einen späteren Zeitpunkt planen, indem Sie den Befehl ibmcloud is image-update verwenden. Geben Sie den Namen oder die ID des angepassten Images mit der Variablen IMAGE an.

Verwenden Sie eines der folgenden Beispiele, um eine sofortige Statusänderung vorzunehmen.

Sie können eine sofortige Statusänderung nur vornehmen, wenn keine zukünftige Statusänderung geplant ist. Informationen zum Entfernen einer geplanten Statusänderung finden Sie unter Geplante Änderung des Lebenszyklusstatus eines angepassten Image über die Befehlszeilenschnittstelle entfernen. Nachdem Sie die geplante Statusänderung entfernt haben, können Sie eine sofortige Statusänderung vornehmen.

  • Ändern Sie den Lebenszyklusstatus des Images in deprecate.

    ibmcloud is image-deprecate IMAGE
    
  • Ändern Sie den Lebenszyklusstatus des Images in obsolete.

    ibmcloud is image-obsolete IMAGE
    

Verwenden Sie das folgende Beispiel, um eine Statusänderung zu planen.

Geben Sie für die Option deprecate-at oder obsolete-at ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.

  • YYYY ist die vierstellige Jahresangabe
  • MM ist die zweistellige Monatsangabe
  • DD ist die zweistellige Tagesangabe
  • T trennt die Datums-und Zeitinformationen
  • hh ist die zweistellige Stundenangabe
  • mm ist die zweistellige Minutenangabe
  • +hh:mm oder -hh:mm ist die UTC-Zeitzone.

Das Datum des 30. September 2023 um 20:00 Uhr in der Zeitzone North American Central Standard Time (CST) wäre also 2023-09-30T20:00:00-06:00.

Wenn Sie das Datum und die Uhrzeit planen, können Sie das aktuelle Datum und die aktuelle Zeit nicht verwenden. Wenn es beispielsweise um 8:00 Uhr am 12. Juni geht, müssen das geplante Datum und die geplante Uhrzeit nach 8:00 Uhr am 12. Juni liegen. Wenn Sie sowohl das Datum deprecate-at als auch das Datum obsolete-at definieren, muss das Datum obsolete-at nach dem Datum deprecate-at liegen.

ibmcloud is image-update IMAGE [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

Wenn Sie die Datums-und Zeiteinträge für deprecate-at und obsolete-at ändern möchten, können Sie diese Befehle erneut ausführen. Die vorherigen Datums-und Zeitangaben werden dann durch die neuen Datums-und Zeitangaben ersetzt.

Zuvor geplante Änderung des Lebenszyklusstatus eines angepassten Images über die Befehlszeilenschnittstelle entfernen

Sie können eine geplante Statusänderung mithilfe der Optionen --reset-deprecate-at oder --reset-obsolete-at entfernen. Wenn Sie eine dieser Optionen mit dem Befehl ibmcloud is image-update verwenden, werden Datum und Uhrzeit aus dem Image entfernt. Das Image ist nicht mehr für diese Statusänderung geplant.

ibmcloud is image-update IMAGE [--reset-deprecate-at] [--reset-obsolete-at]

Wenn Sie sowohl die Option --reset-deprecate-at als auch die Option --reset-obsolete-at verwenden, wird der Imagestatus an availablezurückgegeben.

Ändern Sie den Lebenszyklusstatus angepasster Images mithilfe der API.

Sie können den Lebenszyklusstatus eines angepassten IBM Cloud VPC-Image über die Anwendungsprogrammierschnittstelle (API) ändern. Sie können eine sofortige Statusänderung vornehmen oder eine Statusänderung für einen späteren Zeitpunkt planen.

Verwenden Sie eines der folgenden Beispiele, um eine sofortige Statusänderung vorzunehmen. Geben Sie für die Variable $image_id die ID des angepassten Image für die Statusänderung an.

Sie können eine sofortige Statusänderung nur vornehmen, wenn keine zukünftige Statusänderung geplant ist. Informationen zum Entfernen einer geplanten Statusänderung finden Sie unter Geplante Änderung des Lebenszyklusstatus eines angepassten Images mithilfe der API entfernen. Nachdem Sie die geplante Statusänderung entfernt haben, können Sie eine sofortige Statusänderung vornehmen.

  • Ändern Sie den Lebenszyklusstatus des Images in deprecated.

    curl -X POST "$vpc_api_endpoint/v1/images/$image_id/deprecate?version=2023-02-21&generation=2" -H “Authorization: Bearer $iam_token
  • Ändern Sie den Lebenszyklusstatus des Images in obsolete.

    curl -X POST "$vpc_api_endpoint/v1/images/$image_id/obsolete?version=2023-12-21&generation=2" -H “Authorization: Bearer $iam_token

Verwenden Sie eines der folgenden Beispiele, um eine Statusänderung zu planen.

Geben Sie für die Eigenschaften deprecation_at oder obsolescence_at ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.

  • YYYY ist die vierstellige Jahresangabe
  • MM ist die zweistellige Monatsangabe
  • DD ist die zweistellige Tagesangabe
  • T trennt die Datums-und Zeitinformationen
  • hh ist die zweistellige Stundenangabe
  • mm ist die zweistellige Minutenangabe
  • +hh:mm oder -hh:mm ist die UTC-Zeitzone.

Das Datum des 30. September 2023 um 20:00 Uhr in der Zeitzone North American Central Standard Time (CST) wäre also 2023-09-30T20:00:00-06:00.

Wenn Sie das Datum und die Uhrzeit planen, können Sie das aktuelle Datum und die aktuelle Zeit nicht verwenden. Wenn es beispielsweise um 8:00 Uhr am 12. Juni geht, müssen das geplante Datum und die geplante Uhrzeit nach 8:00 Uhr am 12. Juni liegen. Wenn Sie das Datum und die Uhrzeit für deprecation_at und obsolescence_at definieren, muss das Datum obsolescence_at nach dem Datum und der Uhrzeit für deprecation_at liegen.

  • Planen Sie eine Statusänderung in deprecated.

    curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
     "deprecation_at": "2023-03-01T06:11:28+05:30" }'
    
  • Planen Sie eine Statusänderung in obsolete.

    curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
     “obsolescence_at": "2023-12-31T06:11:28+05:30" }'
    

    Wenn Sie die Datums-und Zeiteinträge für deprecation_at und obsolescence_at ändern möchten, können Sie diese Befehle erneut ausführen. Die vorherigen Datums-und Zeitangaben werden durch die neuen Datums-und Zeitangaben ersetzt.

Lebenszyklusstatus zuvor geplanter angepasster Images mithilfe der API entfernen

Stellen Sie eine PATCH /images -Anforderung zum Entfernen einer geplanten Statusänderung, indem Sie deprecation_at oder obsolescence_at auf nullaktualisieren. Diese Eigenschaftsänderung entfernt das Datum und die Zeit aus dem Image und das Image wird nicht mehr für diese Statusänderung geplant.

  • Um ein Bild von deprecated in availablezu ändern, ändern Sie die Eigenschaft deprecation_at in null.

    curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null }'
    
  • Um ein Image von obsolete in den vorherigen Status zu ändern, ändern Sie obsolescence_at in null. Wenn das Bild zuvor einen anderen Wert als null für deprecation_atenthielt, entfernt diese Eigenschaftsänderung den Status obsolete und ändert ihn wieder in deprecated. Wenn der vorherige Status availablewar, was bedeutet, dass das Image direkt von available nach obsoleteverschoben wurde, wird diese Eigenschaftsänderung von obsolete zurück nach availableverschoben.

    curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": null }'
    
  • Wenn Sie ein Image ändern möchten, für das sowohl die Eigenschaft deprecation_at als auch die Eigenschaft obsolescence_at auf availablezurückgesetzt wurde, müssen Sie sowohl die Eigenschaft deprecation_at als auch die Eigenschaft obsolescence_at aktualisieren.

    curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null, “obsolescence_at": null }'
    

Ändern Sie den Lebenszyklusstatus des benutzerdefinierten Bildes mithilfe von Terraform

Um mithilfe von Terraform eine sofortige Statusänderung vorzunehmen, verwenden Sie die ibm_is_image_deprecate oder ibm_is_image_obsolete ressourcenbefehle. Verwenden Sie eines der folgenden Beispiele. Geben Sie für die Variable name den Namen des angepassten Image für die Statusänderung an.

Sie können eine sofortige Statusänderung nur vornehmen, wenn eine zukünftige Statusänderung nicht geplant ist. Informationen zum Entfernen einer geplanten Statusänderung finden Sie unter Geplante Änderung des Lebenszyklusstatus eines angepassten Image mit Terraform entfernen. Nach dem Entfernen der geplanten Statusänderung können Sie eine sofortige Statusänderung vornehmen.

  • Ändern Sie den Lebenszyklusstatus des Images in deprecated.

    resource "ibm_is_image" "example" {
      name               = "example-image"
      href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
      operating_system   = "ubuntu-16-04-amd64"
      encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
      encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
    }
    resource "ibm_is_image_deprecate" "example" {
      image               = ibm_is_image.example.id
    }
    
  • Ändern Sie den Lebenszyklusstatus des Images in obsolete.

    resource "ibm_is_image" "example" {
      name               = "example-image"
      href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
      operating_system   = "ubuntu-16-04-amd64"
      encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0="
      encryption_key     = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx"
    }
    resource "ibm_is_image_obsolete" "example" {
      image               = ibm_is_image.example.id
    }
    

Verwenden Sie eines der folgenden Beispiele, um eine Statusänderung zu planen.

Geben Sie für das Attribut deprecation_at oder obsolescence_at ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.

  • YYYY ist die vierstellige Jahresangabe
  • MM ist die zweistellige Monatsangabe
  • DD ist die zweistellige Tagesangabe
  • T trennt die Datums-und Zeitinformationen
  • hh ist die zweistellige Stundenangabe
  • mm ist die zweistellige Minutenangabe
  • +hh:mm oder -hh:mm ist die Zeitzone der koordinierten Weltzeit

Das Datum des 30. September 2023 um 20:00 Uhr in der Zeitzone North American Central Standard Time (CST) wäre also 2023-09-30T20:00:00-06:00.

Wenn Sie Datum und Uhrzeit festlegen, können Sie nicht Ihr aktuelles Datum und Ihre aktuelle Uhrzeit verwenden. Wenn es beispielsweise um 8:00 Uhr am 12. Juni geht, müssen das geplante Datum und die geplante Uhrzeit nach 8:00 Uhr am 12. Juni liegen. Wenn Sie das Datum und die Uhrzeit für deprecation_at und obsolescence_at definieren, muss das Datum obsolescence_at nach dem Datum und der Uhrzeit für deprecation_at liegen.

  • Planen Sie eine Statusänderung in deprecated.

    resource "ibm_is_image" "example" {
      name               = "example-image"
      href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
      operating_system   = "ubuntu-16-04-amd64"
      deprecation_at     = "2023-11-28T15:10:00.000Z"
    }
    
  • Planen Sie eine Statusänderung in obsolete.

    resource "ibm_is_image" "example" {
      name               = "example-image"
      href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
      operating_system   = "ubuntu-16-04-amd64"
      obsolescence_at    = "2023-11-28T15:10:00.000Z"
    }
    

    Wenn Sie die Datums-und Zeiteinträge für deprecation_at und obsolescence_at ändern möchten, können Sie diese Befehle erneut ausführen. Die vorherigen Datums-und Zeitangaben werden durch die neuen Datums-und Zeitangaben ersetzt.

Entfernen Sie zuvor geplante benutzerdefinierte Bild-Lebenszyklus-Status mithilfe von Terraform

Zum Entfernen einer geplanten Statusänderung aktualisieren Sie die Attribute deprecation_at oder obsolescence_at auf null. Diese Attributänderung entfernt das Datum und die Zeit aus dem Image und das Image ist nicht mehr für diese Statusänderung geplant.

  • Um ein Bild von deprecated in available zu ändern, ändern Sie die Eigenschaft deprecation_at in null.

    resource "ibm_is_image" "example" {
      name               = "example-image"
      href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
      operating_system   = "ubuntu-16-04-amd64"
      deprecation_at       = null
    }
    
  • Um ein Image von obsolete in den vorherigen Status zu ändern, ändern Sie obsolescence_at in null. Wenn das Image zuvor einen anderen Wert als null für deprecation_at enthielt, entfernt diese Attributänderung den obsolete-Status und ändert ihn wieder in deprecated. Wenn der vorherige Status available war, was bedeutet, dass das Image direkt von available nach obsolete verschoben wurde, wird diese Attributänderung von obsolete zurück nach available verschoben.

    resource "ibm_is_image" "example" {
      name               = "example-image"
      href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
      operating_system   = "ubuntu-16-04-amd64"
      obsolescence_at    = null
    }
    
  • Wenn Sie ein Image ändern möchten, für das die Eigenschaften deprecation_at oder obsolescence_at auf available zurückgesetzt wurden, müssen Sie sowohl das Attribut deprecation_at als auch das Attribut obsolescence_at aktualisieren.

    resource "ibm_is_image" "example" {
      name               = "example-image"
      href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
      operating_system   = "ubuntu-16-04-amd64"
      deprecation_at     = null
      obsolescence_at    = null
    }