Afficher les informations sur tous les volumes Block Storage for VPC dans la console

Accédez à la liste des volumes Block Storage for VPC. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation > Infrastructure > Stockage > Block Storage volumes.

Par défaut, les volumes Block Storage for VPC sont affichés par lots de 10 pour tous les groupes de ressources de votre région. Pour modifier ce paramètre par défaut, cliquez sur la flèche vers le bas du contrôle de page et augmentez le nombre d'éléments de la liste à 20 ou 50. Utilisez les flèches de contrôle de page pour aller à la page suivante ou revenir. Dans la liste de tous les volumesBlock Storage for VPC, vous voyez les informations suivantes.

Détails sur tous les volumes

Zone	Description
Région	Région où se trouvent ces volumes, par exemple US South. Cliquez sur la flèche vers le bas pour afficher les volumes disponibles dans une autre région où vous disposez d'un compte.
Nom	Cliquez sur le nom du volume pour afficher les détails de chaque volume.
Statut	Statut du volume, qui sert de filtre par défaut pour toutes les lignes.
Emplacement	Zone de disponibilité dans votre région, héritée du VPC (par exemple, US South 1).
Taille	Taille du volume que vous avez spécifié, en Go.
Type de connexion	Données, pour un volume secondaire connecté à une instance, amorçage si le volume est connecté en tant que volume d'amorçage ou vide pour un volume non connecté.
Etat	La fonction Health surveille l'état général du volume, notamment les performances d'E/S et la cohérence des données. Les statuts de santé du volume sont OK ou degraded. Les volumes dans un état dégradé ont des performances, une capacité ou des problèmes de connexion dégradés. Les volumes en cours de restauration à partir d'une image instantanée affichent également un état dégradé. Le service affiche une cause possible de l'état dégradé afin que vous puissiez résoudre les problèmes. Pour plus d'informations, voir Block Storage for VPC état de santé du volume.
Chiffrement	Le chiffrement à l'aide de clés gérées par IBM est activé par défaut sur tous les volumes. Vous pouvez également utiliser vos propres clés racines dans une instance d’ Key Protect pour protéger vos données. Pour plus d’informations, consultez la section Création de volumes d’ Block Storage for VPC s avec chiffrement géré par le client.
Balises	Nombre de balises utilisateur appliquées au volume. Cliquez sur le numéro dans cette colonne pour afficher ou modifier les balises dans une nouvelle fenêtre. Si aucune balise n'a été appliquée au volume, cliquez sur Ajouter des balises et ajoutez-les dans la nouvelle fenêtre. Les balises utilisateur peuvent associer le volume à une règle de sauvegarde pour créer des sauvegardes du volume. Pour plus d'informations, voir Ajout de balises utilisateur associées à une politique de sauvegarde à un volume dans la console.
Actions	Cliquez sur Actions pour afficher un menu d'actions spécifiques au contexte que vous pouvez entreprendre.

Dans le menu Actions ( de la page de liste des volumes, les actions suivantes sont disponibles. Certaines actions ne sont disponibles que lorsque le volume remplit des conditions spécifiques, par exemple lorsqu'il est monté ou démonté.

• Renommer: renommer ce volume.
• Attacher au serveur: attacher un volume non attaché à une instance de serveur virtuel. Cette action n'est disponible que lorsque le volume n'est pas monté. Pour plus d'informations, voir Connecter un volume à une instance.
• Détacher de l'instance: détache un volume attaché de son instance de serveur virtuel. Cette action n'est disponible que lorsque le volume est monté. Pour plus d'informations, consultez la section Détacher un volume d'une instance de serveur virtuel.
• Créer un instantané: créez un instantané de ce volume. Cette action peut apparaître en gris lorsqu'elle n'est pas disponible. Pour plus d'informations, consultez la section Création d'un instantané dans la console.
• Créer une image: créer une image personnalisée à partir d'un volume de démarrage. Cette action peut apparaître en gris lorsqu'elle n'est pas disponible. Pour plus d'informations, voir Création d'une image à partir d'un volume dans la console.
• Ajouter des balises ou modifier des balises: ajoutez ou modifiez les balises utilisateur et accédez aux balises de gestion de ce volume. Pour plus d'informations, voir Utilisation d'étiquettes.
• Supprimer- supprimer ce volume. Cette action est grisée lorsque le volume est associé à une instance. Pour plus d'informations, voir Suppression d'un volume de données dans la console.
• Migrer le volume: migrez ce volume vers un autre profil ou une autre configuration. Pour plus d'informations, consultez la section Migration des volumes de stockage en blocs.

Afficher les détails d'un volume Block Storage for VPC

Pour afficher les détails d'un volume d' Block Storage for VPC, accédez à la liste de tous les volumes d' Block Storage for VPC et sélectionnez-en un.

En regard du nom du volume figurent le statut du volume et les étiquettes associées à ce volume. Les étiquettes utilisateur identifient la ressource. Lorsque des balises utilisateur sont associées à une politique de sauvegarde, elles sont utilisées pour créer des instantanés de sauvegarde du volume. Avec les balises de gestion des accès, vous pouvez créer des regroupements de ressources flexibles pour la gestion des accès. Pour plus d'informations sur ces balises, voir Utilisation de balises.

Informations spécifiques à chaque volume

La page comporte 4 onglets. Par défaut, l'onglet Présentation est sélectionné pour les détails du volume.

Détails du volume

Zone	Description
Détails du volume
Nom	Nom du volume que vous avez spécifié lors de sa création. Cliquez sur l'icône Editer pour éditer le nom du volume. Le nom du volume peut comporter jusqu'à 63 caractères alphanumériques minuscules et inclure un trait d'union (-) et doit commencer par une lettre minuscule. Les noms de volume doivent être uniques pour le compte et pour la région.
ID volume	ID de volume généré par le système.
Etat	La fonction Health surveille l'état général du volume, notamment les performances d'E/S et la cohérence des données. Les statuts de santé du volume sont OK ou degraded. Les volumes dans un état dégradé ont des performances et une capacité inférieures à la normale, ou ils rencontrent des problèmes de connexion. Les volumes en cours de restauration à partir d'une image instantanée affichent également un état dégradé. Le service affiche une cause possible de l'état dégradé afin que vous puissiez le résoudre. Pour plus d'informations, voir Block Storage for VPC état de santé du volume.
Groupe de ressources	Groupe de ressources défini lors de la configuration de votre VPC. Les groupes de ressources gèrent l'accès aux ressources mais n'affectent pas la facturation ou la surveillance.
Type de connexion	Données : pour un volume secondaire associé à une instance, boot lorsqu'il est associé en tant que volume de démarrage, ou vide pour un volume non associé.
Date de création	Date générée par le système lorsque le volume a été créé.
Emplacement	Zone de disponibilité dans votre région.
Taille	Taille du volume que vous avez spécifié. Lorsque le volume est connecté à une instance de serveur virtuel sans avoir atteint la capacité maximale de sa plage, vous pouvez cliquer sur l'icône pour l'étendre. Pour plus d'informations, voir l'extension de la capacité du volume Block Storage for VPC.
Profil	Ce champ affiche le profil de volume: sdp, IOPS personnalisées ou l'un des profils de niveau d'IOPS.
Nbre max. d'IOPS	Valeur maximale d'IOPS pour un niveau d'IOPS prédéfini ou valeur que vous avez spécifiée pour des IOPS personnalisés.
Débit	Ce champ indique la bande passante allouée au volume de stockage, qui est mesurée en gigabits par seconde (Gbps). Le débit est calculé comme le résultat du nombre d'IOPS pour lequel le volume est provisionné multiplié par le multiplicateur de débit. Selon le profil de volume, le multiplicateur de débit peut être de 16 Ko ou de 256 Ko. Pour les volumes créés avec le profil sdp, la valeur du débit est personnalisable entre 1000 et 8192 Mbps.
Chiffrement	Le chiffrement à l'aide de clés gérées par IBM est activé par défaut sur tous les volumes. Vous pouvez également utiliser vos propres clés racine pour protéger vos données. Le champ Encryption affiche le nom du service de gestion des clés (KMS) que vous avez provisionné (par exemple, Key Protect ) et géré par le client. Pour plus d'informations, voir Création de volumes Block Storage for VPC avec le chiffrement géré par le client.
Instance de chiffrement	Facultatif. Lien vers l'instance KMS mise à disposition pour un volume de chiffrement géré par le client.
Clé	Facultatif. Le nom et l'identifiant copiable de la clé racine utilisée pour chiffrer la phrase de passe, qui sécurise un volume chiffré géré par le client.
Stratégies de sauvegarde	Nombre de règles de sauvegarde associées au volume. Cliquez sur le lien de nombre pour accéder à l'onglet des stratégies de sauvegarde.
Instantanés	Nombre d'instantanés créés du volume. Cliquez sur le lien de nombre pour accéder à l'onglet Instantanés et sauvegardes.
Rôle de réplication	Rôle de ce volume dans une relation de réplication : source, replica, ou none. Ce champ n'est présent que pour les volumes de profil sdp.
Serveur virtuel connecté	Les volumes connectés à une instance de serveur virtuel sont répertoriés ici. Cliquez sur Attacher pour sélectionner une instance à laquelle associer ce volume. Pour plus d'informations, voir Connecter un volume à une instance.
Statut	Ce champ permet de suivre l'état général du cycle de vie du volume, qui va de la création à la suppression du volume. L'état de la pièce jointe, par exemple, est « joint » lorsque le volume est attaché à une instance et « en cours de rattachement » lorsqu'il est en cours.
Nom	Cliquez sur le nom de l'instance de serveur virtuel pour voir les détails de l'instance.
Supprimer automatiquement	Lorsque cette option est activée, le volume est automatiquement supprimé lorsque vous supprimez l'instance. Cliquez sur la bascule pour activer la suppression automatique.
Stratégies de sauvegarde	Affiche les règles de sauvegarde associées à ce volume. Pour associer des stratégies de sauvegarde, vous pouvez ajouter des balises de stratégie de sauvegarde pour les ressources cible à ce volume. Cliquez sur Appliquer pour sélectionner une règle de sauvegarde, puis appliquez ses balises pour la ressource cible au volume.

Dans le menu Actions ( de la page de détails du volume, les actions suivantes sont disponibles :

• Afficher le suivi des activités: consultez le journal de suivi des activités pour ce volume.
• Créer un instantané: créez un instantané à partir d'un volume de données connecté ou d'un volume de démarrage. Pour plus d'informations, consultez la section Création d'un instantané dans la console.
• Créer une image: créer une image personnalisée à partir d'un volume de démarrage. Cette action est grisée lorsqu'elle n'est pas disponible. Pour plus d'informations, voir Création d'une image à partir d'un volume dans la console.
• Extension d'un volume: augmentez la taille d'un volume attaché par incréments de 1 Go. Pour plus d'informations, voir Extension de la capacité du volume de stockage par blocs.
• Modifier le profil IOPS: modifiez les caractéristiques de performance d'un volume de données connecté en augmentant ou en diminuant le nombre d'IOPS via le profil IOPS.
• Appliquer une stratégie de sauvegarde: appliquez une stratégie de sauvegarde à ce volume. Pour plus d'informations, consultez la section Application des stratégies de sauvegarde aux ressources.
• Migrer un volume: migrez ce volume vers un autre profil. Pour plus d'informations, consultez la section Migration des volumes de stockage en blocs.
• Supprimer: supprimer un volume non monté. Pour plus d'informations, voir Suppression d'un volume de données dans la console.

Pour afficher la liste des instantanés de ce volume créés manuellement ou via une politique de sauvegarde, cliquez sur l'onglet Instantanés et sauvegardes.

Affichage des détails du volume Block Storage for VPC joint dans les détails de l'instance

Vous pouvez également consulter des informations sur un volume Block Storage for VPC associé depuis la page de détails de l'instance de serveur virtuel:

1. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation > Infrastructure > Compute > Instances de serveurs virtuels et sélectionnez une instance.

2. Sous Volumes de stockage par blocs connectés, cliquez sur le nom d'un volume pour accéder à la page des détails du volume.

Visualisation de tous les volumes à partir de l'interface de gestion

Exécutez la commande suivante pour afficher les informations récapitulatives concernant tous les volumes :

ibmcloud is volumes [--json]

La spécification de l'ID ou du nom du groupe de ressources permet de filtrer la liste en fonction des volumes appartenant à un groupe de ressources. Si vous omettez cet argument, la valeur par défaut correspond à tous les groupes de ressources. Vous pouvez également afficher tous les volumes d'une zone de disponibilité particulière. Par défaut, les 25 premiers volumes sont affichés par page.

L'exemple suivant montre tous les volumes de tous les groupes de ressources de votre zone de disponibilité.

ibmcloud is volumes

Listing volumes in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                                            Status      Capacity   IOPS    Profile           Attachment state   Attachment type   Zone         Resource group   Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-1dad641f-3a17-4117-8bb6-e30e09e64dff   my-2nd-data-volume                              available   9600       48000   5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-f336511e-ece5-4407-9c8e-ef030c94aaa0   my-3rd-data-volume                              available   4800       48000   10iops-tier       unattached         -                 us-south-2   Default          -                          -                       1
r006-45ca6ddd-9942-4dd2-9ae9-d3edcb9fa076   my-data-volume-1                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-6a1ac889-d232-4beb-84dd-93c63cf9a156   my-data-volume-2                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-862ddcd3-59a6-4c69-9a10-275c894195b9   my-new-boot-volume                              available   250        3000    general-purpose   unattached         -                 us-south-2   Default          -                          -                       1
r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05   my-sdp-volume                                   available   250        3000    sdp               attached.          -                 us-south-2   Default          -                          -                       2
r006-693f555e-fec7-4afb-b1e3-a16bf8b0d744   my-virtual-server-instance-boot-1756849222000   available   100        3000    general-purpose   attached           boot              us-south-2   Default          -                          -                       1

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

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

Exécutez la commande suivante pour afficher les détails d'un volume spécifique. Vous pouvez utiliser le nom ou l'ID du volume pour l'identifier.

ibmcloud is volume VOLUME_ID [--json]

Consultez l'exemple suivant.

ibmcloud is volume my-sdp-volume

Getting volume my-sdp-volume  under account under account Test Account as user test.user@ibm.com...
ID                                     r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Name                                   my-sdp-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Status                                 available
Attachment state                       attached
Capacity                               250
IOPS                                   3000
Bandwidth(Mbps)                        1000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-06-23T16:35:10+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                Auto delete   Attachment ID                               Attachment name
                                       data              0726_6cf2d984-e825-458d-8048-11572b72d040   my-virtual-server-instance   false         0717-beec02ac-7edf-4b59-ab9f-7c004bf4d8fa   outpour-perm-cosmic-gander
Active                                 true
Adjustable IOPS                        true
Adjustable Capacity States             unattached,attached
Adjustable IOPS States                 unattached,attached
Busy                                   false
Tags                                   -
Storage Generation                     2

Dans l'exemple, le volume est attaché à une instance de serveur virtuel, de sorte que les noms et les identifiants de l'attachement au volume et de l'instance sont également affichés dans la sortie de la commande. La propriété Active est true car l'instance de serveur virtuel à laquelle le volume est attaché est en cours d'exécution. La propriété Busy avec la valeur false indique que ce volume n'effectue pas une opération qui doit être sérialisée.

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

Propriétés CLI supplémentaires pour les volumes de démarrage

Lorsque vous demandez à voir les détails des volumes de démarrage, quelques propriétés supplémentaires sont renvoyées dans la réponse. Voir l'exemple suivant :

ibmcloud is volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e

Getting volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e under account Test Account as user test.user@ibm.com...
ID                                     r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Name                                   vsi-test-boot-1712686424000
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-04-01T18:18:57+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       boot              0727_a9910bc9-3ea0-40d2-b3de-2b03e752f989   vsi-lvm-test    true          0727-7ff0df1b-ba0b-40c7-ad99-122819342f39   prissy-reason-unselect-overcome
Operating system                       CentOS Stream 9 - Minimal Install (amd64)
Source image                           ID                                          Name
                                       r006-0950e619-325e-446e-b895-e0bdd21dd1ea   ibm-centos-stream-9-amd64-9
Active                                 true
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1
Allowed Use API Version                2025-03-31
Allowed Use Bare Metal Server          true
Allowed Use Instance                   true

Les propriétés d'utilisation autorisée sont héritées de l'image source ou de l'instantané à partir duquel le volume de démarrage parent a été créé. En utilisant la CLI ou l'API, vous pouvez remplacer ces valeurs lorsque vous créez une instance ou lorsque vous mettez à jour le volume de démarrage. Vous devez avoir le rôle IAM is.volume.volume.manage-allowed-use pour effectuer ces mises à jour.

Ces propriétés comprennent une expression booléenne en langage d'expression commune. Lorsque l'expression est évaluée comme étant true, l'instance de serveur virtuel ou le provisionnement du serveur bare metal est autorisé avec le volume de démarrage ou une image qui a été créée à partir du volume de démarrage. Lorsque l'expression est évaluée à false, le provisionnement est bloqué. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Visualisation de tous les volumes avec l'API

Effectuez un appel GET /volumes pour répertorier les informations récapitulatives de tous les volumes. Consultez l'exemple suivant.

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après. Cet exemple montre trois volumes de données. Le deuxième élément de la liste est associé à une instance.

[
  {
    "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": "ok",
    "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": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "env:prod",
        "env:test"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
  },
  {
    "active": false,
    "allowed_use": {
      "api_version": "2025-03-31",
      "instance": "true",
      "bare_metal_server": "false"
    },
    "attachment_state": "attached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2024-04-01T16:48:16.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "iops": 3000,
    "name": "my-vsi--boot-volume-1711989834000",
    "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",
      "resource_type": "operating_system",
      "vendor": "Canonical",
      "version": "20.04 LTS Focal Fossa Minimal Install"
    },
    "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_image": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "name": "ibm-redhat-8-6-minimal-amd64-7",
        "resource_type": "image"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "backup-policy-tag"
    ],
    "volume_attachments": [
        {
            "delete_volume_on_instance_delete": true,
            "device": {
                "id": ""
            },
            "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "instance": {
                "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "name": "my-vsi-test",
                "resource_type": null
            },
            "name": "perfectly-parting-humble-skewer",
            "type": "boot"
        }
    ],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
  },
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 10,
    "created_at": "2021-09-10T15:56:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "iops": 3000,
    "name": "my-other-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"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [],
    "volume_attachments": [],
    "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 relatifs au volume à l'aide de l'API

Effectuez un appel GET /volumes/{id} pour afficher les détails d'un volume. Consultez l'exemple suivant.

curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Une réponse réussie fournit des détails sur le volume, notamment sa capacité et son IOPS, son état, ainsi que l'information indiquant s'il est attaché à une instance.

{
  "active": false,
  "adjustable_capacity_states": ["attached"],
  "adjustable_iops_states": ["attached"],
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  "attachment_state": "attached",
  "bandwidth": 1000,
  "busy": false,
  "capacity": 100,
  "created_at": "2024-10-07T23:16:53.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "iops": 1000,
  "name": "my-volume",
  "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/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "volume",
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": false,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "id": "0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "instance": {
        "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "id": "0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "name": "my-instance",
        "resource_type": "instance"
      },
      "name": "my-volume-attachment",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Propriétés API supplémentaires pour les volumes de démarrage

Lorsque vous demandez à voir les détails des volumes de démarrage, quelques propriétés supplémentaires sont renvoyées dans la réponse pour les demandes GET /volumes et GET /volumes/{id}.

• La propriété active indique si l'instance de serveur virtuel à laquelle un volume est connecté est en cours d'exécution ou arrêtée. Lorsque l'instance est en cours d'exécution active = true, les opérations qui nécessitent une instance en cours d'exécution, telles que la création d'une image à partir du volume de démarrage, fonctionnent également.

• La propriété busy indique si ce volume effectue une opération qui doit être sérialisée. Si une opération nécessite une sérialisation, celle-ci échoue à moins que cette propriété ne soit false.

• Les expressions d'utilisation autorisée sont héritées de l'image source ou de l'instantané à partir duquel le volume de démarrage parent a été créé. Vous pouvez mettre à jour les expressions d'utilisation autorisée uniquement sur les volumes de démarrage détachés. À l'aide de la CLI ou de l'API, vous pouvez remplacer ces valeurs lorsque vous créez une instance ou en mettant à jour le volume de démarrage. Vous devez avoir le rôle IAM is.volume.volume.manage-allowed-use pour effectuer ces mises à jour. Ces propriétés comprennent une expression booléenne en langage d'expression commune. Lorsque l'expression est évaluée comme étant true, l'instance de serveur virtuel ou le provisionnement du serveur bare metal est autorisé avec le volume de démarrage ou une image qui a été créée à partir du volume de démarrage. Lorsque l'expression est évaluée à false, le provisionnement est bloqué. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Consultez l'exemple suivant.

  "active": "true",
  "busy": "false",
  "capacity": 100,
  "created_at": "2022-12-08T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 300,
  "name": "boot-volume-1",
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  .
  .
  .

Afficher tous les volumes avec Terraform

Importer la liste des volumes appartenant à un compte en tant que source de données en lecture seule. Vous pouvez filtrer par nom de volume, nom de zone, état d'attachement, type de cryptage, famille de système d'exploitation (applicable aux volumes d'amorçage) ou architecture de système d'exploitation (applicable aux volumes d'amorçage).

data "ibm_is_volumes" "example" {
}

Les attributs exportés comprennent le nombre total de volumes et la liste des volumes. Les attributs imbriqués comprennent l'ID du volume, le nom, la date de création, la taille, l'IOPS, le CRN, les étiquettes d'accès et d'utilisateur, le profil, le type et la clé de chiffrement, l'état du cycle de vie, l'état de santé et la raison, le système d'exploitation et d'autres attributs.

Pour plus d'informations, voir ibm_is_volumes.

Afficher les détails d'un volume avec Terraform

Importer les détails d'un volume en tant que source de données en lecture seule. Vous devez identifier le volume par son nom ou son numéro d'identification.

data "ibm_is_volume" "example1" {
  name = ibm_is_volume.example.name
}

Les attributs exportés comprennent le nombre total de volumes et la liste des volumes. Les attributs imbriqués comprennent l'ID du volume, le nom, la date de création, la taille, l'IOPS, le CRN, les étiquettes d'accès et d'utilisateur, le profil, le type et la clé de chiffrement, l'état du cycle de vie, l'état de santé et la raison, le système d'exploitation et d'autres attributs.

Pour plus d'informations, voir ibm_is_volume.

Propriétés Terraform supplémentaires pour les volumes de démarrage

Les expressions d'utilisation autorisée sont héritées de l'image source ou de l'instantané à partir duquel le volume de démarrage parent a été créé. Vous pouvez mettre à jour les expressions d'utilisation autorisée uniquement sur les volumes de démarrage détachés. Avec Terraform, vous pouvez remplacer ces valeurs lorsque vous créez une instance ou en mettant à jour le volume de démarrage. Vous devez avoir le rôle IAM is.volume.volume.manage-allowed-use pour effectuer ces mises à jour. Ces propriétés comprennent une expression booléenne en langage d'expression commune. Lorsque l'expression est évaluée comme étant true, l'instance de serveur virtuel ou le provisionnement du serveur bare metal est autorisé avec le volume de démarrage ou une image qui a été créée à partir du volume de démarrage. Lorsque l'expression est évaluée à false, le provisionnement est bloqué. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.