Avant de commencer

1. Assurez-vous d'avoir téléchargé, installé et initialisé les plug-in de l'interface de ligne de commande suivants :

   • CLI IBM Cloud
   • Le plug-in infrastructure-service

   Pour plus d'informations, voir la référence de l'interface de ligne de commande.

2. Assurez-vous que vous avez créé un IBM Cloud VPC.

Créer une image à partir d'un volume de démarrage associé à une instance

1. Pour localiser l'instance à partir de laquelle vous souhaitez créer une image, répertoriez les instances dans la région. Notez l'ID d'instance dans la sortie de la commande.

   ibmcloud is instances
   

2. Arrêtez l'instance en cours d'exécution avant de créer l'image à partir du volume.

   ibmcloud is instance-stop INSTANCE_ID
   

3. Exécutez la commande image-create pour créer une image d'un volume d'amorçage. Spécifiez l'ID du volume source.

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

   Voir l'exemple suivant :

   $ 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
   

Planification des changements de statut du cycle de vie des images personnalisées à l'aide de l'interface CLI

Lorsque vous créez une image personnalisée, vous pouvez également planifier les changements d'état du cycle de vie de l'image personnalisée IBM Cloud VPC en même temps en utilisant les options --deprecate-at ou --obsolete-at de la commande ibmcloud is image-create.

Pour planifier les propriétés deprecate-at ou obsolete-at, indiquez une date au format de date et d'heure ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

• YYYY correspond à l'année à quatre chiffres.
• MM correspond au mois à deux chiffres.
• DD correspond au jour à deux chiffres.
• T sépare les informations de date et d'heure.
• hh correspond aux heures à deux chiffres.
• mm correspond aux minutes à deux chiffres.
• +hh:mm ou -hh:mm est le fuseau horaire du temps universel coordonné.

Par exemple, la date du 30 septembre 2025 à 20h00 dans le fuseau horaire central nord-américain (CST) est la suivante 2025-09-30T20:00:00-06:00

Lorsque vous planifiez la date et l'heure, vous ne pouvez pas utiliser la date et l'heure actuelles. La date et l'heure prévues doivent se situer dans le futur. Si vous définissez à la fois les dates et heures deprecate-at et obsolete-at, la date deprecate-at doit être postérieure à la date et à l'heure obsolete-at.

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]

Avant de commencer

Avant de commencer, vérifiez que vous avez configuré votre environnement d'API.

Création d'une image à partir d'un amorçage d'une instance à l'aide de l'API

1. Localisez l'instance et le volume d'amorçage à partir de laquelle vous souhaitez créer une image. Obtenez la liste des instances disponibles avec la méthode list instance.

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

2. Notez l'ID d'instance et utilisez-le pour extraire les détails de l'instance.

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

   La réponse contient le nom, l'ID et d'autres détails du volume d'amorçage dans la section 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. Si l'instance est en cours d'exécution, arrêtez-la en spécifiant l'action stop dans un appel POST /instances:

   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. A l'aide de l'ID de volume d'amorçage, créez une image. Voir l'exemple suivant :

    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"}
         }`
   

   Dans l'exemple de réponse, source_volume indique le volume de démarrage utilisé pour créer l'image. Notez également que le chiffrement de l'image apparaît sous la forme none car le volume source utilisait le chiffrement géré par défaut d' IBM. Si vous utilisez votre propre clé racine, la réponse est user-managed.

   {
    "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"
      }
    }
   

Création d'une image à partir d'un volume et définition de votre propre clé de chiffrement

1. Comme décrit dans la section précédente, recherchez l'instance et les informations sur le volume d'amorçage. Arrêtez l'instance.

2. Obtenez votre ID d'instance de service de gestion de clés et votre CRN de clé racine.

   • Key Protect-Extraction de l'ID d'instance et du nom de ressource de cloud(CRN).

3. Effectuez une demande d'API pour créer une image. Spécifiez l'ID du volume et le CRN de la clé racine comme indiqué dans l'exemple suivant.

   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:...]"
           },
   

   La réponse contient des informations sur la clé racine.

   {
    "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"
      }
    }
   

Planification des changements de statut du cycle de vie d'une image personnalisée à l'aide de l'API

Lorsque vous créez une image à partir d'un volume, vous pouvez planifier les changements d'état du cycle de vie de l'image personnalisée en même temps.

Pour planifier les propriétés deprecation_at ou obsolescence_at, indiquez une date au format de date et d'heure ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

• YYYY correspond à l'année à quatre chiffres
• MM correspond au mois à deux chiffres
• DD correspond au jour à deux chiffres
• T sépare les informations de date et d'heure
• hh est le nombre d'heures à deux chiffres
• mm correspond aux minutes à deux chiffres
• +hh:mm ou -hh:mm est le fuseau horaire du temps universel coordonné

Par exemple, la date du 30 septembre 2023 à 20h00 dans le fuseau horaire nord-américain Central Standard (CST) est la suivante 2023-09-30T20:00:00-06:00

Lorsque vous planifiez la date et l'heure, vous ne pouvez pas utiliser la date et l'heure actuelles. La date et l'heure prévues doivent se situer dans le futur. Si vous définissez à la fois les dates et heures deprecation_at et obsolescence_at, la date obsolescence_at doit être postérieure à la date et à l'heure deprecation_at.

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"
    }'