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

Pour obtenir des informations détaillées sur un instantané, localisez l'instantané sur la page de détails du partage de fichiers. Cliquez ensuite sur le nom d'un instantané. Le panneau latéral Détails de l'instantané affiche des informations telles que le nom de l'instantané, son CRN et son ID, ainsi que les étiquettes de gestion des utilisateurs et des accès attachées.

Bien qu'il ne soit pas possible de créer un instantané sur un partage répliqué, les instantanés du partage source sont générés automatiquement sur la réplique lors de la prochaine synchronisation de réplication prévue. Ces instantanés répliqués sont créés par le service de fichiers. Ils n'héritent pas des noms ou des balises des instantanés originaux. Cependant, ils ont les mêmes valeurs d'empreintes digitales que les instantanés source.

Le tableau suivant décrit les informations qui peuvent être visualisées dans le panneau de détails de l'instantané.

Détails de l'instantané

Zone	Description
Nom	Le nom de l'instantané, que vous pouvez modifier en cliquant sur l'icône Editer . Pour plus d'informations, voir Désignation des instantanés.
ID	UUID copiable de l'instantané.
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.
Statut	Par exemple, stable.
Emplacement	Identique à l'emplacement du partage de fichiers source.
Date de création	Date et heure de démarrage du processus de création d'une ressource d'instantané.
Taille du partage de fichiers source	Taille du partage au moment où l'instantané a été pris, en Go.
Partage de fichiers source	Source à partir de laquelle le premier instantané a été créé. Cliquez sur le lien pour consulter les détails de l'offre.
Chiffrement	Cryptage géré par le fournisseur ou par le client. Pour le chiffrement géré par le client, l'instance KMS, le nom de la clé racine et l'ID de la clé racine sont indiqués.
Empreinte digitale	L'ID de référence que vous pouvez utiliser pour localiser l'instantané dans le dossier .snapshot.
Etiquettes utilisateur	Les balises que vous avez ajoutées. Ce champ est vide lorsque vous examinez des instantanés sur un partage de réplique.
Créé par	Il indique si l'instantané a été créé par l'utilisateur ou par une politique de sauvegarde. Le champ indique la réplication lorsque les instantanés sont visualisés sur un partage de fichiers répliqué.

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

• Renommer.
• Supprimer.
• Restaurer.

Le menu Actions est dynamique. Si le partage est un partage réplique, seule l'action Restaurer est affichée. Si le partage est un partage source ou n'a pas de réplique, les 3 actions sont disponibles.

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

Visualisation de tous les instantanés de la région à partir de la CLI

Exécutez la commande ibmcloud is share-snapshots pour voir tous les instantanés disponibles dans la zone.

ibmcloud is share-snapshots [--share SHARE] [--backup-policy-plan BACKUP_POLICY_PLAN [--backup-policy BACKUP_POLICY]] [--output JSON] [-q, --quiet]

ibmcloud is share-snapshots

Listing share snapshots in all resource groups and region au-syd under account Test Account as user test.user@ibm.com...
ID                                          Name                                Created at                  Fingerprint                            Minimum Size   Lifecycle state   Zone       Status      User Tags
r026-c8fd81f8-3437-424e-8fc0-f9dd2f4766d3   demo-bkp-plan-2-02ae167865c0-44e8   2024-12-09T16:55:13+05:30   15b9509d-b6f8-461b-987a-2333be203e0e   40             stable            au-syd-1   available   dev:tags
r026-9997158e-daa6-409d-8e51-b2bbbc23c5d2   demo-bkp-plan-2-29e97584db07-4e86   2024-12-09T16:55:12+05:30   0b9c1e17-d872-4858-b478-a4d46cfd3dfe   40             stable            au-syd-1   available   dev:tags
r026-d04eb5f7-4159-4fa0-bfdd-83deca3b73b0   demo-bkp-plan-2-2b8c5b1bcadc-496f   2024-12-09T18:55:14+05:30   622a0e1f-7a48-4dce-adf0-c54adb4605c3   40             stable            au-syd-1   available   dev:tags
r026-9289ba15-a922-4b75-9650-7afc9471e9d9   demo-bkp-plan-2-47a13671bf22-47e0   2024-12-09T17:55:11+05:30   9a433610-0134-4162-8af3-d9358af832b5   40             stable            au-syd-1   available   dev:tags
r026-bee1b285-adc3-43e6-b8dd-5645efbe5732   demo-bkp-plan-2-4a90deb0778a-4f1a   2024-12-09T17:55:11+05:30   f8ec608d-9fbc-48cf-9018-01b1a8711449   40             stable            au-syd-1   available   dev:tags

Pour les instantanés de partages de fichiers régionaux, la valeur de la zone est vide dans les réponses de la CLI et de l'API.

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

ibmcloud is share-snapshots r026-734c173e-044f-4d09-a729-950364ea9900

Listing share snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                         Name                    Created at               Fingerprint                          Minimum size Lifecycle state Zone      Status    User Tags
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146  my-first-share-snapshot 024-12-18T20:15:43+00:00 7abc3aef-c2bc-4f65-a296-2928e534d498 40           stable          us-south-1 Available env:test

ibmcloud is share-snapshots [--backup-policy-plan BACKUP_POLICY_PLAN] [--backup-policy BACKUP_POLICY]

ibmcloud is share-snapshots --backup-policy-plan r006-158e0d66-338e-4501-b756-be0732677da8 --share my-file-share

Listing share snapshots of share my-file-share under account Test Account as user test.user@ibm.com...
ID                                          Name                                Created at                  Fingerprint                            Minimum Size   LifeCycle State   Zone         Status      User Tags
r006-b4d12d66-18de-4660-9fe7-12e667d5ed5b   demo-bkp-plan-1-d619b2fb4a68-4602   2024-11-19T11:33:27+05:30   643ce8da-bbbd-4515-b988-701aea2667df   40             stable            us-south-1   available   dev:tags
r006-59d25cac-92cd-4076-b988-e5d6746a848f   demo-bkp-plan-1-e4406ae16e8f-4cb0   2024-11-19T12:32:23+05:30   202a5bd4-a1e0-4d89-914c-3574f45fc725   40             stable            us-south-1   available   dev:tags
r006-41785c6b-5d48-4dc1-89b7-21a5b2ada21e   demo-bkp-plan-1-efc6f81b8505-4782   2024-11-19T10:32:19+05:30   acd57e05-ffe2-4eed-8e78-40b5000c53d3   40             stable            us-south-1   available   dev:tags

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

Exécutez la commande ibmcloud is share-snapshot avec l'ID de l'instantané, ou le nom de l'instantané et le nom ou l'ID du partage. Les identifiants d'instantanés sont uniques pour l'ensemble du compte. Toutefois, les noms des instantanés ne sont uniques qu'au niveau de l'instantané.

ibmcloud is share-snapshot SHARE_SNAPSHOT [--output JSON] [-q, --quiet]

L'exemple suivant présente les détails d'un instantané.

ibmcloud is share-snapshot my-file-share r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd

Getting share snapshot ID r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd for share ID my-file-share under account Test Account as user test.user@ibm.com...

ID                   r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Name                 my-first-share-snapshot
Fingerprint          7f29bdd5-bc67-4e67-9b24-638a73be4742
Backup Policy Plan   -
Status               available
Created at           2025-03-10T19:17:55+00:00
Captured At          2025-03-10T19:17:58+00:00
CRN                  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-d14e4b29-cb73-4886-a267-b2cd58d67641/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
LifeCycle Reasons    Code   Message   More Info
                     -      -

LifeCycle State      stable
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d14e4b29-cb73-4886-a267-b2cd58d67641/snapshots/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Minimum Size         10
Zone                 ID   Name
                          us-south-2

Resource group       ID                                 Name
                     6edefe513d934fdd872e78ee6a8e73ef   defaults

Status reasons       Status code   Status message
                     -             -

Resource type        share_snapshot

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

Répertorier tous les instantanés via l'API

Vous pouvez dresser une liste programmatique de tous les instantanés de vos parts en appelant la méthode /shares/{share-id}/snapshots dans l'API VPC, comme le montre 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/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
  -H "Authorization: Bearer $iam_token"

Vous pouvez filtrer la liste en utilisant l'ID du plan de sauvegarde pour afficher les instantanés qui ont été pris par une politique de sauvegarde. Par exemple, l'appel suivant filtre la liste pour afficher les instantanés créés par un plan de sauvegarde spécifique et limite le nombre de résultats à cinq par page.

curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "limit": 5,
      "backup_policy_plan":
        "id": "r006-b470ae68-8325-4a9c-9051-1ade8c3806c3"
      }'

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

{
  "limit": 5,
  "snapshots": [
    {
      "captured_at": "2024-12-10T01:21:12.000Z",
      "created_at": "2024-12-10T01:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-first-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    },
    {
      "captured_at": "2024-12-10T02:21:12.000Z",
      "created_at": "2024-12-10T02:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "9bbc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-second-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    }
  ],
  "total_count": 1
}

Pour les instantanés de partages de fichiers régionaux, la valeur de la zone est vide dans les réponses de la CLI et de l'API.

Afficher les détails d'un instantané via l'API

Vous pouvez récupérer par programme les détails d'un seul instantané en appelant la méthode /shares/{share-id}/snapshots/{snapshot-id} dans l'API VPC et en spécifiant l'ID du partage et l'ID de l'instantané, comme indiqué dans l'exemple de demande suivant.

curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"

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

    {
      "captured_at": "2024-12-10T01:21:12.000Z",
      "created_at": "2024-12-10T01:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    },

Pour les instantanés de partages de fichiers régionaux, la valeur de la zone est vide dans les réponses de la CLI et de l'API.

Lister tous les snapshots d'un partage de fichiers avec Terraform

Importer 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_share, resource_group, name, etc.

data "ibm_is_snapshots" "example" {
}

Pour plus d'informations, voir ibm_is_snapshots.

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

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

data "ibm_is_share_snapshot" "example" {
    share_snapshot = ibm_is_share_snapshot.example.share_snapshot
    share = ibm_is_share.example.id
}

Pour plus d'informations, voir ibm_is_share_snapshot.