Gestion des volumes Block Storage for VPC

Détacher un volume « Block Storage for VPC » d'une instance de serveur virtuel

Vous pouvez déconnecter un volume de stockage par blocs connecté à une instance de serveur virtuel. La déconnexion libère le volume pour qu'il soit utilisé par une autre instance.

Pour détacher un volume, procédez comme suit.

1. Accédez à la liste de tous les volumes de stockage par blocs. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Block Storage volumes.
2. Localisez le volume et cliquez sur l'icône Actions pour ouvrir une liste d'options.
3. Dans le menu des options, cliquez sur Dissocier de l'instance.
4. Confirmez l'opération en cliquant sur Déconnecter l'instance dans la fenêtre ouverte.

Vous pouvez également cliquer sur un volume spécifique dans la liste de tous les volumes de stockage par blocs et accéder à la page Détails du volume de ce volume. Sous Instances connectées, cliquez sur le signe moins en regard de l'instance de serveur virtuel pour déconnecter le volume de cette instance.

Lorsque vous utilisez une instance Hyper Protect Virtual Servers for IBM Cloud® Virtual Private Cloud, le détachement du volume de données attaché à une instance en cours d'exécution entraîne l'échec de la charge de travail exécutée sur l'instance. Par conséquent, il est recommandé de ne pas déconnecter le volume de données.

Transfert d'un volume « Block Storage for VPC » d'une instance de serveur virtuel vers une autre

Pour transférer un volume de stockage par blocs vers une autre instance de serveur virtuel, procédez comme suit.

1. Déconnectez le volume de son instance de serveur virtuel.
2. Accédez à l'instance de serveur virtuel vers laquelle vous souhaitez transférer le volume. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation > Infrastructure > Compute > Instances de serveurs virtuels.
3. Sélectionnez une instance de serveur virtuel dans la liste.
4. Cliquez sur l'onglet Stockage pour afficher tous les volumes attachés au serveur.
5. Cliquez sur Attacher + ajouter un volume. Tous les volumes de stockage en blocs disponibles s'affichent.
6. Dans la liste des volumes, sélectionnez le volume que vous avez précédemment déconnecté.
7. Cliquez sur Sauvegarder.

Attacher un volume de données autonome à Block Storage for VPC

Vous pouvez créer plusieurs volumes de données de stockage par blocs pendant le provisionnement de l'instance, ces volumes sont automatiquement attachés à la nouvelle instance de serveur virtuel. Lorsque vous détachez un volume d'une instance, il existe en tant que volume autonome et s'affiche dans la liste de tous les volumes de stockage en bloc sans type d'attachement. Vous pouvez le connecter à une autre instance à partir de la liste des volumes de stockage par blocs.

1. Accédez à la liste de tous les volumes de stockage par blocs. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Block Storage volumes.
2. Localisez le volume, puis cliquez sur l'icône Actions pour ouvrir une liste d'options.
3. Dans le menu des options, cliquez sur Connecter à l'instance.
4. Sélectionnez une instance de serveur virtuel disponible.
5. Cliquez sur « Joindre » pour valider votre sélection.

Mise à jour du nom d'un volume « Block Storage for VPC »

Vous pouvez modifier le nom d'un volume existant pour le rendre plus significatif.

1. Accédez à la liste de tous les volumes de stockage par blocs. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Block Storage volumes.

2. Recherchez le volume, puis cliquez sur le nom du volume pour accéder à la page Détails du volume.

3. Cliquez sur l'icône Editer après le nom du volume pour modifier le nom. Indiquez un nom de volume valide.

   Les noms de volume valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Ils doivent commencer par une lettre minuscule. Les noms de volume doivent être uniques sur l'ensemble de l'infrastructure VPC. Par exemple, si vous créez deux volumes portant le même nom dans le même compte et la même région, une erreur « volume name duplicate » se produit.

4. Confirmez votre modification.

Ajouter des balises utilisateur à un volume Block Storage for VPC dans la console

Ajouter des balises utilisateur au stockage en bloc à partir de la liste des volumes ou de la page de détails des volumes.

1. Accédez à la liste des volumes de stockage en bloc. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Block Storage volumes.

2. Localisez le volume dans la liste pour lequel vous souhaitez ajouter des étiquettes utilisateur.

3. Dans la colonne tags, cliquez sur Add tags.

4. Saisissez les balises utilisateur que vous souhaitez attribuer à ce volume. Les étiquettes s'affichent au fur et à mesure de la saisie.

   Vous pouvez également ajouter des balises de gestion d'accès à un volume. Pour plus d'informations sur la création et l'ajout de balises de gestion des accès, voir Application de balises de gestion des accès à un volume.

5. Lorsque vous avez terminé d'ajouter des étiquettes, cliquez sur Sauvegarder. Lorsque vous actualisez l'écran, la liste des volumes indique le nombre de balises ajoutées dans la colonne Balises.

Vous pouvez également ajouter des balises à partir de la page des détails du volume. Pour ce faire, suivez les étapes suivantes.

1. Accédez à la liste des volumes de stockage en bloc.
2. Dans les détails du volume, cliquez sur Ajouter des étiquettes en regard du nom du volume.
3. Saisissez les balises utilisateur que vous souhaitez attribuer à ce volume. Une fois que vous avez terminé, cliquez sur Save.

Ajout de tags utilisateurs associés à une politique de sauvegarde à un volume dans la console

Vous pouvez ajouter à un volume de stockage en blocs des balises utilisateur associées à une stratégie de sauvegarde. Les stratégies de sauvegarde planifient la création automatique des instantanés de sauvegarde. Lorsqu'une étiquette de volume correspond à une étiquette de stratégie de sauvegarde pour les ressources cible, elle déclenche une sauvegarde du contenu du volume. Une stratégie de sauvegarde définit un plan de sauvegarde qui planifie l'exécution des instantanés de sauvegarde.

Dans la page Détails du volume, vous pouvez afficher les règles de sauvegarde qui sont appliquées au volume et ajouter des balises utilisateur associées à une règle de sauvegarde.

1. Accédez à la liste des volumes de stockage en bloc. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Block Storage volumes.
2. Recherchez le volume souhaité, puis cliquez sur le lien correspondant à son nom.
3. Dans la page de détails du stockage en bloc, cliquez sur l'onglet « Politiques de sauvegarde ».
4. Cliquez sur Associer.
5. Dans le volet latéral, sélectionnez une stratégie de sauvegarde dans la liste des stratégies disponibles, puis sélectionnez les balises de stratégie à appliquer au volume. Vous pouvez également consulter les détails du contrat, qui vous aideront à décider s'il convient de souscrire cette assurance.
6. Cliquez sur Appliquer les règles et les étiquettes. La stratégie de sauvegarde apparaît dans la liste des stratégies de sauvegarde associées au volume.

Lorsque vous accédez à la page de la stratégie de sauvegarde, le volume pour lequel vous avez ajouté des balises apparaît dans la liste des volumes.

Pour plus d'informations sur la création de sauvegardes, consultez la section « Création d'une stratégie de sauvegarde ». Pour plus d'informations sur les étiquettes utilisateur, voir Utilisation des étiquettes.

Mise à jour d'un nom de volume

Pour modifier un nom de volume, spécifiez le nom du volume ou son ID, puis indiquez le nouveau nom. Le nom du volume peut comporter jusqu'à 63 caractères alphanumériques, peut inclure des caractères spéciaux et doit commencer par une lettre minuscule. Le nom du volume doit être unique sur l'infrastructure VPC.

ibmcloud is volume-update VOLUME_ID [--name NEW_NAME] [--json]

Consultez l'exemple suivant.

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --name my-data-volume

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...
ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Name                                   my-data-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Status                                 available
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-01-22T00:54:01+00:00
Zone                                   us-south-2
Health State
Volume Attachment Instance Reference   -
Source snapshot                        ID                                          Name
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505
Active                                 false
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1

Ajouter des balises utilisateur à un volume Block Storage for VPC à partir de l'interface CLI

La commande 'ibmcloud is volume-update VOLUME avec l'option '--tags permet de mettre à jour les étiquettes utilisateur d'un volume. L'argument volume peut être défini par l'ID ou le nom du volume.

Utilisez la même option pour ajouter des balises à un volume lorsque vous créez un volume en utilisant 'ibmcloud is volume-create.

L'exemple suivant ajoute les balises utilisateur env:test et bkp:test à un volume identifié par l'ID. L'écran affiche des informations telles que le nom, l'état, la capacité, le profil de performance et l'emplacement. Les balises mises à jour apparaissent à la fin de la réponse.

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --tags dev:test

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...
ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Name                                   my-data-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Status                                 available
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-01-22T00:54:01+00:00
Zone                                   us-south-2
Health State
Volume Attachment Instance Reference   -
Source snapshot                        ID                                          Name
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505
Active                                 false
Adjustable IOPS                        false
Busy                                   false
Tags                                   dev:test
Storage Generation                     1

Mise à jour d'un montage de volume depuis l'interface en ligne de commande

Vous pouvez mettre à jour le nom du volume associé et modifier le paramètre par défaut de suppression automatique à l'aide de la commande « instance-volume-attachment-update ».

ibmcloud is instance-volume-attachment-update INSTANCE_ID VOLUME_ATTACHMENT_ID [--name NEW_NAME] [--auto-delete true | false] [--json]

Utilisez l'option « --name » et indiquez un nouveau nom pour le volume associé. Spécifiez --auto-delete true pour vous assurer que le volume est automatiquement supprimé lorsque l'instance est supprimée. Indiquez --auto-delete false si vous souhaitez conserver le volume en tant que volume autonome après la suppression de l'instance.

ibmcloud is instance-volume-attachment-update doc-test-ro otp1 --name one-true-pairing --auto-delete false

Updating volume attachment otp1 of instance doc-test-ro under account Test Account as user test.user@ibm.com...
ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c
Name              one-true-pairing
Volume            ID                                          Name
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update
Status            attached
Bandwidth(Mbps)   393
Type              data
Device            0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7
Auto delete       false
Created           2023-06-29T18:14:57+00:00

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is instance-volume-attachment-update.

Détacher un volume via l'interface en ligne de commande (CLI)

Utilisez la commande instance-volume-attachment-detach pour déconnecter un volume d'une instance et supprimer la connexion du volume. Le volume de stockage par blocs n'est pas supprimé, vous pourrez le connecter ultérieurement à une autre instance.

Dans la syntaxe de cette commande, INSTANCE est l'ID ou le nom de l'instance. VOLUME_ATTACHMENT est l'ID ou le nom de la connexion de volume. Vous pouvez spécifier plusieurs connexions de volume. Pour plus d'informations sur les connexions de volume, voir la référence de l'interface de ligne de commande pour la création d'une connexion de volume.

ibmcloud is instance-volume-attachment-detach INSTANCE (VOLUME_ATTACHMENT1 VOLUME_ATTACHMENT2 ...) [--output JSON] [-f, --force] [-q, --quiet]

ibmcloud is instance-volume-attachment-detach kj-test-ro one-true-pairing

This will delete volume attachment one-true-pairing and cannot be undone. Continue [y/N] ?> y
Deleting volume attachment one-true-pairing from instance kj-test-ro under account Test Account as user test.user@ibm.com...
OK
Volume attachment one-true-pairing is deleted.

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is instance-volume-attachment-detach.

Un volume de démarrage ne peut pas être détaché d'une instance tant que celle-ci existe. Si vous souhaitez conserver le volume de démarrage après la suppression de l'instance, assurez-vous que l'option auto-delete de l'attachement au volume est définie sur false.

Mise à jour du nom d'un volume via l'API

Effectuez un appel PATCH /volumes/{id} et indiquez un nouveau nom pour le volume.

curl -X PATCH "$vpc_api_endpoint/v1/volumes/$volume_id?version=2022-04-22&generation=2"  \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-volume-4-update"
    }'

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

{
  "capacity": 50,
  "created_at": "2022-04-22T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 100,
  "name": "my-volume-4-update",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

Ajouter des balises utilisateur à un volume Block Storage for VPC avec l'API

Pour ajouter des étiquettes utilisateur à un volume, vous devez d'abord effectuer un appel GET /volumes/{volume_id} et copier la chaîne de hachage de la propriété Etag dans l'en-tête de réponse. Vous utilisez ensuite la chaîne de hachage lorsque vous spécifiez If-Match dans une demande PATCH /volumes/{volume_id} pour créer de nouvelles étiquettes utilisateur.

Pour appliquer des balises à un volume de stockage par blocs, procédez comme suit :

1. Effectuez une requête de type « GET /volumes/{volume_id} » et copiez la chaîne de caractères de hachage figurant dans la propriété « Etag » de l'en-tête de réponse. Vous devez utiliser la chaîne de hachage lorsque vous spécifiez « If-Match » dans la requête « PATCH /volumes/{volume_id} » afin de créer des balises utilisateur pour le volume à l'étape 2. Pour générer les informations de l'en-tête de réponse, effectuez un appel API similaire à l'exemple suivant :

   curl -sSL -D GET\
   "https://us-south.iaas.cloud.ibm.com/v1/volumes/{volume_id}?version=2022-04-25&generation=2"\
   -H "Authorization: Bearer $TOKEN" -o /dev/null
   

   Dans l'en-tête de réponse, vous voyez quelque chose comme ceci :

   HTTP/2 200
   date: Tue, 28 Apr 2022 17:48:03 GMT
   content-type: application/json; charset=utf-8
   content-length: 1049
   cf-ray: 69903d250c4966ef-DFW
   cache-control: max-age=0, no-cache, no-store, must-revalidate
   expires: -1
   strict-transport-security: max-age=31536000; includeSubDomains
   cf-cache-status: DYNAMIC
   expect-ct: max-age=604800, report-uri="[uri...]"
   pragma: no-cache
   x-content-type-options: nosniff
   x-request-id: 1fbe2384-6828-4503-ae7d-050426d1b11b
   x-xss-protection: 1; mode=block
   server: cloudflare
   etag: W/xxxyyyzzz123
   

2. Effectuez une demande PATCH /volumes/{volume_id}. Indiquez Etag-hash-string pour la propriété If-Match dans l'en-tête. Indiquez la balise utilisateur dans la propriété « user_tags ».

   Vous pouvez également ajouter des balises lorsque vous faites un appel " POST /volumes pour créer un volume et que vous spécifiez la propriété " user_tags.

   Cet exemple met à jour le volume en spécifiant les balises utilisateur env:test et env:prod. La valeur obtenue à partir du paramètre " Etag est spécifiée dans l'en-tête " If-Match de l'appel.

   curl -X PATCH\
   "$vpc_api_endpoint/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34?version=2025-01-21&generation=2"\
      -H "Authorization: Bearer $iam_token"\
      -H "If-Match: <_Etag-hash-string_>"\
      -d `{
         "user_tags": [
            "env:test",
            "env:prod"
         ]
      }'
   

   La réponse affiche les balises qui ont été ajoutées au volume :

   {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2025-01-22T00:54:01.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "iops": 3000,
    "name": "my-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "name": "wdc-fst-rstore-c6a092f34118-4505",
        "resource_type": "snapshot"
    },
    "status": "available",
    "status_reasons": [],
    "adjustable_capacity_states": [
        "attached"
    ],
    "storage_generation": 1,
    "user_tags": [
        "env:test",
        "env:prod"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
   }
   

Mise à jour d'un volume attaché via l'API

Appelez la méthode PATCH /instances/$instance_id/volume_attachments/$volume_attachment_id et indiquez les identifiants de l'instance et du volume associé. Dans le corps de la demande, indiquez le nouveau nom de la pièce jointe ou la nouvelle valeur de la propriété delete_volume_on_instance_delete. Si la propriété delete_volume_on_instance_delete est définie sur true, lorsque l'instance est supprimée, le volume attaché est supprimé. Si vous souhaitez conserver le volume après la suppression de l'instance, spécifiez la valeur « false » pour la propriété « delete_volume_on_instance_delete ».

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "delete_volume_on_instance_delete": false,
      "name": "my-volume-attachment-data-5iops-updated"
    }'

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

{
  "created_at": "2022-04-22T16:35:47.000Z",
  "delete_volume_on_instance_delete": false,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "id": "9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "name": "my-volume-attachment-data-5iops-updated",
  "status": "attached",
  "type": "data",
  "volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "name": "my-volume-data-5iops"
  }
}

Déconnexion d'un volume à l'aide de l'API

Pour supprimer un volume associé, effectuez une requête « DELETE /instances/{instance_id}/volume_attachments/{id} » et indiquez l'ID de ce volume associé. La suppression d'une connexion de volume déconnecte un volume d'une instance.

curl -X DELETE "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: Bearer $iam_token"

Un volume de démarrage ne peut pas être détaché d'une instance tant que celle-ci existe. Si vous souhaitez conserver le volume de démarrage après la suppression de l'instance, assurez-vous que la propriété delete_volume_on_instance_delete de l'attachement au volume est définie sur false.

Vérifiez que le volume est déconnecté de l'instance en effectuant un appel GET /instances/{instance_id}.

Mise à jour du nom d'un volume avec Terraform

Pour modifier le nom d'un volume, utilisez la ressource " ibm_is_volume L'exemple suivant spécifie le volume " r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4 et son nouveau nom " my-new-name-volume. Une fois appliqué, le volume est renommé.

resource "ibm_is_volume" "example" {
  name    = "my-new-name-volume"
  id      = "r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4"
  profile = "10iops-tier"
  zone    = "us-south-1"
}

Appliquer des balises aux volumes avec Terraform

Pour appliquer des balises utilisateur à un volume, utilisez la ressource 'ibm_is_volume L'exemple suivant spécifie le volume " my-new-volume et l'étiquette " dev:test à attacher au volume. Lorsqu'elle est appliquée, la balise est ajoutée au volume.

resource "ibm_is_volume" "example" {
  name    = "my-new-volume"
  profile = "10iops-tier"
  zone    = "us-south-1"
  tags    = ["dev:test"]
}