Gestion des instantanés Block Storage for VPC
Gérez les instantanés d' Block Storage for VPC s en les renommant, en leur attribuant des balises, en activant la restauration rapide, en les supprimant et en vérifiant leur accès et leur état.
Désignation des instantanés
Envisagez de nommer l'image instantanée de sorte à indiquer le volume que vous avez copié. Par exemple, my-volume serait my-volume-snapshot1. En outre, pour une identification rapide, envisagez de nommer les volumes d'amorçage en ajoutant boot comme préfixe, par exemple, boot_my-volume-snapshot1. A mesure que votre liste d'images instantanées s'allonge, vous pouvez rapidement identifier le nom et le type du volume à partir duquel vous avez créé l'image instantanée.
Les noms d'image instantanée respectent les mêmes exigences que les noms de volume. Les noms valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Les noms d'image instantanée doivent commencer par une lettre minuscule et être uniques sur le VPC. L'interface utilisateur permet de vérifier les noms pour plus de commodité. Par exemple, si vous terminez un nom d'image instantanée par un trait d'union (-), l'interface utilisateur vous informe de l'erreur. Elle recherche également les noms en double.
Lorsque vous créez une copie interrégionale d'un instantané, le nouvel instantané est nommé [copy]-[source-snapshot-name]. Par exemple, une copie interrégionale de snapshot-my-volume-snapshot1_ est automatiquement nommée copy-my-volume-snapshot1 lorsqu'elle est placée dans la région cible. Les copies interrégionales des images instantanées sont indépendantes de l'image instantanée source et du volume source, et les copies peuvent être gérées comme n'importe quelle autre image instantanée
normale.
Renommer un instantané dans la console
Suivez les étapes ci-dessous pour renommer un instantané dans la console.
- Accédez à la liste des instantanés. Dans la console IBM Cloud, allez dans menu
> Infrastructure 
> Stockage > Instantanés. - Cliquez sur le nom d'un instantané dans la liste.
- Cliquez sur l'icône Editer
. - Entrez un nouveau nom pour l'image instantanée, puis sauvegardez et confirmez vos modifications.
Renommer un instantané depuis l'interface de ligne de commande
Prérequis pour l'émission de commandes à partir de l'interface de ligne de commande
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.
Connectez-vous sur IBM Cloud®.
ibmcloud login --sso -a cloud.ibm.com
Cette commande renvoie une URL et des invites pour un code d'accès. Accédez à cette URL dans votre navigateur et connectez-vous. En cas de réussite, vous obtenez un code d'accès à usage unique. Copiez ce code et collez-le en réponse à l'invite. Une fois l'authentification réussie, vous êtes invité à choisir votre compte. Si vous avez accès à plusieurs comptes, sélectionnez celui avec lequel vous souhaitez vous connecter. Répondez à toutes les invites restantes pour terminer la connexion.
Renommer un instantané depuis l'interface de ligne de commande
Vous pouvez renommer un instantané depuis l'interface de ligne de commande.
Pour renommer une image instantanée, exécutez la commande ibmcloud is snapshot-update et indiquez l'ID de l'image instantanée et le nouveau nom.
ibmcloud is snapshot-update SNAPSHOT_ID --name SNAPSHOT_NAME
Consultez l'exemple suivant.
ibmcloud is snapshot-update r138-e6664842-b370-496a-9ae7-da3fb647707c --name snappy-snap-snap
Updating snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...
ID r138-e6664842-b370-496a-9ae7-da3fb647707c
Name snappy-snap-snap
CRN crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-e6664842-b370-496a-9ae7-da3fb647707c
Status stable
Clones Zone Available Created
eu-de-3 true 2023-02-17T20:28:53+00:00
eu-de-1 true 2023-02-17T18:53:57+00:00
Source volume ID Name
r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa vicky-block-test1
Bootable false
Encryption provider_managed
Encryption key -
Minimum capacity(GB) 20
Size(GB) 1
Resource group ID Name
a0eb5d9062af485fa5bb2c6999c74eac test-snap
Created 2023-02-17T18:53:57+00:00
Captured at 2023-02-17T18:53:57+00:00
Tags -
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-update.
Modifier la propriété Allowed Use d'un instantané à partir de l'interface de ligne de commande
Les propriétés de Allowed Use sont héritées du volume parent. Vous pouvez utiliser la commande ibmcloud is snapshot-update pour modifier ces valeurs.
Vous devez avoir le rôle IAM is.volume.volume.manage-allowed-use pour modifier ces propriétés d'un instantané.
ibmcloud is snapshot-update r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 --allowed-use-api-version "2025-03-03" --allowed-use-bare-metal-server "enable_secure_boot==true" --allowed-use-instance true
Updating snapshot r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 under account Test Account as user test.user@ibm.com...
ID r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Name my-bootable-snapshot
CRN crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Status stable
Clones Zone Available Created
Source volume ID Name Remote Region CRN Resource type
r006-9a40241d-d116-4fc3-83ea-6134d30ee33c fence-denture-mosaic-royal - crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-9a40241d-d116-4fc3-83ea-6134d30ee33c volume
Backup policy plan -
Snapshot Copies -
Bootable true
Encryption provider_managed
Encryption key -
Source Snapshot -
Minimum capacity(GB) 100
Size(GB) 1
Source Image ID Name Remote Region CRN Resource type
r006-d734b459-b5a0-4777-8600-9fa3254d2cea ibm-ubuntu-24-04-6-minimal-amd64-2 - crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-d734b459-b5a0-4777-8600-9fa3254d2cea image
Operating system Name Vendor Version Family Architecture Display name
ubuntu-24-04-amd64 Canonical 24.04 LTS Noble Numbat Minimal Install Ubuntu Linux amd64 Ubuntu Linux 24.04 LTS Noble Numbat Minimal Install (amd64)
Resource group ID Name
6edefe513d934fdd872e78ee6a8e73ef defaults
Created 2025-02-17T17:08:15+00:00
Captured at 2025-02-17T17:08:15+00:00
Tags -
Service Tags -
Storage Generation 1
Allowed Use API Version 2025-03-03
Allowed Use Bare Metal Server enable_secure_boot==true
Allowed Use Instance true
Les propriétés comprennent une expression booléenne en langage d'expression commune. Lorsque l'expression est évaluée à true,
le provisionnement d'une instance de serveur virtuel ou d'un serveur bare metal est autorisé avec l'instantané. Lorsque l'expression est évaluée à false, le provisionnement est bloqué.
Renommer un instantané via l'API
Vous pouvez renommer un instantané à l'aide de l'API.
Effectuez un appel « PATCH /snapshots » et indiquez l'ID de l'instantané ainsi que son nouveau nom.
curl -X PATCH \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-01-12&generation=2" \
-H "Authorization: Bearer ${API_TOKEN}" \
-d '{
"name": "my-snapshot-renamed"
}'
Vous pouvez utiliser le même appel pour renommer une copie interrégionale. La copie interrégionale est indépendante de l'instantané source et du volume source et peut être gérée comme n'importe quelle autre image instantanée.
Mise à jour d'un instantané avec Terraform
Pour utiliser Terraform, téléchargez le CLI Terraform et configurez le plug-in IBM Cloud Provider. Pour plus d'informations, voir Initiation à Terraform.
Les services d'infrastructure VPC utilisent un noeud final régional spécifique, qui cible us-south par défaut. Si votre VPC est créé dans une autre région, veillez à cibler la région appropriée dans le bloc fournisseur du fichier
provider.tf.
Consultez l'exemple suivant de ciblage d'une région autre que la région par défaut us-south.
provider "ibm" {
region = "eu-de"
}
Pour mettre à jour un instantané, utilisez la ressource ibm_is_snapshot. Vous pouvez modifier le nom de l'instantané, les zones de restauration rapide et les balises. Cependant, la modification des valeurs resource_group et source_volume oblige Terraform à supprimer le snapshot et à en créer un autre.
resource "ibm_is_snapshot" "example" {
name = "my-snapshot"
source_volume = ibm_is_volume.example.id
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_snapshot.
Partager un instantané avec un autre compte dans la console
Vous pouvez partager un instantané avec un autre compte dans la console.
- Accédez à la liste des instantanés. Dans la console IBM Cloud, allez dans menu > Infrastructure > Stockage > Instantanés.
- Dans le menu Actions
, sélectionnez Partager l'instantané. - Saisissez l'ID du compte avec lequel vous souhaitez partager l'instantané.
- Cliquez sur Créer une autorisation IAM personnalisée.
Vous pouvez également créer une autorisation de service à service par le biais du menu Gestion > Accès (IAM) > Autorisations. Pour plus d'informations, voir Création d'une autorisation de service à service pour la restauration inter-comptes dans la console.
Gestion des autorisations de partage pour un instantané dans la console.
-
Accédez à la liste des instantanés. Dans la console IBM Cloud, allez dans menu
> Infrastructure > Stockage > Instantanés. -
Dans le menu Actions
, sélectionnez Gérer les autorisations de partage. -
Le panneau latéral affiche la liste des comptes avec lesquels vous avez partagé votre instantané.
La liste affiche toutes les autorisations qui ont été définies pour l'instantané. Par exemple, si un compte dispose d'une autorisation pour cet instantané spécifique et d'une autorisation pour tous les instantanés de votre compte, ce compte est répertorié deux fois.
-
Cliquez sur Gestion de l'autorisation IAM pour accéder à la page Autorisation afin de modifier ou de révoquer l'autorisation.
Vous pouvez également gérer une politique d'autorisation de service à service directement via le menu Gestion > Accès (IAM) > Autorisations. Pour plus d'informations, voir Utilisation des autorisations d'octroi d'accès entre services.
Partage d'un instantané avec un autre compte à partir de l'interface de gestion
Vous pouvez créer une autorisation de service à service pour un instantané spécifique à partir de la CLI en utilisant la commande ibmcloud iam authorization-policy-create. Pour plus d'informations, voir Création d'une autorisation de service à service pour la restauration inter-comptes à partir de l'interface de commande.
Gestion des autorisations de partage d'un instantané à partir de l'interface de gestion
Vous pouvez supprimer une autorisation de service à service pour un instantané spécifique à partir de la CLI en utilisant la commande authorization-policy-delete. Pour plus d'informations, voir Suppression d'une autorisation à l'aide de l'interface de programmation.
Partager un instantané avec un autre compte à l'aide de l'API
Vous pouvez créer par programme une autorisation de service à service pour un instantané spécifique en appelant la méthode policies dans IAM Policy Management API. Pour
plus d'informations, voir Création d'une autorisation de service à service pour la restauration inter-comptes avec l'API.
Gérer les autorisations de partage d'un instantané avec l'API
Vous pouvez révoquer par programme une autorisation de service à service pour un instantané spécifique en appelant la méthode policies dans IAM Policy Management API.
Pour plus d'informations, voir Suppression d'une autorisation à l'aide de l'API.
Modification des zones de restauration rapide dans la console
Suivez les étapes suivantes pour modifier les zones dans lesquelles les clones de restauration rapide sont stockés dans la console. Vous pouvez ajouter ou supprimer des zones selon vos besoins.
- Sélectionnez un instantané dans la liste des instantanés.
- Dans le menu Actions , sélectionnez Editer la restauration rapide.
- Dans le panneau latéral, sélectionnez ou désélectionnez les zones à restaurer rapidement dans votre région. Passez en revue la mise à jour de la facturation en fonction de votre sélection.
- Cliquez sur Sauvegarder. Vous revenez à la page des détails des instantanés. La section Restauration rapide affiche initialement la nouvelle zone avec le statut en attente .
Les informations de restauration rapide sont mises à jour lors de l'actualisation. Les informations de zone sont mises à jour pour afficher les éléments activés ou désactivés, en fonction de vos modifications.
Création d'un clone d'instantané pour la restauration rapide à partir de l'interface de ligne de commande
Pour créer une copie de zone d'un instantané, exécutez la commande ibmcloud is snapshot-clone-create avec l'ID d'instantané et la ou les zones dans lesquelles vous souhaitez créer des copies. L'exemple de commande suivant crée le
clone de restauration rapide de r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 dans la zone eu-de-3.
ibmcloud is snapshot-clone-create r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 --zone eu-de-3
Creating zonal clone of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone eu-de-3
Available false
Created 2023-02-17T20:29:21+00:00
Href https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3
Le clone d'instantané semble indisponible lors de la création du clone d'instantané. Cela ne prend que quelques secondes. Exécutez la commande ibmcloud is snapshot-cl avec l'ID d'instantané et la zone cible clone pour voir le nouveau
clone d'instantané comme étant disponible.
ibmcloud is snapshot-cl r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3
Getting zonal clone eu-de-3 of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone eu-de-3
Available true
Created 2023-02-17T20:29:21+00:00
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-clone-create.
Suppression d'un clone d'instantané à partir de l'interface de ligne de commande
Pour supprimer un clone d'instantané, exécutez la commande ibmcloud is snapshot-clone-delete avec l'ID d'instantané et la zone dans laquelle vous souhaitez que la copie d'instantané soit supprimée. L'exemple de commande suivant
supprime la copie de restauration rapide de l'instantané r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 dans la zone eu-de-3.
@$ ibmcloud is snapshot-clone-delete r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3
This will delete zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 and cannot be undone. Continue [y/N] ?> y
Deleting zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
OK
Deletion request for zonal snapshot clone eu-de-3 has been accepted.
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-clone-delete.
Création d'un clone d'instantané pour une restauration rapide à l'aide de l'API
Pour créer des instantanés de restauration rapide, vous créez un clone de l'instantané dans une autre zone. Vous restaurez ensuite un volume à partir de ce clone.
Dans l'API, vous créez un clone pour un instantané existant en effectuant un appel PUT /snapshots/{id}/clones/{zone_name} pour cloner l'instantané dans la zone spécifiée. Consultez l'exemple suivant.
curl -X PUT \
"$vpc_api_endpoint/v1/snapshots/5e160469-0837-48a7-8973-e44c8d5fd85a/clones/us-south-1&version=2025-02-18&generation=2" \
-H "Authorization: Bearer ${API_TOKEN}"
Une réponse réussie ressemble à celle de l'exemple ci-après.
{
"available": true,
"created_at": "2025-02-18T20:35:38.600Z",
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
},
"storage_generation": 1,
}
Vous pouvez également spécifier la propriété clone lorsque vous créez une image instantanée d'un volume. Consultez l'exemple suivant.
curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2025-02-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"clones": [{"zone": {"name": "us-south-1"}}],
"name": "my-snapshot2",
"resource_group": {"id": "a342dbfb-3ea7-48d1-96e8-2825ec5feab4"},
"source_volume": {"id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"},
"user_tags": ["env:test","env:prod"]
}'
Une réponse réussie ressemble à celle de l'exemple ci-après.
{
"bootable": false,
"clones": [
"available": true,
"created_at": "2025-02-18T20:18:38.600Z",
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
],
"created_at": "2025-02-18T20:18:18Z",
"crn": "crn:[...]",
"deletable": false,
"encryption": "user_managed",
"encryption_key": {
"crn": "crn:[...]"
},
"storage_generation": 1
}
Suppression d'un clone d'instantané à l'aide de l'API
Effectuez un appel DELETE /v1/snapshots/{id}/clones/{zone-name} pour supprimer un clone d'instantané dans la zone spécifiée. Vous ne pouvez pas annuler la suppression lorsque le clone d'instantané est supprimé.
Consultez l'exemple suivant.
curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/fde0b8d5-2d75-4c28-af7d-12ffc3ae2a55/clones/us-south-1&version=2025-02-18&generation=2" \
-H "Authorization: Bearer ${API_TOKEN}"
Création d'une copie distante dans la console
Procédez comme suit pour créer des copies interrégionales d'instantanés à partir de la liste Instantanés pour VPC ou de la page des détails de l'instantané.
-
Dans la console, cliquez sur l'icône Menu de navigation
> Infrastructure > Stockage > Block Storage snapshots. -
Dans la liste des instantanés, recherchez l'instantané que vous souhaitez dupliquer dans une autre région. Assurez-vous que l'instantané est en état stable.
-
Cliquez sur le menu Actions
et sélectionnez Copier l'instantané. -
Sélectionnez la région dans laquelle vous souhaitez créer la copie.
Vous ne pouvez en posséder qu'un seul exemplaire par région. Si aucune région n'est disponible pour les copies, l'option Copier l'instantané est désactivée.
-
Cliquez sur Créer.
Vous pouvez également cliquer sur le nom de l'instantané pour afficher ses détails. Vous pouvez soit accéder à l'option Copier un instantané à partir du menu Actions, soit accéder à la carte des copies à distance et cliquer sur Créer une copie. Le même panneau de mise à disposition s'ouvre pour vous permettre de sélectionner la région.
Suppression de la copie d'une région distante dans la console
Les copies d'instantané dans une région distante sont indépendantes de l'instantané parent et du volume parent. Vous pouvez les supprimer à tout moment à l'aide de la liste Instantanés pour VPC.
Suivez les étapes suivantes pour supprimer une copie de région distante dans la console.
- Dans la console IBM Cloud, allez dans menu > Infrastructure > Stockage > Instantanés.
- Cliquez sur l'icône Actions dans la ligne de l'instantané à supprimer.
- Sélectionnez Supprimer.
- Confirmez la suppression et cliquez sur Supprimer.
Création d'une copie de région distante à partir de l'interface de ligne de commande
Vous pouvez créer une copie interrégionale d'un instantané à l'aide de la commande snapshot-create avec l'option --source-snapshot-crn et le CRN de l'instantané source, qui crée un instantané dans la région cible à
l'aide du CRN d'un instantané de la région source. L'instantané créé utilise la clé de chiffrement définie par le client si le CRN d'une clé de chiffrement a également été spécifié. Le cliché source doit être en état stable pour que la copie
soit créée avec succès.
ibmcloud is snapshot-create --name my-cli-snapshot-crc --source-snapshot-crn crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8
Creating snapshot my-cli-snapshot-crc under account Test Account as user test.user@ibm.com...
ID r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Name my-cli-snapshot-crc
CRN crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Status pending
Clones Zone Available Created
Source volume ID Name Remote Region
r006-be21061a-4dc6-4c9f-b17d-421838fde399 -remote-421838fde399 us-south
Snapshot Copies ID Name Remote Region CRN Resource type
Bootable true
Encryption provider_managed
Encryption key -
Source Snapshot ID Name Remote Region CRN Resource type
r006-b9590a48-63a3-445e-b819-3f2c0b82daf8 cli-snap-crc-test-sn us-south crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8 snapshot
Minimum capacity(GB) 100
Size(GB) 1
Source Image ID Name Remote Region
r006-24d856e2-6aec-41c2-8f36-5a8a3766f0d6 -remote-5a8a3766f0d6 us-south
Operating system Name Vendor Version Family Architecture Display name
centos-7-amd64 CentOS 7.x - Minimal Install CentOS amd64 CentOS 7.x - Minimal Install (amd64)
Resource group ID Name
cdc21b72d4e647b195de988b175e3d82 Default
Created 2023-04-24T18:54:29+05:30
Captured at 2023-04-24T09:48:03+05:30
Tags -
Service Tags -
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-create
Suppression d'une copie de région distante à partir de l'interface de ligne de commande
Vous pouvez supprimer une copie interrégionale d'un instantané à l'aide de la commande ibmcloud is snapshot-delete avec l'ID instantané.
ibmcloud is snapshot-delete r142-bd4532c0-e73c-44f9-a017-89e5368c521a
This will delete snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a and cannot be undone. Continue [y/N] ?> y
Deleting snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a under account Test Account as user test.user@ibm.com...
OK
Snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a is deleted.
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-delete.
Création d'une copie de région distante avec l'API
Vous pouvez créer une copie interrégionale d'un instantané en effectuant un appel d'API dans la région cible. Spécifiez le CRN de l'instantané source pour créer une copie dans la région cible. L'instantané créé utilise la clé de chiffrement définie par le client si le CRN d'une clé de chiffrement a également été spécifié. Le cliché source doit être en état stable pour que la copie soit créée avec succès. Voir l'exemple suivant, où la région cible est us-east et l'instantané d'origine est us-south.
POST https://us-east.iaas.cloud.ibm.com/v1/snapshots
{
"name": "my-snapshot", // required
"source_snapshot": { // required
"crn": "crn:[...]"
},
"resource_group": { // optional
"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"
},
"encryption_key": "crn:[...]" // optional
}
Une réponse réussie ressemble à celle de l'exemple suivant :
{
"created_at": "2023-05-18T20:18:18Z",
"deletable": false,
"encryption": "user_managed",
"encryption_key": {
"crn": "crn:[...]"
},
"href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
"id": "r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
"lifecycle_state": "pending",
"minimum_capacity": 100,
"name": "my-snapshot",
"operating_system": {
"architecture": "amd64",
"dedicated_host_only": false,
"display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
"family": "Ubuntu Linux",
"gpu_supported": [],
"href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
"name": "ubuntu-20-04-amd64",
"vendor": "Canonical",
"version": "20.04 LTS Focal Fossa Minimal Install"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
"id": "678523bcbe2b4eada913d32640909956",
"name": "Default"
},
"resource_type": "snapshot",
"service_tags": [],
"size": 1,
"source_image": {
"crn": "crn:[...]",
"remote": {
"region": {
"name": "us-south",
"hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
}
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
"id": "r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
"name": "ibm-ubuntu-20-04-minimal-amd64-1"
},
"source_snapshot": {
"crn": "crn:[...]",
"remote": {
"region": {
"name": "us-south",
"hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
}
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-511a798c-5816-4082-8ecb-554a440f83de",
"id": "r006-511a798c-5816-4082-8ecb-554a440f83de",
"name": "my-snapshot-data"
},
"source_volume": {
"crn": "crn:[...]",
"remote": {
"region": {
"name": "us-south",
"hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
}
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-411a798c-5816-4082-8ecb-554a440f83de",
"id": "r006-411a798c-5816-4082-8ecb-554a440f83de",
"name": "my-instance-data"
},
"user_tags": []
}
Suppression d'une copie de région distante d'un instantané à l'aide de l'API
Créez un DELETE /snapshots/{id} dans la région cible où se trouve la copie à distance.
curl -X DELETE https://us-east.iaas.cloud.ibm.com/v1/snapshots/{id}
Création d'une copie interrégionale avec Terraform
Pour créer une copie de l'instantané dans une région distante, utilisez la ressource ibm_is_snapshot. Le cliché source doit être en état stable pour que la copie soit créée avec succès. L'instantané créé utilise la clé de chiffrement
définie par le client si le CRN d'une clé de chiffrement a également été spécifié. L'exemple suivant crée une copie dans la région cible à l'aide de l'ID de l'instantané source. La copie va être chiffrée par la clé de chiffrement spécifiée
par son nom de ressource de cloud.
resource "ibm_is_snapshot" "snapshot" {
name = "my-cross-regional-snapshot"
source_snapshot = "r138-4463eb2c-4913-43b1-b9bf-62a94f74c146"
encryption_key = "crn:bluemix:public:kms:us-south:a/df0564dd126042ebb03e0224728ce939:4957299d-0ba0-487f-a1a0-c724a729b8b4:key:0cb88b98-9261-4d07-8329-8f594b6641b5"
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_snapshot.
Suppression d'une copie de région distante avec Terraform
Utilisez la commande « terraform destroy » pour supprimer facilement un objet distant tel qu'une copie interrégionale d'un instantané. L'exemple suivant illustre la syntaxe de suppression d'un instantané. Remplacez l'ID réel de
l'instantané par ibm_is_snapshot.example.id.
terraform destroy --target ibm_is_snapshot.example.id
Pour plus d'informations, voir Terraform destroy.
Suppression d'instantanés dans la console
Vous pouvez supprimer n'importe quel instantané d'un volume ou tous les instantanés d'un volume. Pour pouvoir supprimer une image instantanée, vous devez respecter les prérequis suivants:
- Avoir l'état
stableoupending. - Ne pas être en train de restaurer un volume.
Pour savoir si vous pouvez supprimer un instantané, il suffit de consulter la liste des instantanés dans la console et de vérifier son état. Vous pouvez supprimer tous les instantanés d'un volume. La suppression de tous les instantanés nécessite une confirmation supplémentaire dans la console.
Suppression d'un seul instantané dans la console
Vous pouvez supprimer un instantané de la liste de tous les instantanés en procédant comme suit.
- Accédez à la liste des instantanés. Dans la console IBM Cloud, allez dans menu > Infrastructure > Stockage > Instantanés.
- Cliquez sur l'icône Actions dans la ligne de l'instantané à supprimer.
- Sélectionnez Supprimer.
- Confirmez la suppression et cliquez sur Supprimer.
Vous pouvez également supprimer un instantané depuis la page de détails d'un volume « Block Storage for VPC ».
- Accéder à la liste de tous les volumes de « Block Storage for VPC ». Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation > Infrastructure > Stockage > Block Storage volumes.
- Sélectionnez un volume dans la liste, puis cliquez sur son nom pour accéder à la page détaillée du volume.
- Cliquez sur Images instantanées. Une liste des instantanés créés pour ce volume s'affiche, et vous pouvez effectuer les actions suivantes :
- Cliquez sur Supprimer tout pour supprimer tous les instantanés de ce volume.
- Cliquez sur l'icône Actions pour supprimer un instantané spécifique.
- Sélectionnez Supprimer. Si le snapshot est en train de restaurer un volume, l'opération de suppression ne fonctionne pas.
- Confirmez la suppression.
Suppression de tous les instantanés d'un volume dans la console
Pour supprimer tous les instantanés d'un volume dans la console, procédez comme suit.
- Accédez à la liste des instantanés. Dans la console IBM Cloud, allez dans menu > Infrastructure > Stockage > Instantanés.
- Cliquez sur la ligne pour sélectionner l'instantané que vous souhaitez supprimer.
- Dans le menu Actions , sélectionnez Supprimer tout pour le volume.
- Confirmez la suppression en entrant delete, puis en cliquant sur Supprimer.
Suppression d'instantanés du Block Storage for VPC page de détails dans la console
Vous pouvez supprimer le snapshot le plus récent de la liste des snapshots depuis la page de détails du volume « Block Storage for VPC ». Vous pouvez éventuellement supprimer tous les instantanés à partir de cette vue.
- Accéder à la liste de tous les volumes de « Block Storage for VPC ». Dans la console IBM Cloud console, allez dans le menu > Infrastructure > Stockage > Block Storage volumes.
- Sélectionnez un volume dans la liste et cliquez sur son nom pour accéder à la page des détails du volume.
- Cliquez sur Images instantanées pour afficher la liste des instantanés de ce volume.
- Cliquez sur Supprimer tout pour supprimer tous les instantanés de ce volume.
- Vous pouvez également sélectionner une seule image instantanée dans la liste pour suppression, puis :
- Cliquez sur l'icône Actions .
- Sélectionnez Supprimer.
- Confirmez la suppression.
- Cliquez sur l'icône Actions
Suppression d'instantanés depuis l'interface de ligne de commande
Vous pouvez supprimer n'importe quel instantané d'un volume ou tous les instantanés d'un volume. Pour pouvoir supprimer une image instantanée, vous devez respecter les prérequis suivants:
- Avoir l'état
stableoupending. - Ne pas être en train de restaurer un volume.
Suppression d'un instantané à partir de l'interface de ligne de commande (CLI)
Procédez comme suit pour supprimer un instantané unique à l'aide de l'interface de ligne de commande.
-
Répertoriez les instantanés disponibles pour un volume afin de confirmer l'ID de l'instantané que vous souhaitez supprimer.
ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME]$ ibmcloud is snapshots --volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa Listing snapshots in all resource groups and region eu-de under account Test Account as user test.user@ibm.com... ID Name Status Source volume Bootable Resource group Created r138-7cac80af-63bb-4a1b-83dd-5f6d550a5db7 bear-peroxide-viewable-oxidant stable r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa false test-snap 2023-02-17T18:49:48+00:00 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 cli-snapshot-test stable r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa false defaults 2023-02-17T20:15:43+00:00 r138-e6664842-b370-496a-9ae7-da3fb647707c snappy-snap-snap stable r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa false test-snap 2023-02-17T18:53:57+00:00 -
Exécutez la commande
snapshot-deleteet indiquez l'ID de l'instantané. Pour supprimer plusieurs instantanés, vous devez spécifier tous leurs ID dans la même commande.ibmcloud is snapshot-delete SNAPSHOT_ID -
Confirmez la suppression de l'instantané. Le message de réponse indique que l'image instantanée est supprimée.
$ ibmcloud is snapshot-delete r138-e6664842-b370-496a-9ae7-da3fb647707c This will delete snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c and cannot be undone. Continue [y/N] ?> y Deleting snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com... OK Snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c is deleted.
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snaphot-delete.
Suppression de tous les instantanés depuis l'interface de ligne de commande
Procédez comme suit pour supprimer tous les instantanés à l'aide de l'interface de ligne de commande.
-
Répertorier tous les instantanés.
ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] -
Saisissez la commande «
snapshots-delete» et indiquez l'ID du volume.ibmcloud is snapshots-delete --volume VOLUME_ID -
Confirmez la suppression des instantanés. Le message de réponse indique quand la demande de suppression d'instantané est acceptée et que les instantanés sont en cours de suppression.
$ ibmcloud is snapshots-delete --volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa This will delete snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa and cannot be undone. Continue [y/N] ?> y Deleting snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa under account Test Account as user test.user@ibm.com... OK Deletion request for snapshots by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa has been accepted.
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snaphot-delete.
Suppression d'instantanés via l'API
Vous pouvez supprimer n'importe quel instantané d'un volume ou tous les instantanés d'un volume. Pour pouvoir supprimer une image instantanée, vous devez respecter les prérequis suivants:
- Avoir l'état
stableoupending. - Ne pas être en train de restaurer un volume.
Suppression d'un instantané à l'aide de l'API
Effectuez un appel « DELETE /snapshots/{snapshot_ID} » pour supprimer un instantané spécifique à l'aide de son identifiant.
curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-22&generation=2" \
-H "Authorization: Bearer ${API_TOKEN}"
Suppression de tous les instantanés d'un volume via l'API
Créez un appel DELETE/snapshots et spécifiez l'ID volume source pour le paramètre source_volume.id de la demande.
curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots?source_volume.id=_volume-id_&version=2022-12-22&generation=2" \
-H "Authorization: Bearer ${API_TOKEN}"
Suppression d'instantanés avec Terraform
Vous pouvez supprimer n'importe quel instantané d'un volume ou tous les instantanés d'un volume. Pour pouvoir supprimer une image instantanée, vous devez respecter les prérequis suivants:
- Avoir l'état
stableoupending. - Ne pas être en train de restaurer un volume.
Suppression d'un instantané unique avec Terraform
Utilisez la commande « terraform destroy » pour supprimer facilement un objet distant tel qu'un instantané unique. L'exemple suivant supprime my-snapshot.
terraform destroy --target ibm_is_snapshot.my-snapshot
Pour plus d'informations, voir Terraform destroy.
Suppression de tous les instantanés d'un volume avec Terraform
Pour supprimer tous les instantanés d'un volume avec Terraform, utilisez la ressource ibm_is_volume.
resource "ibm_is_volume" "storage" {
name = "example-volume"
profile = "general-purpose"
zone = "us-south-1"
delete_all_snapshots = true
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_volume.
Surveillance des états du cycle de vie des instantanés
Le tableau 2 décrit les états d'un instantané au cours de son cycle de vie. Vous pouvez voir ces états dans la console, dans les sorties de commande de l'interface CLI, dans les réponses de l'API et dans les sources de données Terraform.
| Statut de l'instantané | Explication |
|---|---|
| Stable | L'image instantanée est disponible pour la restauration d'un volume. |
| En attente | Les informations sur l'image instantanée sont en cours d'extraction. |
| En attente | Pendant la création de l'image instantanée, le pourcentage d'achèvement est affiché. |
| Echec | La création de l'instantané a échoué; le volume ne peut pas être restauré à partir d'un instantané. |
| Interrompu | L'image instantanée est temporairement indisponible. |
| Mise à jour en cours | Vous avez modifié quelque chose à propos de l'instantané et il est en cours de mise à jour. |
| Suppression en cours | L'instantané est en cours de suppression. |
| Supprimé | L'image instantanée a été supprimée et n'est pas disponible pour restaurer des volumes. |
Etapes suivantes
Vous pouvez restaurer un volume à partir d'une image instantanée.