Création d'instantanés Block Storage for VPC
À l'aide de l'interface utilisateur, de la ligne de commande, de l'API ou de Terraform, vous pouvez créer un instantané d'un volume « Block Storage for VPC » de première génération associé à une instance de serveur virtuel en cours d'exécution. Vous pouvez créer un instantané d'un volume de démarrage ou d'un volume de données. Si le volume n'est pas connecté à une instance de serveur, vous ne pouvez pas en créer un instantané.
Dans la version actuelle des volumes de stockage en bloc de deuxième génération, vous pouvez prendre un instantané d'un volume de stockage de deuxième génération même s'il n'est pas attaché à une instance de serveur virtuel en cours d'exécution.
Cette fonction est disponible dans les régions de Dallas (us-south), Francfort (eu-de), Londres (eu-gb), Madrid (eu-es), Osaka (js-osa), Sao Paulo (br-sao), Sydney
(au-syd), Tokyo (jp-tok), Toronto (ca-tor) et Washington (us-east). Les instantanés de groupe de cohérence ne sont pas pris en charge.
Avant de créer un instantané, assurez-vous que toutes les données mises en cache se trouvent bien sur le disque, en particulier lorsque vous créez un instantané d'instances équipées des systèmes d'exploitation Windows et d' Linux®. Par exemple,
sur les systèmes d'exploitation Linux®, exécutez la commande sync pour forcer l'écriture immédiate de toutes les données mises en cache sur le disque.
Vous pouvez créer un groupe de cohérence qui contient des instantanés de plusieurs volumes Gen 1 attachés à une instance de serveur virtuel. Tous les instantanés du groupe de cohérence sont créés en même temps et sont couplés de manière lâche. Pour plus d'informations, voir Création de groupes de cohérence d'instantané.
Création d'un instantané dans la console
Dans la console, vous pouvez créer un instantané d'un volume « Block Storage for VPC » associé à une instance de serveur virtuel en cours d'exécution.
-
Vous pouvez accéder à l'instantané Block Storage pour l'écran de mise à disposition de VPC dans la consoleIBM Cloud® de plusieurs manières.
-
Dans la liste Block Storage pour VPC,
- Cliquez sur l'icône menu de navigation
> Infrastructure
> Stockage > Block Storage snapshots.
- Dans la liste des instantanés, qui est vide au départ, cliquez sur « Créer ».
- Cliquez sur l'icône menu de navigation
-
Dans la liste Block Storage volumes for VPC,
- Cliquez sur l'icône menu de navigation
> Infrastructure
> Stockage > Block Storage volumes.
- Dans la liste des volumes, recherchez un volume d'amorçage ou de données connecté à une instance.
- Cliquez sur l'
et sélectionnez Créer un instantané.
- Cliquez sur l'icône menu de navigation
-
Dans l'écran Block Storage volume details,
-
Accédez à la page des détails du volume de l'une des manières suivantes.
- Cliquez sur l'icône menu de navigation
> Infrastructure
> Compute > Instances de serveurs virtuels. Sélectionnez l'instance qui contient le volume dont vous souhaitez créer un instantané. Dans la page des détails de l'instance, accédez à la liste des volumes connectés et cliquez sur le nom du volume.
- Cliquez sur l'icône menu de navigation
> Infrastructure
> Stockage > Block Storage volumes. Dans la liste des volumes de Block Storage, sélectionnez le volume dont vous souhaitez créer une image instantanée.
- Cliquez sur l'icône menu de navigation
-
Sur la page des détails du volume, sélectionnez Créer un instantané dans le menu Actions.
-
-
-
Entrez les informations requises pour définir votre instantané et sélectionnez le volume Block Storage for VPC dont vous souhaitez créer un instantané.
Sélections pour la création d'un instantané Zone Valeur Emplacement Indiquez la géographie et la région de cet instantané. Type d'instantané Sélectionnez Volume unique. Nom Spécifiez un nom unique pour l'image instantanée. L'interface utilisateur vérifie que ce nom respecte les conventions appropriées et identifie les noms en double. Pour des recommandations de désignation de vos instantanés, voir Désignation des instantanés. Groupe de ressources Sélectionnez un groupe de ressources pour l'image instantanée ou utilisez la valeur par défaut. Vous ne pouvez pas modifier le groupe de ressources après la création de l'image instantanée. Balises Indiquez les balises utilisateur que vous souhaitez utiliser pour identifier cette ressource. Etiquettes de gestion des accès Indiquez des balises de gestion des accès pour cette ressource. Volume Sélectionnez un volume dans la liste. Le volume d'amorçage ou de données doit être connecté à une instance de serveur virtuel en cours d'exécution. Chiffrement Informations de chiffrement pour le volume que vous avez sélectionné, chiffrement géré par le fournisseur ou chiffrement géré par le client. L'image instantanée hérite du chiffrement du volume source. Vous ne pouvez pas modifier le type de chiffrement. Configurations facultatives Copie d'instantané inter-région. Sélectionnez « Copier l'instantané vers une autre région ». Cliquez sur Créer. -
Cliquez sur Créer. Vous revenez à l'écran à partir duquel vous avez commencé. La création d'instantanés est asynchrone. L'instantané est créé immédiatement, mais il reste en attente jusqu'à ce que toutes les données soient transférées vers le référentiel de stockage régional. Des messages s'affichent lors de la création de l'instantané et lorsqu'il est prêt, l'instantané s'affiche dans la liste des instantanés. Pour plus d'informations, voir Afficher les détails de l'instantané dans la console.
Si vous n'êtes pas encore prêt à commander ou si vous cherchez simplement des informations de tarification, vous pouvez ajouter les informations que vous voyez dans le panneau latéral à une estimation. Pour en savoir plus sur le fonctionnement de cette fonctionnalité, consultez la section « Estimation de vos coûts ».
Activation de la restauration rapide des clones d'instantanés dans la console
- Pour activer la fonction de restauration rapide, cliquez sur le nouvel instantané pour afficher ses détails.
- Accédez à la carte Restauration rapide et cliquez sur Editer.
- Dans le panneau latéral, sélectionnez les zones dans lesquelles vous souhaitez activer les clones de restauration rapide.
- Cliquez sur Sauvegarder.
La fonction de restauration rapide est facturée à un tarif horaire supplémentaire pour chaque zone dans laquelle elle est activée, quelle que soit la taille de l'image instantanée. Le maintien de clones de restauration rapide est considérablement plus coûteux que la conservation d'instantanés réguliers.
Créer une copie interrégionale à partir de la liste Instantanés pour VPC
Dans la section précédente, vous avez vu comment créer une copie d'instantané interrégionale lorsque vous prenez un nouvel instantané dans la console. Vous pouvez également créer des copies interrégionales d'instantanés existants.
- Dans la console, cliquez sur l'icône Menu de navigation
> Infrastructure
> Stockage > Block Storage snapshots.
- Dans la liste des instantanés, localisez l'instantané que vous souhaitez copier. 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.
- Cliquez sur Créer.
Création d'un instantanée à partir de l'interface CLI
Avant de commencer
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.comCette 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.
Avant de commencer, rassemblez les informations suivantes:
- Un nom unique pour l'instantané.
- L'identifiant du volume source.
- ID du groupe de ressources. Vous ne pouvez pas modifier le groupe de ressources après la création de l'image instantanée.
- Toutes les balises que vous souhaitez associer à l'instantané.
Utilisez les commandes de l'interface de ligne de commande suivantes pour collecter les informations dont vous avez besoin.
-ibmcloud is volumes- La commande répertorie tous les volumes disponibles dans la région sélectionnée. Localisez le volume dans la liste, vérifiez le statut (available), le type de connexion (boot ou
data) et le groupe de ressources. -
ibmcloud is volume VOLUME_ID- Utilisez cette commande avec l'ID du volume figurant dans la sortie de la commande précédente pour examiner les détails du volume. Si la sortie indique que le volume est disponible, connecté à une
instance et non occupé, vous pouvez créer une image instantanée.
Création d'un instantanée à partir de l'interface CLI
Pour créer un instantané, exécutez la commande ibmcloud is snapshot-create.
ibmcloud is snapshot-create --volume VOLUME [--name NAME] [--clone-zones CLONE_ZONES] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags TAG_NAME1,TAG_NAME2,...] [--output JSON] [-q, --quiet]
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-create.
L'exemple suivant crée une image instantanée avec le nom cli-snapshot-test du volume de données block-test1 dans la région eu-de-2. L'instantané est étiqueté avec env:test et env:prod,
et il possède un clone d'instantané de restauration rapide dans la zone eu-de-1.
ibmcloud is snapshot-create --volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa --name cli-snapshot-test --tags env:test,env:prod --clone-zones eu-de-1
Creating snapshot cli-snapshot-test under account Test Account as user test.user@ibm.com...
ID r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Name cli-snapshot-test
CRN crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Status pending
Clones Zone Available Created
eu-de-1 false 2023-02-17T20:15:46+00:00
Source volume ID Name
r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa block-test1
Bootable false
Encryption provider_managed
Encryption key -
Minimum capacity(GB) 20
Size(GB) 1
Resource group ID Name
6edefe513d934fdd872e78ee6a8e73ef defaults
Created 2023-02-17T20:15:43+00:00
Captured at 0001-01-01T00:00:00+00:00
Tags env:prod,env:test
Le statut indique pending lors de la création de l'instantané. Exécutez la commande ibmcloud is snapshot avec l'ID d'instantané pour afficher le nouvel instantané à l'état stable.
ibmcloud is snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Getting snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
ID r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Name cli-snapshot-test
CRN crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Status stable
Clones Zone Available Created
eu-de-1 true 2023-02-17T20:15:46+00:00
Source volume ID Name
r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa block-test1
Bootable false
Encryption provider_managed
Encryption key -
Minimum capacity(GB) 20
Size(GB) 1
Resource group ID Name
6edefe513d934fdd872e78ee6a8e73ef defaults
Created 2023-02-17T20:15:43+00:00
Captured at 2023-02-17T20:15:44+00:00
Tags env:prod,env:test
Création d'un clone d'instantané de restauration rapide à partir de l'interface de ligne de commande
Vous pouvez créer un clone de restauration rapide à l'aide de la commande ibmcloud is snapshot-clc avec l'ID d'instantané et la spécification de zone cible. Pour plus d'informations sur les options de commande disponibles, voir
ibmcloud is snapshot-clone-create.
L'exemple suivant crée un clone d'instantané de restauration rapide de l'instantané r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 dans la zone eu-de-3.
ibmcloud is snapshot-clc 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é apparaît comme non disponible lors de la création du clone d'instantané. 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
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
La fonction de restauration rapide est facturée à un tarif horaire supplémentaire pour chaque zone dans laquelle elle est activée, quelle que soit la taille de l'image instantanée. Le maintien de clones de restauration rapide est considérablement plus coûteux que la conservation d'instantanés réguliers.
Création d'une copie interrégionale d'un instantané à partir de l'interface de ligne de commande
Pour créer une copie d'un instantané dans une autre région, exécutez la commande ibmcloud is snapshot-create avec l'option --source-snapshot-crn et le CRN de l'instantané source.
Si l'instantané source n'est pas chiffré avec une clé client, le chiffrement de la copie reste géré par le fournisseur. Si l'instantané source est protégé par une clé gérée par le client, vous devez spécifier la clé gérée par le client que vous souhaitez utiliser pour chiffrer la nouvelle copie. Le cliché source doit être en état stable pour que la copie soit créée avec succès.
L'exemple suivant crée un instantané dans la région cible (us-south) à l'aide du CRN d'un instantané de la région source (us-east).
ibmcloud is snapshot-create --name my-cli-snapshot-crc --source-snapshot-crn crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9
Creating snapshot my-cli-snapshot-crc under account Test Account as user test.user@ibm.com...
ID r006-daefc524-2643-4444-a22d-7c38144cc529
Name my-cli-snapshot-crc
CRN crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-daefc524-2643-4444-a22d-7c38144cc529
Status stable
Clones Zone Available Created
Source volume ID Name Remote Region CRN Resource type
r014-26fce2ff-8177-47ce-8182-49d8aed33063 -remote-49d8aed33063 us-east crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-26fce2ff-8177-47ce-8182-49d8aed33063 volume
Backup policy plan -
Snapshot Copies -
Bootable true
Encryption provider_managed
Encryption key -
Source Snapshot ID Name Remote Region CRN Resource type
r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9 my-bootable-snapshot us-east crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9 snapshot
Minimum capacity(GB) 100
Size(GB) 3
Source Image ID Name Remote Region CRN Resource type
r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214 -remote-1f4a7cd29214 us-east crn:v1:bluemix:public:is:us-east:a/a1234567::image:r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214 image
Operating system Name Vendor Version Family Architecture Display name
centos-stream-9-amd64 CentOS 9 CentOS Stream amd64 CentOS Stream 9 - Minimal Install (amd64)
Resource group ID Name
6edefe513d934fdd872e78ee6a8e73ef defaults
Created 2025-01-21T21:27:30+00:00
Captured at 2025-01-21T21:17:14+00:00
Tags -
Service Tags -
Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-create.
Création d'un instantané à l'aide de l'API
Vous pouvez créer un instantané à l'aide de l'API.
Prérequis pour la création d'un instantané à l'aide de l'API
Vous pouvez créer une image instantanée en appelant l'API VPC. Avant de commencer, rassemblez les informations suivantes:
- Un nom unique pour l'instantané.
- L'identifiant du volume source.
- ID du groupe de ressources. Vous ne pouvez pas modifier le groupe de ressources après la création de l'image instantanée.
- Toutes les balises que vous souhaitez associer à l'instantané.
Création d'un instantané à l'aide de l'API
Pour créer un instantané d'un volume d'amorçage ou de données, créez un POST /snapshots. L'exemple suivant crée une image instantanée d'un volume d'amorçage à l'aide de l'ID volume et spécifie les balises utilisateur qui peuvent
être associées à une règle de sauvegarde.
curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2025-02-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-bootable-snapshot",
"source_volume": {"id": "r014-26fce2ff-8177-47ce-8182-49d8aed33063"},
"resource_group": {"id": "6edefe513d934fdd872e78ee6a8e73ef"},
"user_tags": ["env:test","env:prod"]
}'
Une réponse réussie ressemble à celle de l'exemple ci-après. L'état du cycle de vie de l'image instantanée est pending lors de la création de l'image instantanée. Une fois la création effectuée, le statut passe à « stable ».
{
"bootable": true,
"captured_at": "2025-01-21T21:17:14.000Z",
"clones": [],
"copies": [],
"created_at": "2025-01-21T21:17:13.000Z",
"crn": "crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
"deletable": true,
"encryption": "provider_managed",
"href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
"id": "r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
"lifecycle_state": "stable",
"minimum_capacity": 100,
"name": "my-bootable-snapshot",
"operating_system": {
"allow_user_image_creation": true,
"architecture": "amd64",
"dedicated_host_only": false,
"display_name": "CentOS Stream 9 - Minimal Install (amd64)",
"family": "CentOS Stream",
"href": "https://us-east.iaas.cloud.ibm.com/v1/operating_systems/centos-stream-9-amd64",
"name": "centos-stream-9-amd64",
"user_data_format": "cloud_init",
"vendor": "CentOS",
"version": "9"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"resource_type": "snapshot",
"service_tags": [],
"size": 2,
"source_image": {
"crn": "crn:v1:bluemix:public:is:us-east:a/a1234567:image:r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
"href": "https://us-east.iaas.cloud.ibm.com/v1/images/r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
"id": "r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
"name": "ibm-centos-stream-9-amd64-9",
"resource_type": "image"
},
"source_volume": {
"crn": "crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-26fce2ff-8177-47ce-8182-49d8aed33063",
"href": "https://us-east.iaas.cloud.ibm.com/v1/volumes/r014-26fce2ff-8177-47ce-8182-49d8aed33063",
"id": "r014-26fce2ff-8177-47ce-8182-49d8aed33063",
"name": "my-test-vm-boot-1",
"resource_type": "volume"
},
"user_tags": ["env:test","env:prod"]
}
Création d'un instantané et d'un clone d'instantané de restauration rapide à l'aide de l'API
Lorsque vous créez un instantané, vous pouvez également créer un clone d'instantané de restauration rapide dans une autre zone. En clonant une image instantanée et en la conservant dans une autre zone, vous pouvez utiliser ultérieurement la fonction de restauration rapide pour mettre rapidement à disposition un nouveau volume avec les données d'une image instantanée. Pour plus d'informations, voir Instantanés de la fonction de restauration rapide.
Effectuez une demande POST/snapshots pour créer un instantané d'un volume d'amorçage ou de données et spécifiez la propriété clones. Indiquez une ou plusieurs zones de votre région différentes de la zone dans laquelle
vous créez l'instantané. Dans l'exemple suivant, un clone est créé dans us-south-2, spécifié par son nom.
curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2022-12-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"clones": [{"zone": {"name": "us-south-2"}}],
"name": "my-snapshot-1",
"source_volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"},
"resource_group": {"id": "a342dbfb-3ea7-48d1-96e8-2825ec5feab4"},
"user_tags": ["env:test","env:prod"]
}
}'
Une réponse réussie indique que le clone a été créé dans la zone spécifiée.
{
"bootable": true,
"clones": [
{
"available": false,
"created_at": "2022-12-18T14:58:32Z",
"zone": {
"name": "us-south-2",
"href": "https:ibm.com/v1/regions/us-south/zones/us-south-2",
"resource_type": "zone"
}
}
],
"created_at": "2022-12-18T20:18:18Z",
"crn": "crn:[...]",
"deletable": false,
"encryption": "user_managed",
"encryption_key": {
"crn": "crn:[...]"
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/12917904-3771-424d-8391-53ec9e305d52",
"id": "12917904-3771-424d-8391-53ec9e305d52",
"lifecycle_state": "pending",
}
La fonction de restauration rapide est facturée à un tarif horaire supplémentaire pour chaque zone dans laquelle elle est activée, quelle que soit la taille de l'image instantanée. Le maintien de clones de restauration rapide est considérablement plus coûteux que la conservation d'instantanés réguliers.
Création d'une copie interrégionale d'un instantané à l'aide de l'API
Lorsque vous créez un instantané, vous pouvez également le copier dans une autre région. En créant une copie d'instantané dans une autre région et en créant de nouvelles instances à l'aide de cet instantané, vous pouvez étendre votre VPC à une autre région. Cette fonction peut également être utilisée dans les scénarios de reprise après incident. Pour plus d'informations, voir Copies d'images instantanées interrégionales.
Effectuez une demande POST /snapshots pour créer une copie d'instantané dans la région cible, spécifiez le nom et le CRN de l'instantané source. Dans l'exemple suivant, la région cible est us-east et la région source est us-south.
Les sous-propriétés name et source_snapshot sont requises. L' resource_group e est facultative. La sous-propriété encryption_key est requise lorsque l'instantané source est chiffré à l'aide
d'une clé gérée par le client.
Si l'instantané source n'est pas chiffré avec une clé client, le chiffrement de la copie reste géré par le fournisseur. Si l'instantané source est protégé par une clé gérée par le client, vous devez spécifier la clé gérée par le client que vous souhaitez utiliser pour chiffrer la nouvelle copie. Le cliché source doit être en état stable pour que la copie soit créée avec succès.
curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2023-05-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-api-snapshot-crc", // required
"source_snapshot": { // required
"crn": "crn:[crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-daefc524-2643-4444-a22d-7c38144cc529]"
},
"resource_group": { // optional
"id": "6edefe513d934fdd872e78ee6a8e73ef"
},
"encryption_key"; "crn:[...]" // required when source has customer-managed encryption
}
Une réponse indiquant la réussite indique que la copie d'instantané a été créée dans la région cible.
{
"bootable": true,
"captured_at": "2025-01-21T21:17:14.000Z",
"clones": [],
"copies": [],
"created_at": "2025-01-21T21:27:30.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-daefc524-2643-4444-a22d-7c38144cc529",
"deletable": true,
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-daefc524-2643-4444-a22d-7c38144cc529",
"id": "r006-daefc524-2643-4444-a22d-7c38144cc529",
"lifecycle_state": "stable",
"minimum_capacity": 100,
"name": "my-api-snapshot-crc",
"operating_system": {
"allow_user_image_creation": true,
"architecture": "amd64",
"dedicated_host_only": false,
"display_name": "CentOS Stream 9 - Minimal Install (amd64)",
"family": "CentOS Stream",
"href": "https://us-east.iaas.cloud.ibm.com/v1/operating_systems/centos-stream-9-amd64",
"name": "centos-stream-9-amd64",
"user_data_format": "cloud_init",
"vendor": "CentOS",
"version": "9"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"resource_type": "snapshot",
"service_tags": [],
"size": 3,
"source_image": {
"crn": "crn:v1:bluemix:public:is:us-east:a/811f8abfbd32425597dc7ba40da98fa6::image:r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
"href": "https://us-east.iaas.cloud.ibm.com/v1/images/r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
"id": "r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
"name": "-remote-1f4a7cd29214",
"remote": {
"region": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-east",
"name": "us-east"
}
},
"resource_type": "image"
},
"source_snapshot": {
"crn": "crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
"href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
"id": "r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
"name": "my-bootable-snapshot",
"remote": {
"region": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-east",
"name": "us-east"
}
},
"resource_type": "snapshot"
},
"source_volume": {
"crn": "crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-26fce2ff-8177-47ce-8182-49d8aed33063",
"href": "https://us-east.iaas.cloud.ibm.com/v1/volumes/r014-26fce2ff-8177-47ce-8182-49d8aed33063",
"id": "r014-26fce2ff-8177-47ce-8182-49d8aed33063",
"name": "-remote-49d8aed33063",
"remote": {
"region": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-east",
"name": "us-east"
}
},
"resource_type": "volume"
},
"user_tags": []
}
Création d'un instantané avec Terraform
Vous pouvez créer un instantané à l'aide de Terraform.
Avant de commencer, rassemblez les informations suivantes:
- Un nom unique pour l'instantané.
- L'identifiant du volume source.
- ID du groupe de ressources. Vous ne pouvez pas modifier le groupe de ressources après la création de l'image instantanée.
- Toutes les balises que vous souhaitez associer à l'instantané.
Pour utiliser Terraform, téléchargez l'interface CLI Terraform et configurez le IBM Cloud® plug-in 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 créer un instantané, utilisez la ressource ibm_is_snapshot. L'exemple suivant crée une image instantanée du volume avec l'ID r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa. L'instantané est nommé snapshot-test.
resource "ibm_is_snapshot" "example" {
name = "snapshot-test"
source_volume = "r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa"
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_snapshot.
Création d'un instantané et d'un clone d'instantané de restauration rapide avec Terraform
Pour créer un instantané avec des clones de restauration rapide, utilisez la ressource ibm_is_snapshot. L'exemple suivant crée une image instantanée du volume avec l'ID r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4. L'instantané
est nommé example-snapshot. En outre, deux clones de restauration rapide de l'instantané sont créés dans les régions eu-de-1 et eu-de-3.
resource "ibm_is_snapshot" "example_clones" {
name = "example-snapshot-clone"
source_volume = "r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4"
clones = ["eu-de-1", "eu-de-3"]
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_snapshot.
La fonction de restauration rapide est facturée à un tarif horaire supplémentaire pour chaque zone dans laquelle elle est activée, quelle que soit la taille de l'image instantanée. Le maintien de clones de restauration rapide est considérablement plus coûteux que la conservation d'instantanés réguliers.
Création d'une copie interrégionale d'un instantané avec Terraform
Pour créer une copie de l'instantané dans une région distante, utilisez la ressource ibm_is_snapshot. L'exemple suivant crée une copie dans la région cible à l'aide du CRN 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.
Le cliché source doit être en état stable pour que la copie soit créée avec succès.
Etapes suivantes
Après avoir créé une image instantanée, vous pouvez afficher plus de détails à son sujet ou restaurer un volume à partir de l'image instantanée.
- Affichez tous les instantanés que vous avez créés, ou des détails sur un seul instantané.
- Restaurez un volume à partir d'une image instantanée.