Vorbereitende Schritte

1. Vergewissern Sie sich, dass die folgenden CLI-Plug-ins heruntergeladen, installiert und initialisiert wurden:

   • IBM Cloud-Befehlszeilenschnittstelle
   • Plug-in des Infrastrukturservice (infrastructure-service)

   Weitere Informationen finden Sie in der CLI-Referenz.

2. Vergewissern Sie sich, dass bereits eine IBM Cloud VPC-Instanz erstellt wurde.

Erstellen Sie ein Image aus einem Startvolume, das an eine Instanz angehängt ist

1. Um die Instanz zu lokalisieren, aus der Sie ein Image erstellen wollen, listen Sie die Instanzen in der Region auf. Notieren Sie die Instanz-ID in der Befehlsausgabe.

   ibmcloud is instances
   

2. Stoppen Sie die aktive Instanz, bevor Sie das Image aus dem Datenträger erstellen.

   ibmcloud is instance-stop INSTANCE_ID
   

3. Führen Sie den Befehl image-create aus, um ein Image eines Startvolumes zu erstellen. Geben Sie die ID des Quellendatenträgers an.

   ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID]
   

   Sehen Sie sich das folgende Beispiel an:

   $ ibmcloud is image-create test-ifv-vol1 --source-volume ecc68c2f-96a1-4862-bc86-14f47e5d9ed8
   Creating image test-ifv-vol1 in resource group  under account Test Account as user test.user@ibm.com...
   ID                 5b2fd4ee-c636-44c4-9673-453fca36832e
   Name               test-ifv-vol1
   CRN                crn:v1:bluemix:public:is:us-south:a/a123456::image:5b2fd4ee-c636-44c4-9673-453fca36832e
   Status             pending
   Status reason      Code                   Message                                                More info
                      image_request_queued   The image request is accepted and waiting for system   -
                                             resources to become available.
   Operating system   Name             Architecture   Vendor   Version                 Dedicated host only
                      centos-8-amd64   amd64          CentOS   8.x - Minimal Install   false
   Source volume      ID                                     Name
                      ecc68c2f-96a1-4862-bc86-14f47e5d9ed8   aa-1-bx-boot-1617035447000
   Created            2021-05-20T09:43:16+08:00
   Visibility         private
   File size(GB)      -
   Encryption         none
   Resource group     f22cf48f-8836-4527-9131-1d7c73ba85e9
   

Änderungen des Lebenszyklusstatus angepasster Images über die Befehlszeilenschnittstelle planen

Wenn Sie ein benutzerdefiniertes Abbild erstellen, können Sie auch gleichzeitig die Änderungen des Lebenszyklusstatus des benutzerdefinierten Abbilds IBM Cloud VPC planen, indem Sie die Optionen --deprecate-at oder --obsolete-at des Befehls ibmcloud is image-create verwenden.

Um die Eigenschaften deprecate-at oder obsolete-at zu planen, geben Sie ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.

• YYYY steht für das vierstellige Jahr.
• MM ist die zweistellige Monatsangabe.
• DD ist die zweistellige Tagesangabe.
• T trennt die Datums-und Zeitinformationen.
• hh ist die zweistellige Stundenangabe.
• mm bezeichnet die zweistellige Minutenangabe.
• +hh:mm oder -hh:mm ist die koordinierte Weltzeitzone.

Das Datum des 30. September 2025 um 20.00 Uhr in der nordamerikanischen Central-Standard-Zeitzone (CST) ist zum Beispiel 2025-09-30T20:00:00-06:00

Wenn Sie das Datum und die Uhrzeit festlegen, können Sie nicht Ihr aktuelles Datum und Ihre aktuelle Uhrzeit verwenden. Das geplante Datum und die Uhrzeit müssen in der Zukunft liegen. Wenn Sie das Datum und die Uhrzeit für deprecate-at und obsolete-at definieren, muss das Datum deprecate-at nach dem Datum und der Uhrzeit für obsolete-at liegen.

ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

Vorbereitende Schritte

Zur Vorbereitung müssen Sie Ihre API-Umgebung eingerichtet haben.

Image aus einem Boot einer Instanz mit der API erstellen

1. Suchen Sie die Instanz und den Bootdatenträger, aus denen Sie ein Image erstellen möchten. Rufen Sie die Liste der verfügbaren Instanzen mit der Methode list instance ab.

   curl -X GET "$vpc_api_endpoint/v1/instances?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

2. Notieren Sie sich die Instanz-ID und verwenden Sie sie zum Abrufen der Instanzdetails.

   curl -X GET "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

   Die Antwort enthält den Namen, die ID und weitere Details des Bootdatenträgers im Abschnitt volume_attachments.

   "volume_attachments": [
    {
     "device": {
       "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
       },
     "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
     "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
     "name": "my-boot-volume-attachment",
     "volume": {
       "crn": "crn:[...]",
       "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "name": "my-boot-volume"
       }
     }
   ]
   

3. Wenn die Instanz aktiv ist, stoppen Sie sie, indem Sie die Aktion stop in einem POST /instances-Aufruf angeben:

   curl -X POST \
   "$vpc_api_endpoint/v1/instances/{instance-id}/gen/actions?ersion=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"\
   -d '{"type":"stop"}'
   

4. Mithilfe der Bootdatenträger-ID erstellen Sie ein Image. Sehen Sie sich das folgende Beispiel an:

    curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
    -H "Authorization: Bearer $iam_token"
    -d '{
         "name": "my-image",
         "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
         }`
   

   In der Beispielantwort bezeichnet source_volume das Startvolume, das zum Erstellen des Images verwendet wird. Beachten Sie außerdem, dass die Bildverschlüsselung als angezeigt wird, none da für das Quellvolume die standardmäßige, von IBM verwaltete Verschlüsselung verwendet wurde. Wenn Sie Ihren eigenen Root-Schlüssel verwenden, wird in der Antwort stattdessen user-managed angezeigt.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption": "none",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "my-boot-volume"
      }
    }
   

Erstellen eines Images aus einem Volume und Festlegen eines eigenen Verschlüsselungsschlüssels

1. Wie im vorherigen Abschnitt beschrieben, suchen Sie die Instanz und Bootdatenträgerinformationen. Stoppen Sie die -Instanz.

2. Rufen Sie die Instanz-ID des Schlüsselmanagementservice und den CRN des Rootschlüssels ab.

   • Key Protect-Instanz-ID und Cloudressourcennamen(CRN)abrufen.

3. Stellen Sie eine API-Anforderung zum Erstellen eines Image. Geben Sie die Volume-ID und die CRN des Stammschlüssels an, wie im folgenden Beispiel gezeigt.

   curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"
       -d '{
            "name": "my-encrypted-image",
            "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
            "encryption_key":{"crn":"crn:[...key:...]"
           },
   

   Die Antwort enthält Informationen zum Root-Schlüssel.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption_key": {
      "crn": "crn:[...key:...]"
      },
    "encryption": "user_managed",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "ifv-boot-vol"
      }
    }
   

Änderungen des Lebenszyklusstatus angepasster Images mit der API planen

Wenn Sie ein Image von einem Volume erstellen, können Sie gleichzeitig die Lebenszyklus-Statusänderungen des benutzerdefinierten Images planen.

Um die Eigenschaften deprecation_at oder obsolescence_at zu planen, geben Sie 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 koordinierte Weltzeitzone.

Das Datum des 30. September 2023 um 20.00 Uhr in der nordamerikanischen Central-Standard-Zeitzone (CST) ist zum Beispiel 2023-09-30T20:00:00-06:00

Wenn Sie das Datum und die Uhrzeit festlegen, können Sie nicht Ihr aktuelles Datum und Ihre aktuelle Uhrzeit verwenden. Das geplante Datum und die Uhrzeit müssen in der Zukunft 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.

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
      "name": "test-ifv-boot-volume",
      "source_volume": {
    	  "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"
      },
      "deprecation_at": "2025-11-28T06:11:28+05:30",
      "obsolescence_at": "2025-12-28T06:11:28+05:30"
    }'