Mise à jour des pièces jointes du logiciel Snapshot d' Block Storage for VPC

Vous pouvez modifier le nom des fichiers logiciels joints à un instantané.

La mise en service d'une instance de serveur virtuel à partir d'une image de catalogue avec un forfait logiciel entraîne la création d'un volume de démarrage avec une extension logicielle. La pièce jointe contient le plan logiciel et les détails relatifs aux logiciels sous licence. Lorsque vous créez un instantané de ce volume de démarrage, celui-ci hérite de la pièce jointe logicielle. Les instantanés créés avant la mise à disposition de cette fonctionnalité et qui font référence à un forfait de facturation logiciel sont également mis à jour avec une pièce jointe logicielle. Vous pouvez mettre à jour le logiciel associé à l'instantané depuis l'interface de ligne de commande (CLI), l'API ou Terraform.

Mise à jour d'un fichier logiciel joint à un instantané dans la console

La mise à jour d'une pièce jointe logicielle d'instantané n'est pas prise en charge dans la console. Pour mettre à jour une pièce jointe logicielle d'un instantané, suivez les instructions relatives à l'interface de ligne de commande (CLI), à l'API ou à Terraform.

Mise à jour d'un fichier logiciel joint à un instantané à l'aide de l'interface de ligne de commande (CLI)

Avant de pouvoir utiliser l'interface de ligne de commande, vous devez installer l'interface de ligne de commande d'IBM Cloud et le plug-in de l'interface de ligne de commande du VPC. Pour plus d'informations, reportez-vous à la rubrique Configuration requise pour l'interface de ligne de commande.

Pour mettre à jour une pièce jointe logicielle d'instantané, utilisez la commande ibmcloud is snapshot-software-attachment-update. La variable SNAPSHOT correspond à l'ID ou au nom de l'instantané. La variable SWAC correspond à l'ID ou au nom de la pièce jointe logicielle du snapshot. La valeur --name est le nouveau nom donné à la pièce jointe du logiciel de capture instantanée.

ibmcloud is snapshot-software-attachment-update SNAPSHOT SWAC --name NEW_NAME [--output JSON] [-q, --quiet]

L'exemple suivant renomme la pièce jointe logicielle my-snapshot-software-attachment en my-renamed-snapshot-software-attachment pour l'instantané my-snapshot.

ibmcloud is snapshot-software-attachment-update my-snapshot my-snapshot-software-attachment --name my-renamed-snapshot-software-attachment

Pour plus d'informations sur les options de commande disponibles, consultez ibmcloud is snapshot-software-attachment-update.

Récupération d'un fichier joint de type snapshot à l'aide de l'interface de ligne de commande (CLI)

Vous pouvez récupérer une pièce jointe logicielle spécifique d'un instantané par ID ou par nom à partir de l'interface de ligne de commande (CLI). Utiliser ibmcloud is snapshot-software-attachment. La variable SNAPSHOT correspond à l'ID ou au nom de l'instantané. La variable SWAC correspond à l'ID ou au nom de la pièce jointe logicielle de l'instantané.

ibmcloud is snapshot-software-attachment SNAPSHOT SWAC [--output JSON] [-q, --quiet]

  • Pour récupérer une pièce jointe logicielle de type snapshot par ID, indiquez l'ID de la pièce jointe logicielle comme variable SWAC.

    L'exemple suivant récupère la pièce jointe logicielle portant l'ID r134-fbb5d014-5cf1-4bf9-af23-86fc238c3c0a pour l'instantané cli-snap.

    ibmcloud is snapshot-software-attachment cli-snap r134-fbb5d014-5cf1-4bf9-af23-86fc238c3c0a

  • Pour récupérer une pièce jointe logicielle de type snapshot par son nom, indiquez le nom de la pièce jointe logicielle comme variable SWAC.

    L'exemple suivant récupère la pièce jointe logicielle nommée twiddling-thud-stash-reliant pour l'instantané cli-snap.

    ibmcloud is snapshot-software-attachment cli-snap twiddling-thud-stash-reliant

Pour plus d'informations sur les options de commande disponibles, consultez ibmcloud is snapshot-software-attachment.

Mise à jour d'un fichier logiciel joint à un instantané via l'API

Effectuez une demande PATCH /snapshots/{snapshot_id}/software_attachments/{id} et précisez l’ID de l’instantané ainsi que l’ID de la pièce jointe logicielle afin de mettre à jour cette dernière avec les informations fournies dans un objet de correctif de pièce jointe logicielle d’instantané.

L'exemple suivant met à jour une pièce jointe logicielle dont l'ID est pour $software_attachment_id un instantané dont l'ID est $snapshot_id.

curl -X PATCH "https://us-south.iaas.cloud.ibm.com/v1/snapshots/$snapshot_id/software_attachments/$software_attachment_id?version=2026-06-23&generation=2" \
  -H "accept: application/json" \
  -H "Content-Type: application/merge-patch+json" \
  -H "Authorization: Bearer $iam_token" \
  -d '{"name":"my-renamed-snapshot-software-attachment"}'

Pour plus d'informations, consultez la section Mettre à jour une pièce jointe logicielle d'un instantané dans la référence de l'API VPC.

Récupération d'une pièce jointe logicielle d'instantané à l'aide de l'API

Effectuez une demande GET /snapshots/{snapshot_id}/software_attachments/{id} et précisez l'ID de la pièce jointe logicielle et l'ID de l'instantané. Cette requête récupère une seule pièce jointe de logiciel de type snapshot spécifiée par un identifiant figurant dans l' URL.

L'exemple suivant permet de récupérer une pièce jointe logicielle spécifique dont l'ID est pour $software_attachment_id un instantané dont l'ID est $snapshot_id.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/snapshot/$snapshot_id/software_attachments/$software_attachment_id?version=2026-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

Pour plus d'informations, consultez la section Récupérer une pièce jointe logicielle d'instantané dans l'API VPC.

Etapes suivantes