Affichage des instantanés et des groupes de cohérence Block Storage for VPC

Afficher les instantanés et les groupes de cohérence d' Block Storage for VPC, y compris des informations détaillées sur chaque instantané et ses propriétés.

Affichage des instantanés dans la console

Vous pouvez utiliser l'interface utilisateur pour répertorier vos instantanés et vos groupes de cohérence.

Liste de tous les instantanés dans la console

Dans la console, vous pouvez consulter la liste de tous les instantanés que vous avez créés, le plus récent figurant en tête de liste. Vous pouvez filtrer la liste pour afficher des instantanés spécifiques.

  1. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation menu > Infrastructure Icône VPC > Stockage > Block Storage snapshots pour VPC. La page comporte deux onglets principaux: Groupe de cohérence d'instantané et Instantanés.

  2. Sélectionnez l'onglet Snapshots. Les instantanés sont répertoriés pour une région spécifique. Si vous souhaitez afficher des instantanés dans une autre région, cliquez sur la flèche pour développer la liste et sélectionner une autre région. Par défaut, les instantanés les plus récents s'affichent en tête de liste.

  3. A mesure que votre liste d'images instantanées s'allonge, utilisez le filtre pour indiquer le nombre d'images instantanées à afficher par page. Utilisez les flèches de navigation de la page pour descendre et remonter dans la liste.

Le tableau 1 décrit les informations relatives à tous les instantanés qui apparaissent dans la liste des instantanés.

Liste de tous les instantanés
Zone Description
Nom Le nom que vous avez indiqué lors de la création de l'instantané. Cliquez sur le nom de l'image instantanée pour afficher ses détails.
Statut État de l'instantané, selon qu'il est utilisable (état actif ), inutilisable ou en cours de création. Pour plus d'informations, voir Statuts des instantanés.
Taille Taille de l'instantané en Go. La taille est héritée du volume source.
Volume source Il indique le volume de démarrage ou de données à partir duquel l'instantané a été créé. Cliquez sur le nom du volume pour afficher ses détails.
Copies d'instantané Nombre de copies d'un instantané dans d'autres régions.
Date de création Date et heure locales auxquelles l'instantané a été créé.
Groupe de cohérence Cette zone affiche le nom du groupe de cohérence si l'instantané est membre d'un ensemble d'instantanés.

Cliquez sur l'icône des paramètres icône Paramètres pour afficher les zones facultatives que vous pouvez ajouter à la table.

Liste des champs d'information facultatifs pour tous les instantanés
Zone Description
Chiffrement Il montre le IBM ou le chiffrement géré par le client. Le chiffrement est hérité du volume source.
Statut de restauration rapide Il indique si des clones de restauration rapide sont disponibles pour les instantanés. Les statuts possibles sont : activé, en attente ou désactivé.
Groupe de ressources Le groupe de ressources auquel appartient l'instantané.
Amorçable Oui ou Non. Indique si l'image instantanée a été prise d'un volume d'amorçage ou d'un volume de données.
Créé par Indique si l'image instantanée a été créée par l'utilisateur ou par une règle de sauvegarde.
Génération Gen 1 ou Gen 2, cette valeur est héritée du volume parent en fonction de son profil de volume.

En cliquant sur l'icône Actions icône Actions, vous pouvez afficher un menu d'actions spécifiques au contexte.

Vous pouvez également répertorier tous les instantanés créés à partir d'un volume Block Storage for VPC depuis la page de détails du volume. Pour plus d'informations, consultez la section Afficher tous les instantanés créés à partir du Block Storage for VPC volume.

Affichage des détails de l'instantané dans la console

Pour afficher des informations détaillées sur un instantané, localisez l'instantané dans la liste des instantanés Block Storage pour VPC. Cliquez ensuite sur le nom d'un instantané. La page des détails affiche le nom de l'instantané, son statut et les balises utilisateur associées dans le titre.

Le panneau des détails de l'instantané affiche les informations décrites dans le tableau suivant.

Détails de l'instantané
Zone Description
Nom Nom de l'instantané que vous pouvez modifier en cliquant sur l'icône Editer icône Editer. Pour plus d'informations, voir Désignation des instantanés.
ID instantané Identificateur global unique copiable de l'image instantanée.
Amorçable Oui ou Non.
CRN Nom de ressource de cloud copiable de l'image instantanée.
Groupe de ressources Groupe de ressources défini lors de la configuration de votre VPC.
Date de création Date et heure de démarrage du processus de création d'une ressource d'instantané.
Date de capture Date et heure auxquelles cet instantané a été capturé.
Créé par Cette zone affiche User ou Backup policy. Si l'image instantanée est créée par une règle de sauvegarde, l'interface utilisateur affiche également le nom du plan de sauvegarde qui a créé l'image instantanée de sauvegarde.
Taille Taille en Go de l'image instantanée, héritée du volume source.
Volume source Volume source à partir duquel la première image instantanée a été effectuée. Cliquez sur le lien pour les détails du volume. Si le volume a été supprimé, le nom apparaît sans lien.
Chiffrement Chiffrement géré par le fournisseur ou par le client. Pour le chiffrement géré par le client, l'instance KMS, le nom de clé racine et l'ID de clé racine sont affichés.
Génération Cette valeur est soit Gen 1, soit Gen 2, en fonction du profil du volume source.
Expression de serveur virtuel L'expression allowed-use définit et limite les profils de serveurs virtuels avec lesquels l'instantané de démarrage est compatible. Lorsque vous provisionnez une instance de serveur virtuel en utilisant le snapshot, l'expression est comparée aux propriétés de l'instance demandée. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.
Panneau Restauration rapide Utilisez la restauration rapide pour créer un volume à partir de cet instantané qui est entièrement mis à disposition. Cliquez sur Editer pour activer ou désactiver la restauration rapide dans une zone.
Panneau Groupe de cohérence Il affiche des informations sur le groupe de cohérence dont l'instantané est membre. Cliquez sur Créer un serveur virtuel pour restaurer des volumes à partir du groupe de cohérence.

En cliquant sur l'icône Actions icône Actions, vous pouvez afficher un menu d'actions spécifiques au contexte.

Liste de tous les groupes de cohérence des instantanés dans la console

Dans la console, vous pouvez afficher la liste de tous les groupes de cohérence que vous avez créés, la plus récente étant affichée au début de la liste. Vous pouvez filtrer la liste pour afficher des groupes de cohérence spécifiques.

  1. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation menu > Infrastructure Icône VPC > Stockage > Block Storage snapshots pour VPC. La page comporte deux onglets principaux: Groupe de cohérence d'instantané et Instantanés.

  2. Sélectionnez l'onglet Groupe de cohérence d'instantané. Les groupes sont répertoriés pour une région spécifique. Si vous souhaitez voir des groupes de cohérence dans une autre région, cliquez sur la flèche pour développer la liste et sélectionner une autre région. Par défaut, les groupes d'instantanés les plus récents sont affichés au début de la liste.

  3. À mesure que votre liste de groupes de cohérence s'allonge, utilisez le filtre pour indiquer le nombre d'éléments à afficher par page. Utilisez les flèches de navigation de la page pour descendre et remonter dans la liste.

Le tableau suivant décrit les informations pour tous les groupes de cohérence de la liste.

Liste de tous les groupes de cohérence
Zone Description
Nom Nom que vous avez fourni lors de la création du groupe de cohérence. Cliquez sur le nom du groupe pour afficher ses détails.
Statut Statut du groupe de cohérence, selon qu'il est utilisable (statut_actif_ ), inutilisable ou en cours de création.
VSI source Il affiche l'instance de serveur virtuel qui contient les volumes source des instantanés dans le groupe de cohérence. Cliquez sur le nom de l'instance de serveur virtuel pour afficher ses détails.
Membres d'instantané Nombre d'instantanés qui sont membres du groupe.
Date de création Date et heure locales auxquelles l'instantané a été créé.

Cliquez sur l'icône des paramètres icône Paramètres pour afficher les zones facultatives que vous pouvez ajouter à la table.

Liste des champs d'information facultatifs pour tous les instantanés
Zone Description
Créé par Elle indique si l'ensemble d'images instantanées a été créé par l'utilisateur ou par une règle de sauvegarde.
Groupe de ressources Le groupe de ressources auquel appartient le groupe de cohérence.
Créé par Indique si l'image instantanée a été créée par l'utilisateur ou par une règle de sauvegarde.

En cliquant sur l'icône Actions icône Actions, vous pouvez afficher un menu d'actions spécifiques au contexte.

Affichage des détails d'un groupe de cohérence dans la console

Pour afficher des informations détaillées sur un groupe de cohérence, localisez le groupe dans la liste Block Storage des instantanés pour VPC. Cliquez ensuite sur le nom d'un groupe de cohérence.

La section de présentation fournit des détails sur le groupe de cohérence et l'instance de serveur virtuel dont les instantanés de groupe de cohérence ont été pris. Le premier panneau contient des informations sur le groupe de cohérence.

Vue d'ensemble du groupe de cohérence.
Zone Description
Nom Nom unique du groupe de cohérence. Si vous souhaitez le mettre à jour, cliquez sur l'icône Editer icône Editer.
ID de groupe de cohérence Cette zone affiche la chaîne d'ID du groupe de cohérence.
CRN Nom de ressource de cloud du groupe de cohérence.
Créé par La zone affiche user pour une image instantanée créée manuellement ou une règle de sauvegarde pour les images instantanées automatisées.
Groupe de ressources Le groupe de ressources auquel appartient le groupe de cohérence.
Date de création Il indique la date à laquelle le groupe de cohérence a été créé.
Supprimer les membres de l'instantané Indique si les instantanés sont supprimés ou conservés lorsque le groupe de cohérence est supprimé. Cliquez sur le bouton à bascule pour modifier le statut.
Région Région VPC dans laquelle le groupe de cohérence a été créé.

Pour plus d'informations, voir Gestion des groupes de cohérence d'image instantanée.

Le second panneau contient des informations sur l'instance de serveur virtuel à laquelle les volumes source de l'ensemble d'images instantanées sont connectés.

Vue d'ensemble de l'instance de serveur virtuel.
Zone Description
Nom Nom de l'instance de serveur virtuel. Cliquez sur le lien pour accéder à la page des détails de l'instance.
ID d'instance de serveur virtuel Vous pouvez copier l'ID à utiliser dans d'autres interfaces telles que l'interface de ligne de commande, l'API ou Terraform.
Cloud privé virtuel Nom du VPC dans lequel le groupe de cohérence est créé. Cliquez sur le lien pour accéder à la page des détails du VPC.
Image Informations sur l'image du système d'exploitation.
Groupe de ressources Groupe de ressources auquel appartient l'instance de serveur virtuel.
Balises Balises définies par l'utilisateur qui sont utilisées pour l'instance de serveur virtuel.

La liste Instantanés affiche les instantanés au sein du groupe de cohérence et fournit les mêmes informations et actions que celles décrites dans le tableau 1.

Affichage des instantanés depuis l'interface de ligne de commande (CLI)

Vous pouvez utiliser l'interface de ligne de commande (CLI) pour répertorier tous les instantanés, tous les instantanés d'un volume et obtenir des détails sur un instantané particulier.

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 à 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.

Affichage de tous les instantanés d'un compte dans une région à partir de l'interface de ligne de commande

Pour afficher tous les instantanés, exécutez la commande snapshots. L'exemple suivant fournit une liste de tous les instantanés de tous les groupes de ressources de la région us-south.

ibmcloud is snapshots [--json]

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name             Status   Source volume                               Bootable   Resource group   Created                     Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-22db5609-69a1-4fe2-bd02-f64fb11230b3   my-test-snapshot stable   r006-ccbc5bc6-cd88-48e0-9a1d-de0f4d024324   true       defaults         2025-07-31T00:04:24+00:00   -                          -                       1
r006-e799fad8-aefa-4df5-81bd-dac6d13200a6   my-test-snap-1   stable   r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   true       defaults         2025-08-06T22:38:01+00:00   -                          -                       1

Pour plus d'informations sur les options de commande d'instantané disponibles, voir ibmcloud is snapshots.

Affichage de tous les instantanés d'un volume à partir de l'interface de ligne de commande (CLI)

Exécutez la commande snapshots et indiquez l'ID volume.

ibmcloud is snapshots --volume VOLUME-ID [--json]

L'exemple suivant montre les trois instantanés qui ont été pris sur le volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa.

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

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshots.

Affichage de tous les instantanés dans un groupe de cohérence à partir de l'interface de ligne de commande

Exécutez la commande snapshots et spécifiez l'ID de groupe de cohérence, le nom ou le CRN.

ibmcloud is snapshots --volume CONSISTENCY_GROUP_ID

L'exemple suivant utilise l'ID du groupe de cohérence pour répertorier les instantanés qui sont membres de l'ensemble.

ibmcloud is snapshots --snapshot-consistency-group r174-7c8762e2-c1b9-424e-b773-23240d1780dd

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name            Status   Source volume                               Bootable   Resource group   Created
r174-b8cac978-a990-4824-a15c-604856982efe   snapshot-no-2   stable   r174-0641e516-09a1-4291-96ca-af254017123e   true       Default          2023-09-05T23:14:40+05:30
r174-7311f226-8259-46be-9bfa-5b2cd08bdf2f   snapshot-no-1   stable   r174-bf595773-9922-4dd4-9a3c-998b10022e0c   false      Default          2023-09-05T23:14:40+05:30

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshots.

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshots.

Affichage des détails d'un instantané depuis l'interface de ligne de commande (CLI)

Exécutez la commande snapshot et indiquez l'ID de l'image instantanée.

ibmcloud is snapshot SNAPSHOTS_ID [--json]

L'exemple suivant montre les détails d'un instantané amorçable dans la région us-south.

ibmcloud is snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6

Getting snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6 under account Test Account as user test.user@ibm.com...
ID                              r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Name                            my-test-snap-1
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Status                          stable
Clones                          Zone   Available   Created
Source volume                   ID                                          Name               Remote Region   CRN                                                                                                                        Resource type
                                r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   test-volume-fast   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   volume
Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -
Source Snapshot                 -
Minimum capacity(GB)            100
Size(GB)                        10
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type
                                r006-cec640a3-615e-4364-bae7-d3642d9f9e34   ibm-ubuntu-22-04-5-minimal-amd64-4   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-cec640a3-615e-4364-bae7-d3642d9f9e34   image
Operating system                Name                 Vendor      Version                                     Family         Architecture   Display name
                                ubuntu-22-04-amd64   Canonical   22.04 LTS Jammy Jellyfish Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 22.04 LTS Jammy Jellyfish Minimal Install (amd64)
Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                         2025-08-06T22:38:01+00:00
Captured at                     2025-08-06T22:38:02+00:00
Tags                            -
Service Tags                    -
Storage Generation              1
Allowed Use API Version         2025-07-17
Allowed Use Bare Metal Server   true
Allowed Use Instance            true

Les propriétés de allowed-used sont héritées du volume source ou de l'instantané au moment de la création. Vous pouvez modifier leur valeur au moment de la création ou ultérieurement si vous êtes autorisé à jouer le rôle IAM is.snapshot.snapshot.manage-allowed-use. Les propriétés comprennent une expression booléenne en langage d'expression commune. Lorsque l'expression instance est évaluée comme étant true, le provisionnement d'une instance de serveur virtuel est autorisé avec l'instantané. Lorsque l'expression est évaluée à false, le provisionnement est bloqué. Si la valeur n'est pas spécifiée au moment de la création, les expressions de la contrainte sont reprises de la ressource source.

L'exemple suivant montre les détails d'un instantané non amorçable dans la région eu-de, qui possède également un clone de restauration rapide dans la zone eu-de-1.

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
Snapshot Consistency Group ID                                                    Name                    Snapshot Consistency Group ID                                         Name                                   CRN                                                                    Resource type
                           r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44 multiple-snapshots-consistency-group-1   crn:v1:bluemix:public:is:eu-de:a/a1234567:snapshot-consistency-group:r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44   snapshot_consistency_group
Resource group             ID                                 Name
                           6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                    2023-12-05T20:15:43+00:00
Captured at                2023-12-05T20:15:44+00:00
Tags                       env:prod,env:test
Service Tags               -
Storage Generation         1

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshots.

Affichage de tous les clones d'instantané de restauration rapide à partir de l'interface de ligne de commande

Vous pouvez répertorier tous les clones de restauration rapide disponibles d'un instantané en exécutant la commande ibmcloud is snapshot-clones. L'exemple suivant répertorie les clones d'instantané de restauration rapide disponibles de l'instantané dont l'ID est r138-4463eb2c-4913-43b1-b9bf-62a94f74c146.

ibmcloud is snapshot-clones r138-4463eb2c-4913-43b1-b9bf-62a94f74c146

Listing zonal clones of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone      Available   Created
eu-de-1   true        2023-02-17T20:15:46+00:00
eu-de-3   true        2023-02-17T20:29:21+00:00

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-clones.

Affichage des détails d'un clone d'instantané de restauration rapide à partir de l'interface de ligne de commande

Vous pouvez exécuter la commande ibmcloud is snapshot-clone pour répertorier les détails d'un clone d'instantané de restauration rapide spécifique. L'exemple suivant montre comment lister les détails du clonage instantané de restauration rapide de l'instantané r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 qui se trouve dans la zone d' eu-de-3.

ibmcloud is snapshot-clone 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
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-clone.

Affichage des détails d'une copie d'instantané de région distante à partir de l'interface de ligne de commande

Vous pouvez exécuter la commande ibmcloud is snapshot pour obtenir la liste des détails d'une copie d'instantané de région distante spécifique. L'exemple suivant montre comment répertorier les détails de l'instantané de la région distante (my-cli-snapshot-crc) qui se trouve dans la région us-south. La réponse fournit des informations sur l'instantané parent (cli-snap-crc-test), le volume parent et la politique de sauvegarde qui a créé l'instantané.

ibmcloud is snapshot my-cli-snapshot-crc

Getting snapshot my-cli-snapshot-crc-target under account Test Account as user test.user@ibm.com...
ID                     r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Status                 stable
Clones                 Zone   Available   Created
Source volume          ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   -remote-814bfc1e108b   us-east         crn:v1:bluemix:public:is:us-east-a/a1234567::volume:r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   volume
Backup policy plan     ID                                          Name                   Resource type
                       r014-d659eb15-ff07-4d54-8dd8-808a037e1b61   -remote-808a037e1b61   backup_policy_plan
Snapshot Copies        -
Bootable               false
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                Remote Region   CRN                                                                                                                       Resource type
                       r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   cli-snap-crc-test   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   snapshot
Minimum capacity(GB)   100
Size(GB)               1
Source Image           -
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                2024-06-18T17:21:24+00:00
Captured at            2024-06-18T17:21:20+00:00
Tags                   -
Service Tags           -
Storage Generation     1

Affichage de tous les groupes de cohérence d'instantané depuis l'interface de ligne de commande

Exécutez la commande snapshot-consistency-groups pour répertorier tous les groupes de cohérence d'une région.

ibmcloud is snapshot-consistency-groups

[Nouveau] : {: tag-green} Vous pouvez également filtrer les résultats de la requête en fonction de l'ID d'une tâche de sauvegarde. Le filtrage par ID de tâche de sauvegarde peut s'avérer utile lorsque vous souhaitez restaurer une instance en récupérant des volumes provenant de deux groupes de cohérence de snapshots de sauvegarde, créés parce que votre instance d'origine comportait à la fois des volumes de première et de deuxième génération.

ibmcloud is snapshot-consistency-groups --backup-policy-job BACKUP_POLICY_JOB_ID

Voir l'exemple de résultat suivant :

Listing snapshot consistency groups in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                      Name                           Backup policy job                      Backup policy plan                 Snapshots count   Lifecycle State   Service Tags                                               Resource group
r006-687c49cb-13ad-4dd8-9d04-0e264baa99a1  test-cli-2-4a3286e405b-4d3b  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  1                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc  test-cli-2-f4690eb88143-441a  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  2                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-consistency-groups.

Affichage des détails d'un groupe de cohérence d'instantané à partir de l'interface de ligne de commande

Exécutez la commande snapshot-consistency-group pour répertorier les détails d'un groupe de cohérence spécifique dans une région.

ibmcloud is snapshot-consistency-group CONSISTENCY_GROUP_ID

[Nouvelle commande] {: tag-green} : exemple de sortie affichant les informations relatives à la tâche et au plan de la politique de sauvegarde :

Getting snapshot consistency group r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc under account Test Account as user test.user@ibm.com...
ID
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Name
test-cli-2-f4690eb88143-441a
CRN
crn:v1:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Href
https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Status
stable
Backup policy job
ID                                   Resource type
r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36   backup_policy_job
Backup policy plan
ID                                   Name        Resource type
r006-ee0bddb-17b9-4279-8d1a-802afe9104da   test-cli-2   backup_policy_plan
Delete snapshot on delete
true
Source Snapshot
ID                                   Name                          Remote Region   CRN                                                                                                           Resource type
r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   test-cli-2-c01a2ef47cd3-4202              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   snapshot
r006-388f4bb7-cdd2-4e60-b57e-690066412d45   test-cli-2-12524f129f23-4fbc              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-388f4bb7-cdd2-4e60-b57e-690066412d45   snapshot
Resource group
ID                                   Name
11caaa983d9c4beb82690daadb08717e9     Default
Created
2026-05-05T21:42:30+05:30
Service Tags
is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-consistency-group.

Répertorier des instantanés à l'aide de l'API

Vous pouvez répertorier vos instantanés à l'aide de l'API.

Répertorier tous les instantanés à l'aide de l'API

Vous pouvez répertorier à l'aide d'un programme tous les instantanés de vos volumes en appelant la méthode /snapshots dans l'API VPC, comme illustré dans l'exemple de demande suivant. Par défaut, la liste affiche les images instantanées les plus récentes, puis les images instantanées plus anciennes par ordre décroissant.

curl -X GET \
  "$vpc_api_endpoint/v1/snapshots?version=2022-12-16&generation=2" \
  -H "Authorization: Bearer $iam_token"

Vous pouvez filtrer la liste à l'aide de l'ID du groupe de ressources, de l'ID du volume source ou du CRN du volume source, puis affiner les résultats à l'aide des options suivantes :

  • Limite : permet de contrôler le nombre d'images instantanées affichées sur une page.
  • Début : permet de spécifier la première image instantanée (par ID) de la liste.
  • Tri : permet de contrôler l'ordre dans lequel vous triez la page (par exemple, par date de création ou par nom d'image instantanée suivant l'ordre alphabétique).

Par exemple, l'appel suivant filtre la liste pour afficher les instantanés créés pour un seul volume et limite les résultats à cinq par page.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots?version=2022-08-16&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "limit": 5,
      "source_volume":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
    "first": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots?limit=50"
    },
    "limit": 5,
    "snapshots": [
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-18T20:18:18Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/f945d446-0d46-478a-a298-acba907d45d1",
        "id": " f945d446-0d46-478a-a298-acba907d45d1",
        "lifecycle_state": "stable",
        "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",
          "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:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "id": "de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      },
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-17T20:11:28Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/e5bfa329-0e36-433f-a3bb-0df632e79263",
        "id": "e5bfa329-0e36-433f-a3bb-0df632e79263",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot-2",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "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:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "id": "23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      }
    ],
    "total_count": 2
  }

Afficher les détails d'un instantané à l'aide de l'API

Vous pouvez extraire à l'aide d'un programme les détails d'un instantané unique en appelant la méthode /snapshots dans l'API VPC et en spécifiant l'ID d'instantané comme illustré dans l'exemple de demande suivant.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "clones": [],
  "captured_at": "2022-12-16T20:19:12Z",
  "created_at": "2021-12-16T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": true,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d",
  "id": "7528eb61-bc01-4763-a67a-a414a103f96d",
  "lifecycle_state": "stable",
  "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",
    "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/59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "id": "59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "id": "dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "name": "ubuntu-20-04-minimal-amd64-1"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "id": "c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}
  • Les propriétés de allowed-used sont héritées du volume source ou de l'instantané au moment de la création. Vous pouvez modifier leur valeur au moment de la création ou ultérieurement si vous êtes autorisé à jouer le rôle IAM is.snapshot.snapshot.manage-allowed-use. Les propriétés comprennent une expression booléenne en langage d'expression commune. Lorsque l'expression instance est évaluée comme étant true, le provisionnement d'une instance de serveur virtuel est autorisé avec l'instantané. Lorsque l'expression est évaluée à false, le provisionnement est bloqué. Si la valeur n'est pas spécifiée au moment de la création, les expressions de la contrainte sont reprises de la ressource source.

Affichage de tous les clones d'instantané de restauration rapide à l'aide de l'API

Vous pouvez répertorier à l'aide d'un programme tous les clones de restauration rapide en appelant la méthode /snapshots/clones dans l'API VPC et en spécifiant l'ID d'instantané, comme illustré dans l'exemple de demande suivant.

Effectuez une demande GET /v1/snapshots/{id}/clones pour répertorier tous les clones d'instantané de restauration rapide.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Une réponse réussie fournit des informations sur les clones d'instantané de restauration rapide.

{
  "clones": [
    {
      "available": true,
      "created_at": "2022-12-16T19:55:28.537Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
      }
    },
    {
      "available": true,
      "created_at": "2022-12-16T19:58:22.337Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
      }
    }
  ]
}

Affichage des détails d'un clone d'instantané de restauration rapide avec l'API

Vous pouvez extraire à l'aide d'un programme les détails d'un clone de restauration rapide unique en appelant la méthode /snapshots/clones dans l'API VPC et en spécifiant l'ID d'instantané et la zone, comme illustré dans l'exemple de demande suivant.

Effectuez une demande GET /v1/snapshots/{id}/clones/{zone-name} pour extraire un seul clone d'instantané de restauration rapide spécifié par ID et nom de zone.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones/us-south-1?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Une réponse réussie affiche les informations suivantes sur le clone d'instantané de restauration rapide.

{
  "available": true,
  "created_at": "2022-12-16T20:15:35.164Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Affichage des détails d'une copie d'instantané de région distante à l'aide de l'API

Vous pouvez extraire à l'aide d'un programme les détails d'un instantané unique en appelant la méthode /snapshots dans l'API VPC et en spécifiant l'ID d'instantané comme illustré dans l'exemple de demande suivant.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Une réponse réussie affiche des informations similaires à l'exemple suivant.

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "created_at": "2023-05-18T20:18:18Z",
  "crn": "crn:[...]",
  "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": "stable",
  "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": [],
  "region": "us-east",
  "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",
    	   "href": "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"
  },
  "storage_generation": 1,
  "user_tags": []
}

Affichage de tous les groupes de cohérence d'image instantanée à l'aide de l'API

Vous pouvez répertorier à l'aide d'un programme tous les groupes de cohérence en appelant la méthode /snapshot_consistency_groups dans l'API VPC, comme illustré dans l'exemple de demande suivant.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

[Nouveau] : {: tag-green} Vous pouvez également filtrer les résultats de la requête en fonction de l'ID d'une tâche de sauvegarde. Le filtrage par ID de tâche de sauvegarde peut s'avérer utile lorsque vous souhaitez restaurer une instance en récupérant des volumes provenant de deux groupes de cohérence de snapshots de sauvegarde, créés parce que votre instance d'origine comportait à la fois des volumes de première et de deuxième génération.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"\
-d '{
      "backup_policy_job_id":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

Affichage des détails d'un groupe de cohérence d'instantané à l'aide de l'API

Vous pouvez extraire à l'aide d'un programme les détails d'un groupe de cohérence en appelant la méthode /snapshot_consistency_groups dans l'API VPC, comme illustré dans l'exemple de demande suivant.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
    "created_at": "2023-12-05T22:40:42Z",
    "id": "r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "delete_snapshots_on_delete": true,
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "name": "my-consistency-group-snapshots",
    "resource_group": {
        "id": "a41ca701e1c041c1bb224564ff645770",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/a41ca701e1c041c1bb224564ff645770",
        "name": "Default"
    },
    "lifecycle_state": "stable",
    "resource_type": "snapshot_consistency_group",
    "service_tags": [
        "is.instance:0727_44fda9fe-eeef-4e71-8fa4-4c3f7300e645"
    ],
    "snapshots": [
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "id": "r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "name": "my-test-scg-1",
            "resource_type": "snapshot"
        },
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "id": "r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "name": "my-test-scg-2",
            "resource_type": "snapshot"
        }
    ]
}

Affichage des instantanés avec Terraform

Vous pouvez utiliser Terraform pour afficher vos instantanés.

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

Liste de tous les instantanés avec Terraform

Importez les détails d'une collection d'instantanés en tant que source de données en lecture seule. Vous pouvez filtrer la collection d'instantanés par source_volume, resource_group, name, etc.

data "ibm_is_snapshots" "example" {
}

Pour plus d'informations, voir ibm_is_snapshots.

Affichage des détails d'un instantané avec Terraform

Importez les détails d'un instantané en tant que source de données en lecture seule. Vous pouvez spécifier l'ID de l'instantané ou le nom de l'instantané.

data "ibm_is_snapshot" "example" {
  identifier = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

data "ibm_is_snapshot" "example" {
  name = "snappy-snap-snap"
}
  • Les propriétés de allowed-used sont héritées du volume source ou de l'instantané au moment de la création. Vous pouvez modifier leur valeur au moment de la création ou ultérieurement si vous êtes autorisé à jouer le rôle IAM is.snapshot.snapshot.manage-allowed-use. Les propriétés comprennent une expression booléenne en langage d'expression commune. Lorsque l'expression instance est évaluée comme étant true, le provisionnement d'une instance de serveur virtuel est autorisé avec l'instantané. Lorsque l'expression est évaluée à false, le provisionnement est bloqué. Si la valeur n'est pas spécifiée au moment de la création, les expressions de la contrainte sont reprises de la ressource source.

Pour plus d'informations, voir ibm_is_snapshot.

Liste de tous les clones d'instantané de restauration rapide

Importez les détails de tous les clones de restauration rapide d'un instantané en tant que source de données en lecture seule.

data "ibm_is_snapshot_clones" "ds_snapshotclones" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

Pour plus d'informations, voir ibm_is_snapshot_clones.

Affichage des détails d'un clone de restauration rapide avec Terraform

Importez les détails du clone de restauration rapide d'un instantané dans une zone en tant que source de données en lecture seule.

data "ibm_is_snapshot_clone" "ds_snapshotclone" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
  zone     = "eu-de-1"
}

Pour plus d'informations, voir ibm_is_snapshot_clone.

Liste de tous les groupes de cohérence avec Terraform

Importez les détails d'une collection de groupes de cohérence en tant que source de données en lecture seule.

data "ibm_is_snapshot_consistency_groups" "example" {
}

Pour plus d'informations, voir ibm_is_consistency_groups.

Affichage des détails d'un groupe de cohérence avec Terraform

Importez les détails d'un groupe de cohérence d'instantané en tant que source de données en lecture seule. Vous pouvez spécifier le groupe de cohérence à l'aide de l'ID ou du nom du groupe de cohérence.

data "ibm_is_snapshot_consistency_group" "example 1" {
  identifier = ibm_is_snapshot_consistency_group.is_snapshot_consistency_group.id
}

data "ibm_is_snapshot_consistency_group" "example 2" {
  name = "my-data-consistency-group"
}

[Nouveau] :{: tag-green} Vous pouvez également filtrer la collection pour n'afficher que les groupes de cohérence des instantanés à l'aide de la propriété backup_policy_job.id. Consultez l'exemple suivant.

data "ibm_is_snapshot_consistency_groups" "example 3" {
    backup_policy_job = "r006-fc4b7fbc-38af-45d9-9fb6-bf0533acbfc4"
}

Pour plus d'informations, voir ibm_is_consistency_group.

Etapes suivantes

Vous pouvez modifier ou supprimer des instantanés et restaurer un volume à partir d'un instantané.