Renommer un instantané dans la console

Suivez les étapes ci-dessous pour renommer un instantané dans la console.

1. Accédez à la liste des instantanés. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Partages de stockage de fichiers.
2. Les partages de fichiers sont répertoriés pour une région spécifique. Si vous souhaitez voir les ressources d'une autre région, cliquez sur la flèche pour développer la liste et sélectionnez une autre région. Par défaut, les partages les plus récents apparaissent en tête de liste.
3. Sélectionnez le partage de fichiers que vous souhaitez visualiser, puis cliquez sur l'onglet Instantanés.
4. Localisez l'instantané dans la liste, puis cliquez sur l' et sélectionnez Renommer.
5. Saisissez le nouveau nom, puis cliquez sur « Renommer ».

Mise à jour des étiquettes utilisateur d'un instantané dans la console

Procédez comme suit pour mettre à jour les étiquettes utilisateur d'un instantané dans la console.

1. Accédez à la liste des instantanés. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Partages de stockage de fichiers.
2. Les partages de fichiers sont répertoriés pour une région spécifique. Si vous souhaitez voir les ressources d'une autre région, cliquez sur la flèche pour développer la liste et sélectionnez une autre région. Par défaut, les partages les plus récents apparaissent en tête de liste.
3. Sélectionnez le partage de fichiers que vous souhaitez visualiser, puis cliquez sur l'onglet Instantanés.
4. Cliquez sur le nom d'un instantané pour ouvrir le panneau de détails de l'instantané.
5. Cliquez sur l'icône Editer à côté des balises utilisateur.
6. Vous pouvez supprimer les balises existantes et en ajouter de nouvelles. Cliquez sur Sauvegarder.

Mise à jour des détails d'un instantané à partir de la CLI

ibmcloud login --sso -a cloud.ibm.com

Mise à jour des balises utilisateur d'un instantané depuis l'interface de ligne de commande

Vous pouvez mettre à jour les étiquettes utilisateur attribuées à un instantané à partir de l'interface de ligne de commande. Exécutez la commande ibmcloud is share-snapshot-update et indiquez l'ID de l'instantané et la nouvelle étiquette.

ibmcloud is share-snapshot-update SHARE SNAPSHOT --tags NEW_TAG1,NEW_TAG2 [--output JSON] [-q, --quiet]

Voir l'exemple suivant, qui ajoute une étiquette d'utilisateur.

ibmcloud is share-snapshot-update my-file-share r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 --user-tags test:cli

Updating file share snapshot share-snapshot-cli-update for share my-file-share under account Test Account as user test.user@ibm.com...
ID                   r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
Name                 share-snapshot-cli-update
Fingerprint          c25fdce4-6e0a-433f-99c0-9985f127cd54
Backup Policy Plan   -
Status               available
Status reasons       Status code   Status message
                     -             -
Created at           2024-12-17T11:19:33+05:30
Captured At          2024-12-17T11:19:34+05:30
CRN                  crn:v1:bluemix:public:is:us-south-1:a/a123456::share-snapshot:r006-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
LifeCycle State      stable
LifeCycle Reasons    Code   Message   More Info
                      -      -
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r006-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/snapshots/r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
Minimum Size         40
User Tags            test:cli
Zone                 ID   Name
                          us-south-1
Resource group       ID                                 Name
                     11caaa983d9c4beb82690daab08717e9   Default
Resource type        share_snapshot

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.

Renommer un instantané via l'API

Vous pouvez renommer un instantané en utilisant l'API. Effectuez un appel « PATCH /shares/{share-id}/snapshots/{snapshot-id} » et indiquez l'ID du snapshot ainsi que son nouveau nom.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "name": "my-snapshot-renamed"
   }'

Mise à jour des étiquettes utilisateur avec l'API

Vous pouvez mettre à jour les étiquettes utilisateur d'un instantané à l'aide de l'API. Faites une demande à PATCH /shares/{share-id}/snapshots/{snapshot-id} et spécifiez l'ID de l'instantané et les balises que vous souhaitez voir figurer sur l'instantané.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "user_tags": ["env:test","dev:test"]
    }'

Mise à jour d'un snapshot avec Terraform

Pour utiliser Terraform, téléchargez l'interface CLI de Terraform et configurez le plug-in « IBM Cloud Provider ». Pour plus d'informations, voir Démarrer avec Terraform.

Les services d'infrastructure VPC utilisent un point de terminaison régional spécifique, qui cible par défaut us-south. Si votre VPC est créé dans une autre région, assurez-vous de cibler la région appropriée dans le bloc fournisseur du fichier provider.tf.

Voir l'exemple suivant de ciblage d'une région autre que la région par défaut us-south.

provider "ibm" {
  region = "eu-de"
}

Pour mettre à jour un instantané, utilisez la ressource ibm_is_share_snapshot. Vous pouvez modifier les balises de l'instantané en les ajoutant avec l'argument tags.

resource "ibm_is_share_snapshot" "example" {
  tags          = "dev:test"
  source_share  = ibm_is_share.example.id
  }

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_snapshot.

Suppression d'instantanés dans la console

Vous pouvez supprimer n'importe quel instantané d'un partage. Pour pouvoir supprimer un instantané, celui-ci doit répondre aux conditions suivantes :

• Avoir l'état stable ou pending.
• Ne pas être en train de restaurer activement un partage.

Pour savoir si vous pouvez supprimer un instantané, il suffit de consulter la liste des instantanés dans la console et de vérifier son état.

Suppression d'instantanés depuis l'interface de ligne de commande

Vous pouvez supprimer n'importe quel instantané d'un partage ou tous les instantanés d'un partage. Pour pouvoir supprimer un instantané, celui-ci doit répondre aux conditions suivantes :

• Avoir l'état stable ou pending.
• Ne pas être en train de restaurer activement un partage.

Procédez comme suit pour supprimer un seul instantané à l'aide de la CLI.

1. Listez les instantanés disponibles pour un partage afin de confirmer l'ID de l'instantané que vous souhaitez supprimer.

   ibmcloud is share-snapshots SHARE [--output JSON] [-q, --quiet]
   

   ibmcloud is share-snapshots my-file-share
   

2. Exécutez la commande ibmcloud is share-snapshot-delete et indiquez l'ID de l'instantané. Pour supprimer plusieurs instantanés, vous devez spécifier tous leurs identifiants dans la même commande.

   ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet]
   

3. Confirmez la suppression de l'instantané. Le message de réponse indique que l'image instantanée est supprimée.

   $ ibmcloud is share-snapshot-delete my-file-share r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
   This will delete share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share and cannot be undone. Continue [y/N] ?> y
   Deleting share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share under account Test Account as user test.user@ibm.com...
   OK
   Share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 is deleted.
   

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

Suppression d'instantanés via l'API

Vous pouvez supprimer n'importe quel instantané d'un partage ou tous les instantanés d'un partage. Pour pouvoir supprimer un instantané, celui-ci doit répondre aux conditions suivantes :

• Avoir l'état stable ou pending.
• Ne pas être en train de restaurer activement un partage.

Appelez la méthode DELETE /shares/{share-id}/snapshots/{snapshot-id} pour supprimer un instantané spécifique par ID.

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

Suppression d'instantanés avec Terraform

Vous pouvez supprimer n'importe quel instantané d'un partage ou tous les instantanés d'un partage. Pour pouvoir supprimer un instantané, celui-ci doit répondre aux conditions suivantes :

• Avoir l'état stable ou pending.
• Ne pas être en train de restaurer activement un partage.

Utilisez la commande « terraform destroy » pour supprimer facilement un objet distant tel qu'un instantané unique. L'exemple suivant supprime my-snapshot.

terraform destroy --target ibm_is_snapshot.my-snapshot

Pour plus d'informations, voir terraformer détruire.