Création de volumes Block Storage for VPC
Créez des volumes de stockage en bloc d IBM Cloud s lors de la mise en place d'une instance, en tant que volumes autonomes ou en effectuant une restauration à partir de snapshots. Configurer la capacité, les IOPS et le chiffrement.
Avant de commencer, vérifiez que vous avez créé un VPC. Lorsque vous créez un volume à partir d'un instantané, vous pouvez utiliser un instantané de votre propre compte ou d'un autre compte. Si vous prévoyez d'utiliser un instantané d'un autre compte, assurez-vous que les bons Autorisations IAM sont en place.
Les Hyper Protect Crypto Services sont obsolètes. Les clients peuvent utiliser les instances existantes jusqu'au 20 mars 2027. Pour plus d'informations, consultez la section Abandon de la fonctionnalité IBM Cloud Hyper Protect Crypto Services. Pour une protection continue, envisagez de migrer vos clés de chiffrement existantes vers une instance dédiée d' Key Protect. Pour plus d'informations, consultez le guide de migration.
CréationBlock Storage for VPC volumes dans la console
Utilisez la console d' IBM Cloud s pour créer un volume Block Storage for VPC lors de la création d'une instance de serveur virtuel ou en tant que volume autonome.
Création et connexion d'un volume Block Storage for VPC lorsque vous créez une instance
- Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation
> Infrastructure
> Compute > Instances de serveurs virtuels.
- Dans la liste des instances de serveur virtuel, cliquez sur Créer.
- Dans la page de mise à disposition du serveur virtuel pour VPC, sélectionnez le type de serveur, l'emplacement, le système d'exploitation, le profil, le groupe de placement, etc. Pour plus d'informations sur la mise à disposition de l'instance, voir Création d'une instance de serveur virtuel à l'aide de l'interface utilisateur.
- Les détails du volume d'amorçage à créer sont affichés sur la page. Vous pouvez modifier le volume de démarrage en cliquant sur l'icône
de modifier sa capacité, de définir un chiffrement et d'ajouter des balises utilisateur pour identifier cette ressource. Vous pouvez modifier le profil pour ou
sdpgeneral-purpose. - Pour créer un volume de données et l'attacher à l'instance, dans le Volumes de données section de la page de provisionnement de l'instance, cliquez sur Créer. Dans le panneau latéral, précisez les détails
relatifs au volume.
- Vous pouvez créer un volume de données vierge ou un volume contenant des données importées à partir d'un instantané. Si vous choisissez Importer un instantané existant, sélectionnez un instantané disponible dans la liste. Si vous choisissez d' importer un instantané par CRN, préparez le CRN de l'instantané pour qu'il soit prêt à être saisi.
- Attribuez un nom unique et significatif à votre volume. Il peut s'agir, par exemple, d'un nom décrivant votre fonction de calcul ou de charge de travail. Le nom du volume doit commencer par une lettre minuscule. Le nom peut comporter jusqu'à 63 caractères alphanumériques minuscules et inclure le trait d'union (-). Les noms de volume doivent être uniques pour votre VPC. Vous pouvez modifier ce nom ultérieurement si vous le souhaitez.
- La fonctionnalité de suppression automatique est désactivée par défaut. Si vous souhaitez que le volume soit supprimé lorsque l'instance de serveur virtuel attachée est supprimée, cliquez sur le bouton pour activer la fonctionnalité.
- Le groupe de ressources et l'emplacement sont hérités de l'instance. Ces valeurs ne peuvent pas être modifiées.
- Vous pouvez spécifier des balises utilisateur facultatives à associer à ce volume. Pour plus d'informations sur l'organisation des ressources avec des balises utilisateur, voir Utilisation des balises.
- Dans la section Chiffrement, le chiffrement géré par le fournisseur est activé par défaut. Pour utiliser votre propre clé de chiffrement, cliquez sur le
bouton pour activer le chiffrement géré par le client. Si vous disposez déjà d'une instance KMS et d'une clé racine, le système les sélectionne automatiquement pour vous. Vous pouvez cliquer sur l 'icône Modifier
pour passer à une autre clé ou instance. Pour localiser votre clé de cryptage, sélectionnez l'une des options suivantes :
- Recherche par instance: le panneau comporte trois étapes :
- Sélectionner une instance KMS: la liste affiche le nom, l'ID, le type (Standard ou Dédié) et l'emplacement de chaque instance disponible d' Key Protect. Sélectionnez une instance, puis cliquez sur Sélectionner. Si vous ne disposez pas encore d'une instance, cliquez sur Créer pour en provisionner une.
- Clé associée: la liste indique le nom, l'ID, la date de dernière mise à jour, les alias et le trousseau de clés de chaque clé racine disponible. Sélectionnez une clé, puis cliquez sur Sélectionner. Si vous ne disposez pas encore d'une clé, cliquez sur Créer une nouvelle clé.
- Vérification: confirmez vos choix, notamment le service de gestion des clés, le type d'instance, le nom de l'instance et le nom de la clé. La section Autorisation du service indique si l'autorisation requise entre Block Storage for VPC et l'instance KMS est déjà en place. Si ce n'est pas le cas, vous pouvez laisser Key Protect créer automatiquement l'autorisation, ou en créer une manuellement. Pour plus d'informations, consultez la section Mise en place d'autorisations de service à service pour l' Block Storage for VPC. Cliquez sur Confirmer pour valider votre sélection et revenir à la configuration du volume.
- Localiser par CRN: Saisissez le CRN de la clé racine du client à utiliser pour chiffrer le volume. Sélectionnez cette option si vous utilisez le CRK d'un autre compte. Cliquez sur Sélectionner pour passer à l'étape Vérification décrite dans l'option Rechercher par instance.
- Recherche par instance: le panneau comporte trois étapes :
- Sélectionnez le profil de stockage. Si vous choisissez d'importer des données à partir d'un instantané, la valeur de génération de stockage de l'instantané doit correspondre à la valeur de génération de stockage du profil de volume sélectionné.
- Vous pouvez sélectionner le profil
sdplorsque vous souhaitez spécifier une capacité de stockage allant jusqu'à 32 000 Go, avec des limites d'IOPS et de débit personnalisées. - Lorsque vous souhaitez utiliser un volume de première génération avec des niveaux d'IOPS prédéfinis, vous pouvez sélectionner l'un des profils à niveaux. Lorsque vous sélectionnez polyvalent, 5iops-tier ou 10iops-tier il suffit de spécifier la capacité du volume.
- Lorsque les exigences de performance de votre application ne correspondent à aucun des niveaux d'IOPS, vous pouvez choisir le profil personnalisé. Spécifiez la taille de votre volume et les IOPS dans la plage appropriée à la capacité du volume. La taille du volume peut varier entre 10 et 16 000 Go. A mesure que vous entrez la valeur d'IOPS, l'interface utilisateur affiche la plage acceptable. Vous pouvez également cliquer sur le lien de la taille du stockage pour voir les plages de taille et d'IOPS du profil de volume personnalisé.
- Vous pouvez sélectionner le profil
- Vous pouvez appliquer une politique de sauvegarde lors de la création du volume. Cliquez sur Appliquer, puis sélectionnez une politique existante dans la liste déroulante du panneau latéral. Sélectionnez les balises à appliquer à la cible et cliquez sur Appliquer la politique et les balises.
- Cliquez sur Sauvegarder.
- Vous revenez à la page de provisionnement de l'instance virtuelle pour terminer la définition des attributs restants de votre instance de serveur virtuel.
- Lorsque vous êtes satisfait de vos choix, cliquez sur Créer un serveur virtuel.
Un volume Block Storage for VPC ne peut être associé qu'à un seul serveur virtuel à la fois. Sur la page de résumé du volume Block Storage for VPC, vous pouvez consulter les détails relatifs à l’instance de serveur virtuel en sélectionnant le nom de l’instance sous Instances associées.
Création et association d'un volume Block Storage for VPC à partir d'une instance existante
Vous pouvez créer un volume Block Storage for VPC à partir d'une instance existante.
- Accéder à la liste des instances de serveurs virtuels. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation
> Infrastructure
> Compute > Instances de serveurs virtuels.
- Sélectionnez une instance dans la liste.
- Sur la page des détails de l'instance, cliquez sur l'onglet Stockage.
- Dans la liste des volumes de stockage attachés, cliquez sur Attacher.
- Dans le panneau latéral, cliquez sur la flèche vers le bas sous Volumes de blocs et sélectionnez Créer un volume de données. Le panneau latéral se développe avec des zones pour définir le volume.
- Si vous avez créé des instantanés de volume précédemment, l'option permettant d'en importer un devient disponible. Cliquez sur la bascule pour Importer à partir d'un instantané, et sélectionnez un instantané dans la liste ou localisez l'instantané par son CRN.
- Attribuez un nom unique et significatif à votre volume. Il peut s'agir, par exemple, d'un nom décrivant votre fonction de calcul ou de charge de travail. Le nom du volume doit commencer par une lettre minuscule. Le nom peut comporter jusqu'à 63 caractères alphanumériques minuscules et inclure le trait d'union (-). Les noms de volume doivent être uniques pour votre VPC. Vous pouvez modifier ce nom ultérieurement si vous le souhaitez.
- La fonctionnalité de suppression automatique est désactivée par défaut. Si vous souhaitez que le volume soit supprimé lorsque l'instance de serveur virtuel attachée est supprimée, cliquez sur le bouton pour activer la fonctionnalité.
- Le groupe de ressources et l'emplacement sont hérités de l'instance. Ces valeurs ne peuvent pas être modifiées.
- Vous pouvez spécifier des balises utilisateur facultatives à associer à ce volume. Pour plus d'informations sur l'organisation des ressources avec des balises utilisateur, voir Utilisation des balises.
- Dans la section Chiffrement, le chiffrement géré par le fournisseur est activé par défaut. Pour utiliser votre propre clé de chiffrement, cliquez sur le
bouton pour activer le chiffrement géré par le client. Si vous disposez déjà d'une instance KMS et d'une clé racine, le système les sélectionne automatiquement pour vous. Vous pouvez cliquer sur l 'icône Modifier
pour passer à une autre clé ou instance. Pour localiser votre clé de cryptage, sélectionnez l'une des options suivantes :
- Recherche par instance: le panneau comporte trois étapes :
- Sélectionner une instance KMS: la liste affiche le nom, l'ID, le type (Standard ou Dédié) et l'emplacement de chaque instance disponible d' Key Protect. Sélectionnez une instance, puis cliquez sur Sélectionner. Si vous ne disposez pas encore d'une instance, cliquez sur Créer pour en provisionner une.
- Clé associée: la liste indique le nom, l'ID, la date de dernière mise à jour, les alias et le trousseau de clés de chaque clé racine disponible. Sélectionnez une clé, puis cliquez sur Sélectionner. Si vous ne disposez pas encore d'une clé, cliquez sur Créer une nouvelle clé.
- Vérification: confirmez vos choix, notamment le service de gestion des clés, le type d'instance, le nom de l'instance et le nom de la clé. La section Autorisation du service indique si l'autorisation requise entre Block Storage for VPC et l'instance KMS est déjà en place. Si ce n'est pas le cas, vous pouvez laisser Key Protect créer automatiquement l'autorisation, ou en créer une manuellement. Pour plus d'informations, consultez la section Mise en place d'autorisations de service à service pour l' Block Storage for VPC. Cliquez sur Confirmer pour valider votre sélection et revenir à la configuration du volume.
- Localiser par CRN: Saisissez le CRN de la clé racine du client à utiliser pour chiffrer le volume. Sélectionnez cette option si vous utilisez le CRK d'un autre compte. Cliquez sur Sélectionner pour passer à l'étape Vérification décrite dans l'option Rechercher par instance.
- Recherche par instance: le panneau comporte trois étapes :
- Cliquez sur Suivant.
- Sélectionnez le profil de stockage. Si vous choisissez d'importer des données à partir d'un instantané, la valeur de génération de stockage de l'instantané doit correspondre à la valeur de génération de stockage du profil de volume sélectionné.
- Vous pouvez sélectionner le profil
sdp. Spécifiez ensuite la capacité de votre volume, la limite de bande passante requise et le nombre d'IOPS requis. La taille du volume peut varier de 1 à 32 000 Go. Vous pouvez spécifier un nombre d'IOPS compris entre 100 et 64 000. La limite de débit est comprise entre 1000 et 8192 Mbps. - Vous pouvez sélectionner l'un des profils à plusieurs niveaux. Après avoir sélectionné general-purpose, 5iops-tier ou 10iops-tier l'étape suivante consiste à spécifier la capacité du volume. La taille du volume peut varier entre 10 et 16 000 Go.
- Vous pouvez sélectionner le profil personnalisé si les exigences de performance de votre application ne correspondent à aucun des niveaux d'IOPS. Ensuite, indiquez la taille de votre volume et le nombre d'IOPS dans la plage appropriée à la capacité du volume. La taille du volume peut varier entre 10 et 16 000 Go. A mesure que vous entrez la valeur d'IOPS, l'interface utilisateur affiche la plage acceptable. Vous pouvez également cliquer sur le lien de la taille du stockage pour voir les plages de taille et d'IOPS du profil de volume personnalisé.
- Vous pouvez sélectionner le profil
- Cliquez sur Sauvegarder.
- Lorsque vous avez terminé de définir le volume, cliquez sur Sauvegarder. Le volume est créé et associé à l'instance. Vous revenez à la page des détails de l'instance. Le nouveau volume apparaît dans la liste des volumes de stockage.
Création d'un volume Block Storage for VPC autonome
Vous pouvez créer un volume Block Storage for VPC indépendamment de la mise en place d'un serveur virtuel, puis l'associer à une instance ultérieurement.
-
Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation
> Infrastructure
> Stockage > Block Storage volumes.
-
Cliquez sur Créer.
-
Sur leBlock Storage for VPC page de provisionnement, consultez la Emplacement information. La géographie, la région et la zone sont héritées du VPC (par exemple, Amérique du Nord, Dallas,Dallas-1 ). Vous pouvez sélectionner une zone différente dans votre emplacement dans le menu en cliquant sur le bouton Icône Modifier
.
-
Dans le Détails, vous devez spécifier le nom du volume et le groupe de ressources auquel le volume doit être ajouté. Vous pouvez éventuellement ajouter des balises de gestion des utilisateurs et des accès.
-
Indiquez un nom explicite pour votre volume. Par exemple, indiquez un nom décrivant la fonction de calcul ou de charge de travail.
Le nom du volume doit commencer par une lettre minuscule. Le nom du volume peut contenir jusqu'à 63 caractères alphanumériques minuscules et inclure le trait d'union (-). Les noms de volumes doivent être uniques dans l'ensemble de l'infrastructure VPC. Vous pourrez modifier ce nom ultérieurement.
-
Spécifiez un groupe de ressources.
-
Spécifiez des balises utilisateur pour organiser vos ressources et les utiliser par des règles de sauvegarde.
-
Spécifiez les balises de gestion des accès qui ont été créées dans IAM pour vous aider à gérer l'accès à vos volumes.
-
-
Dans le Configurations facultatives, vous pouvez spécifier si vous souhaitez créer le volume avec les données d'un instantané. Pour plus d'informations, voir Créer un autonomeBlock Storage for VPC volume à partir d'un instantané. Vous pouvez également choisir d'appliquer une politique de sauvegarde. Cliquez sur Appliquer pour afficher les politiques et les forfaits disponibles.
-
Dans la section Profil, vous pouvez spécifier le profil de performance de votre volume, ses limites de performance et sa capacité. Si vous avez choisi d'importer des données à partir d'un instantané, la valeur de génération de stockage de l'instantané doit correspondre à la valeur de génération de stockage du profil de volume sélectionné.
- Vous pouvez sélectionner le profil
sdp. Spécifiez ensuite la capacité de votre volume, la limite de débit demandée et le nombre d'IOPS requis. La taille du volume peut varier de 1 à 32 000 Go. Vous pouvez spécifier un nombre d'IOPS compris entre 100 et 64 000. La limite de débit est comprise entre 1000 et 8192 Mbps. - Vous pouvez sélectionner l'un des profils à plusieurs niveaux. Après avoir sélectionné general-purpose, 5iops-tier ou 10iops-tier l'étape suivante consiste à spécifier la capacité du volume. La taille du volume peut varier entre 10 et 16 000 Go.
- Vous pouvez sélectionner le profil personnalisé si les exigences de performance de votre application ne correspondent à aucun des niveaux d'IOPS. Ensuite, indiquez la taille de votre volume et le nombre d'IOPS dans la plage appropriée à la capacité du volume. A mesure que vous entrez la valeur d'IOPS, l'interface utilisateur affiche la plage acceptable. Vous pouvez également cliquer sur le lien de la taille du stockage pour voir les plages de taille et d'IOPS du profil de volume personnalisé.
- Vous pouvez sélectionner le profil
-
Dans la section Chiffrement au repos, vous pouvez choisir de conserver le chiffrement à l'aide de clés gérées par l' IBM, qui est activé par défaut sur tous les volumes. Vous pouvez également choisir d'utiliser votre propre clé de chiffrement. Pour modifier la clé ou l'instance, cliquez sur l'icône Modifier
afin d'ouvrir le panneau latéral Configurer le chiffrement. Sélectionnez l'une des options suivantes pour localiser votre clé de chiffrement :
- Recherche par instance: le panneau comporte trois étapes :
- Sélectionner une instance KMS: la liste affiche le nom, l'ID, le type (Standard ou Dédié) et l'emplacement de chaque instance disponible d' Key Protect. Sélectionnez une instance, puis cliquez sur Sélectionner. Si vous ne disposez pas encore d'une instance, cliquez sur Créer pour en provisionner une.
- Clé associée: la liste indique le nom, l'ID, la date de dernière mise à jour, les alias et le trousseau de clés de chaque clé racine disponible. Sélectionnez une clé, puis cliquez sur Sélectionner. Si vous ne disposez pas encore d'une clé, cliquez sur Créer une nouvelle clé.
- Vérification: confirmez vos choix, notamment le service de gestion des clés, le type d'instance, le nom de l'instance et le nom de la clé. La section Autorisation du service indique si l'autorisation requise entre Block Storage for VPC et l'instance KMS est déjà en place. Si ce n'est pas le cas, vous pouvez laisser Key Protect créer automatiquement l'autorisation, ou en créer une manuellement. Pour plus d'informations, consultez la section Mise en place d'autorisations de service à service pour l' Block Storage for VPC. Cliquez sur Confirmer pour valider votre sélection et revenir à la page de provisionnement des volumes.
- Localiser par CRN: Saisissez le CRN de la clé racine du client à utiliser pour chiffrer le volume. Sélectionnez cette option si vous utilisez le CRK d'un autre compte. Cliquez sur Sélectionner pour passer à l'étape Vérification décrite dans l'option Rechercher par instance.
Si vous avez sélectionné un instantané de deuxième génération pour créer le volume, le type de chiffrement de votre volume doit correspondre au type de chiffrement de l'instantané. Si l'instantané possède des clés gérées par le fournisseur, ne spécifiez pas de clé provenant d'un service de gestion de clés.
- Recherche par instance: le panneau comporte trois étapes :
-
Lorsque vous avez terminé, cliquez sur Créer un volume de stockage en bloc.
- Si vous n'êtes pas encore prêt à commander ou si vous cherchez simplement des informations de tarification, vous pouvez ajouter les informations que vous voyez dans le panneau latéral à une estimation. Pour plus d'informations sur le fonctionnement de cette fonctionnalité, voir Estimation de vos coûts.
-
Vous êtes redirigé vers la page des volumes d' Block Storage for VPC, où un message indique que le volume est en cours de création (le statut du volume est en attente ). Un deuxième message s'affiche lorsque le volume est créé (le statut du volume est disponible ).
-
Pour afficher les détails du nouveau volume, sélectionnez le lien Afficher la ressource dans le second message pour accéder à la page Détails du volume.
Lorsque vous actualisez la liste des volumes d' Block Storage s dans la console, le nouveau volume apparaît en tête de la liste des volumes. Pour les volumes autonomes, la colonne Type de pièce jointe est vide (-). Actions du menu Actions, située à la fin d'une ligne du tableau, fournit un lien permettant d'associer un volume Block Storage à une instance.
Créer un autonomeBlock Storage for VPC volume à partir d'un instantané dans la console
Lorsque vous créez un volume Block Storage for VPC, vous pouvez sélectionner un instantané et utiliser ses données pour créer le nouveau volume. Les images instantanées qui sont présentées sont dans un état stable. Le volume de données créé à partir de l'instantané n'est pas connecté à une instance et apparaît dans la liste des volumes Block Storage for VPC. Vous pourrez ensuite associer le volume à une instance.
Vous pouvez restaurer un volume d'amorçage à partir d'une image instantanée "amorçable". Le volume d'amorçage est restauré lorsque vous créez une instance de serveur virtuel.
- Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation
> Infrastructure
> Stockage > Block Storage volumes.
- Sélectionnez Créer.
- Spécifiez l'emplacement du volume, le nom du volume, le groupe de ressources optionnel et les balises.
- Dans le Configurations facultatives section, cliquez sur Importer à partir d'un instantané. Sélectionnez l'une des options suivantes
- Cliquez sur Importer un instantané existant pour afficher la liste des instantanés disponibles. Tous les instantanés présentés sont dans un état stable. Par défaut, l'onglet Non amorçable est sélectionné et répertorie tous les instantanés de volumes de données. Pour restaurer un volume de démarrage, cliquez sur l'onglet Bootable. Attacher un volume à une nouvelle instance de serveur virtuel est sélectionné par défaut. Le volume d'amorçage est restauré lorsque l'instance est créée.
- Cliquez sur Importer un instantané par CRN et indiquez le CRN de l'instantané que vous souhaitez utiliser.
- Cliquez sur Sauvegarder. Des informations sur l'instantané sont affichées sur la page de mise à disposition du volume, y compris le nom, sa taille, la date de création, son volume source et s'il s'agit d'un instantané amorçable. Les informations d'image instantanée amorçable incluent le système d'exploitation et l'image. Le chiffrement est hérité de l'instantané et affiché dans la section de chiffrement.
- Cliquez sur Créer un volume de stockage en bloc.
Les profils de volume de première et de deuxième génération ne sont pas interchangeables. Vous pouvez utiliser un instantané d'un volume de deuxième génération pour créer un autre volume de deuxième génération, mais vous ne pouvez pas remplacer
le profil de volume par un profil de volume de première génération. De la même manière, vous pouvez utiliser un instantané d'un volume de première génération pour créer un autre volume de première génération avec les mêmes données, mais
vous ne pouvez pas basculer le nouveau volume sur le profil sdp.
Lorsque vous actualisez la page des volumes d' Block Storage for VPC, le nouveau volume apparaît en tête de la liste des volumes. Si le volume a été créé avec succès, il affiche le statut Disponible. Pour les volumes autonomes, la colonne
Type de pièce jointe est vide (-). Le menu Actions à la fin d'une ligne de tableau fournit un lien permettant d' associer un volume Block Storage for VPC à une instance.
Création de volumes Block Storage for VPC à partir de l'interface de ligne de commande
Vous pouvez créer des volumes Block Storage for VPC à l'aide de l'interface CLI (CLI).
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.
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.ibmcloud login --sso -a cloud.ibm.com
Création d'un volume Block Storage for VPC à partir de l'interface de ligne de commande
Exécutez la commande suivante pour créer un volume Block Storage for VPC. Indiquez un nom de volume, un nom de profil et le nom de la zone de disponibilité de votre région. Pour plus d'informations sur les profils Block Storage for VPC, voir Profils. Les options supplémentaires sont affichées entre crochets.
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 est générée.
ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags TAG_NAME1,TAG_NAME2,...] [--json]
Consultez l'exemple suivant.
ibmcloud is volume-create demovolume1 custom us-east-1 --capacity 500 --iops 3000 --tags env:test,env:prod
Creating volume demovolume1 in resource group Default under account Test Account as user test.user@ibm.com...
ID r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Name demovolume1
CRN crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Status pending
Attachment state unattached
Capacity 500
IOPS 3000
Bandwidth(Mbps) 6291
Profile custom
Encryption key -
Encryption provider_managed
Resource group defaults
Created 2023-07-24T16:20:52+00:00
Zone us-east-1
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Busy false
Tags env:test,env:prod
Storage Generation 1
La capacité, exprimée en mégaoctets, peut varier entre 10 et 16 000 Go. Si elle n'est pas spécifiée, la capacité par défaut est de 100 Go. Les valeurs IOPS peuvent être de 100 à 48 000 IOPS, en fonction du profil et de la taille du volume. Si elle n'est pas spécifiée, la valeur IOPS prend par défaut la configuration valide par profil de volume. Pour plus d'informations, voir le tableau IOPS personnalisées.
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 sur l'ensemble de l'infrastructure VPC.
Notez l'ID volume. Vous devez spécifier l'ID lorsque vous associez Block Storage for VPC à une instance de serveur virtuel, que vous consultez Block Storage for VPC les détails d'un volume ou que vous supprimez des volumes.
L'état de santé du volume indique inapplicable alors que l'état du volume est pending. Une fois le volume créé, l'état de santé indique OK, sauf si la création a échoué. Pour plus d'informations, voir
Block Storage for VPC état de santé du volume.
Des étiquettes utilisateur sont ajoutées pour identifier la ressource de volume. Lorsque ces étiquettes sont associées aux étiquettes d'une stratégie de sauvegarde, le volume est sauvegardé en fonction de la planification figurant dans le plan de sauvegarde. Pour plus d'informations, voir Création d'une stratégie de sauvegarde.
Pour créer un volume autonome, exécutez la commande ibmcloud is volume-create et spécifiez le profil sdp, la taille et les exigences de performance du volume. L'exemple suivant crée un volume de données dans la région
us-east avec une capacité de 200 Mo et 100 IOPS.
ibmcloud is volume-create defined-performance-vol sdp us-east-3 --capacity 200 --iops 3000 --bandwidth 2000
Creating volume defined-performance-vol under account Test Account as user test.user@ibm.com...
ID r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Name defined-performance-vol
CRN crn:v1:bluemix:public:is:us-east-3:a/a1234567::volume:r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Status pending
Attachment state unattached
Capacity 200
IOPS 3000
Bandwidth(Mbps) 2000
Profile sdp
Encryption key -
Encryption provider_managed
Resource group Default
Created 2025-03-25T09:59:26+05:30
Zone us-east-3
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Adjustable IOPS true
Busy false
Tags -
Storage Generation 2
Création d'un volume Block Storage for VPC autonome avec chiffrement géré par le client à partir de l'interface de ligne de commande
Pour créer un volume Block Storage avec chiffrement géré par le client à partir de l'interface de ligne de commande (CLI), utilisez la commande ibmcloud is volume-create avec l'option --encryption-key. L'option encryption_key nécessite un CRN valide pour la clé racine dans le service de gestion des clés.
ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--encryption-key ENCRYPTION_KEY] [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON]
L'exemple suivant illustre un volume avec des E-S/s personnalisées et une capacité créée avec un chiffrement géré par le client.
ibmcloud is volume-create demo-cli-volume custom us-east-1 --capacity 300 --iops 1500 --encryption-key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Creating volume demo-cli-volume under account Test Account as user test.user@ibm.com...
ID r014-3984600c-6f4d-4940-82de-519a867fa3c0
Name demo-cli-volume
CRN crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-3984600c-6f4d-4940-82de-519a867fa3c0
Status pending
Attachment state unattached
Capacity 300
IOPS 1500
Bandwidth(Mbps) 3145
Profile custom
Encryption key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Encryption user_managed
Resource group defaults
Created 2023-06-29T20:10:52+00:00
Zone us-east-1
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Busy false
Tags -
Storage Generation 1
Création d'un volume Block Storage for VPC autonome à partir d'un instantané de l'interface de ligne de commande
Exécutez la commande " ibmcloud is volume-create et spécifiez l'option " --snapshot avec le nom, l'ID ou le CRN de l'instantané que vous utilisez pour créer le nouveau volume. Le volume est déconnecté, comme
indiqué par l'état de connexion dans la réponse.
Cet exemple crée le nouveau volume à partir d'un instantané spécifié par son nom.
ibmcloud is volume-create volume-4 general-purpose us-south-1 --snapshot r006-4602b3de-3885-4b49-8d46-65aacb72a1d6
Creating volume volume-4 under account Test Account as user test.user@ibm.com...
ID r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name volume-4
CRN crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status pending
Attachment state unattached
Capacity 100
IOPS 3000
Bandwidth(Mbps) 393
Profile general-purpose
Encryption key -
Encryption provider_managed
Resource group defaults
Created 2023-06-29T16:14:59+00:00
Zone us-east-1
Health State inapplicable
Volume Attachment Instance Reference -
Active false
Busy false
Tags -
Storage Generation 1
Pour plus d'informations, voir ibmcloud is volume-create dans la référence de l'interface de ligne de commande.
Les profils de volume de première et de deuxième génération ne sont pas interchangeables. Vous pouvez utiliser un instantané d'un volume de deuxième génération pour créer un autre volume de deuxième génération, mais vous ne pouvez pas remplacer
le profil de volume par un profil de volume de première génération. De la même manière, vous pouvez utiliser un instantané d'un volume de première génération pour créer un autre volume de première génération avec les mêmes données, mais
vous ne pouvez pas basculer le nouveau volume sur le profil sdp.
Création d'un volume de données en tant que connexion à une instance de serveur virtuel existante
Vous pouvez utiliser la commande instance-volume-attachment-add pour créer un volume et le connecter à une instance. L'exemple suivant crée un volume avec le profil custom, une capacité de 100 Go et 100 IOPS.
ibmcloud is instance-volume-attachment-add acd-vol-attach1 my-instance-1 --profile custom --new-volume-name acd-vol-2 --iops 100 --capacity 100
Creating volume attachment acd-vol-attach1 for instance my-instance-1 under account Test Account as user test.user@ibm.com...
ID 730f-5f63eb4d-2683-4dd6-a20a-5ab06b4061c6
Name acd-vol-attach1
Volume -
Status attaching
Bandwidth(Mbps) 14
Type data
Device -
Auto delete false
Created 2023-05-05T07:42:33+05:30
Pour plus d'informations, voir ibmcloud is instance-volume-attachment-add dans la référence de l'interface de ligne de commande.
Création d'une instance avec des volumes sdp à partir du CLI
Pour créer une instance de serveur virtuel, exécutez la commande ibmcloud is instance-create et indiquez les détails de votre instance ainsi que les détails des volumes que vous souhaitez attacher. L'exemple suivant crée une instance
de serveur virtuel avec un volume de démarrage sdp et attache également un volume de données sdp.
ibmcloud is instance-create my-defined-performance-instance test-vpc us-east-3 bx2-2x8 csi-subnet-cidr-3b6k-storage-v5lvug8w-380sal --boot-volume '{"name": "boot-vol-attachment-name-instance-1", "volume": {"name": "boot-vol-name-1", "profile": {"name": "sdp"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach '[{"volume": {"capacity": 1000,"iops": 32000,"bandwidth": 3000,"name": "my-data-volume-1","profile": {"name": "sdp"}}}]' --image r006-5f183c60-78a0-4d6e-9be5-84335939255a
Creating instance my-defined-performance instance under account Test Account as user test.user@ibm.com...
ID 730f_59883a41-c943-423c-a6ab-e2b066f2f314
Name my-defined-performance-instance
CRN crn:v1:bluemix:public:is:us-east-3:a/a1234567::instance:730f_59883a41-c943-423c-a6ab-e2b066f2f314
Status pending
Availability policy on host failure restart
Startable true
Profile bx2-2x8
Architecture amd64
vCPU Manufacturer intel
vCPUs 2
Memory(GiB) 8
Bandwidth(Mbps) 4000
Volume bandwidth(Mbps) 1000
Network bandwidth(Mbps) 3000
Lifecycle Reasons Code Message
- -
Lifecycle State pending
Metadata service Enabled Protocol Response hop limit
false http 1
Image ID Name
r006-5f183c60-78a0-4d6e-9be5-84335939255a embolism-lapped-overjoyed-bagel-elated
VPC ID Name
r006-be9d04ab-d10c-4be7-9de6-95cd2208d1de test-vpc-do-not-delete-default
Zone us-east-3
Resource group ID Name
85cbbee12af748eabb6513cf311d4e2d Default
Created 2024-09-24T02:01:10+05:30
Boot volume ID Name Attachment ID Attachment name
- - 730f-e4d7ce78-011e-4dd1-8752-3ceb12bce79f boot-vol-attachment-name-instance-1
Data volumes ID Name Attachment ID Attachment name
- - 730f-78f2db0a-57df-4b5f-9f1e-f800e91e89af upscale-embargo-oops-overeager
Pour plus d'informations, voir ibmcloud is instance-create dans la référence CLI.
Création d'une instance et ajout de balises utilisateur à des volumes à partir de l'interface de ligne de commande
Vous pouvez spécifier des balises utilisateur pour les volumes d'amorçage et de données lorsque vous créez une instance de serveur virtuel. Exécutez la commande instance-create et spécifiez les balises utilisateur dans l'option
user_tags. Vous pouvez également éditer les balises ultérieurement ou ajouter d'autres balises au volume spécifié. Pour plus d'informations, consultez la référence de l'interface CLI VPC.
Dans l'exemple de commande,
- Le volume d'amorçage est défini par l'option
--boot-volumequi spécifie les balises utilisateurenv:test4etenv:dev4. - La connexion de volume de données est définie par l'option
--volume-attachet spécifie les mêmes balises utilisateur.
Vous pouvez voir les balises utilisateur lorsque vous examinez les détails du volume d'amorçage ou de données après la création de l'instance.
ibmcloud is instance-create my-vsi-4 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-4", "volume": {"name": "my-boot-vol-4", "profile": {"name": "general-purpose"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach '[{"name": "my-vol-att1", "volume": {"name":"my-vol-4", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test4", "env:dev4"]}}]'
Creating instance my-vsi-4 under account vpcdemo1 as user myuser@mycompany.com...
ID efd06503-f514-4ea2-ba6c-2b9c715e6269
Name my-vsi-4
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:efd06503-f514-4ea2-ba6c-2b9c715e6269
Status pending
Availability policy on host failure restart
Startable true
Profile bx2-2x8
Architecture amd64
vCPUs 2
Memory(GiB) 8
Bandwidth(Mbps) 4000
Volume bandwidth(Mbps) 1000
Network bandwidth(Mbps) 3000
Metadata service Enabled
false
Image ID Name
r006-c5471ef3-15f5-4468-964b-f9b4d3ca8120 ibm-centos-7-9-minimal-amd64-6
VPC ID Name
r006-dd1c6831-cc4d-4c40-aab2-6b0c17f41424 my-vpc-2
Zone us-south-1
Resource group ID Name
bdd96715c2a44f2bb60df4ff14a543f5 Default
Created 2022-08-09T09:25:06+05:30
Boot volume ID Name Attachment ID Attachment name
- - r006-1bcf5342-c12f-4908-ad0f-99218cd603b9 boot-vol-4
Data volumes ID Name Attachment ID Attachment name
- - r006-c034f0f9-2269-44e4-a76a-4f4ad8c47b65 my-vol-att1
Création d'un modèle d'instance et ajout de balises utilisateur à des volumes à partir de l'interface de ligne de commande
Vous pouvez spécifier des balises utilisateur pour les volumes d'amorçage et de données lorsque vous créez une instance. Exécutez la commande instance-template-create et spécifiez les balises utilisateur dans le paramètre user_tags.
Dans l'exemple suivant, la commande ajoute deux balises utilisateur au modèle d'instance à appliquer aux volumes.
ibmcloud is instance-template-create my-tpl-1 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-1", "volume": {"name": "my-boot-vol-1", "profile": {"name": "general-purpose"},"user_tags": ["env:test1", "env:dev1"]}}' --volume-attach '[{"name": "my-vol-att", "volume": {"name":"my-vol-1", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test1", "env:dev1"] }}]'
Creating instance template my-tpl-1 under account vpcdemo as user myuser@mycompany.com...
ID 38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Name my-tpl-1
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance-template:38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Resource group Default
Image c5471ef3-15f5-4468-964b-f9b4d3ca8120
VPC dd1c6831-cc4d-4c40-aab2-6b0c17f41424
Zone us-south-1
Profile bx2-2x8
Metadata service Enabled
false
Keys Key IDs
e7d18039-0e0e-4207-8598-de7cca949030
Boot volume Name Capacity Profile IOPS Attachment name Auto delete Tags
my-boot-vol-1 100 general-purpose 0 boot-vol-1 true env:test1,env:dev1
Data volumes ID Name Capacity Profile IOPS Attachment name Auto delete Tags
- my-vol-1 10 general-purpose 0 my-vol-att false env:test1,env:dev1
Primary Network Interface Name Subnet ID Security Groups Allow source IP spoofing Reserved IP Address Reserved IP ID Reserved IP Name Reserved IP Auto Delete
primary 0617-c1f1e468-3283-4f44-9d08-3d57b77817f1 7c2db5ac-19e0-4d83-8226-e6178fedfe56 false - - - -
Created 2022-08-22T09:10:34+05:30
Vous pouvez utiliser le modèle d'instance pour créer une instance et des volumes avec des étiquettes utilisateur. Consultez l'exemple suivant.
ibmcloud is instance-template-create --template my-tpl-1 --name my-vsi-3 --boot-volume '{"name": "boot-vol-3", "volume": {"name": "my-boot-vol-3", "profile": {"name": "general-purpose"},"user_tags": ["env:test3", "env:dev3"]}}' --volume-attach '[{"name": "my-vol-att1", "volume": {"name":"my-vol-3", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test3", "env:dev3"] }}]'
Création de volumes Block Storage for VPC avec l'API
Vous pouvez créer des volumes Block Storage for VPC en appelant directement les API REST VPC. Pour plus d'informations sur l'API VPC, voir les informations de référence de l'API VPC.
Avant de commencer
Définissez des variables pour le jeton IAM, le point d'extrémité d'API et la version d'API. Pour obtenir des instructions, voir Configuration de votre environnement d'API et d'interface de ligne de commande.
Création d'un volume de données dans le cadre de l'approvisionnement d'une instance à l'aide de l'API
Effectuez une demande POST /instances pour créer une instance et définissez le volume à l'aide du paramètre volume_attachments. Indiquez un nom de volume, une capacité et un profil.
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 est générée.
Cet exemple spécifie le chiffrement géré par le client et les balises utilisateur pour les volumes d'amorçage et de données.
curl -X POST "$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" -H "Authorization: Bearer $iam_token" -d '{
"boot_volume_attachment": {
"volume": {
"encryption_key": {"crn": "crn:[...]"},
"name": "my-boot-volume",
"profile": {"name": "general-purpose"},
"storage_generation": 1,
"user_tags": {"env:test","env:prod"}}},
"image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
"keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
"name": "my-instance",
"placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
"primary_network_interface": {
"name": "my-network-interface",
"subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
"profile": {"name": "bx2-2x8"},
"volume_attachments": [
{"volume": {
"capacity": 1000,
"encryption_key": {"crn": "crn:[...]"},
"name": "my-data-volume",
"profile": {"name": "5iops-tier"},
"storage_generation": 1,
"user_tags": {"env:test","env:prod"}}
}],
"vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
"zone": {"name": "us-south-1"}
}'
Une réponse qui aboutit se présente comme suit :
{
"bandwidth": 4000,
"boot_volume_attachment": {
"device": {
"id": "a8a15363-a6f7-4f01-af60-715e85b28141"
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
"id": "a8a15363-a6f7-4f01-af60-715e85b28141",
"name": "my-boot-volume-attachment",
"volume": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"name": "my-boot-volume"
}
},
"created_at": "2022-06-15T16:11:57Z",
"crn": "crn:[...]",
"dedicated_host": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"name": "test-new",
"resource_type": "dedicated_host"
},
"disks": [],
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
"id": "eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
"image": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/images/9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
"name": "my-image"
},
"memory": 8,
"name": "my-instance",
"network_interfaces": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"name": "my-network-interface",
"primary_ipv4_address": "10.0.0.32",
"resource_type": "network_interface",
"subnet": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/7389-bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"name": "my-subnet"
}
}
],
"placement_target": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
"name": "test-new",
"resource_type": "dedicated_host"
},
"primary_network_interface": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
"name": "my-network-interface",
"primary_ipv4_address": "10.0.0.32",
"resource_type": "network_interface",
"subnet": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
"name": "my-subnet"
}
},
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/instance/profiles/bx2-2x8",
"name": "bx2-2x8"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
"id": "4bbce614c13444cd8fc5e7e878ef8e21",
"name": "Default"
},
"status": "running",
"status_reasons": [],
"vcpu": {
"architecture": "amd64",
"count": 2
},
"volume_attachments": [
{
"device": {
"id": "a8a15363-a6f7-4f01-af60-715e85b28141"
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
"id": "a8a15363-a6f7-4f01-af60-715e85b28141",
"name": "my-boot-volume-attachment",
"volume": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
"name": "my-boot-volume"
}
},
{
"device": {
"id": "e77125cb-4df0-4988-a878-531ae0ae0b70"
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-e77125cb-4df0-4988-a878-531ae0ae0b70",
"id": "e77125cb-4df0-4988-a878-531ae0ae0b70",
"name": "my-volume-attachment-1",
"volume": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2cc091f5-4d46-48f3-99b7-3527ae3f4392",
"id": "2cc091f5-4d46-48f3-99b7-3527ae3f4392",
"name": "my-data-volume"
}
}
],
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/f0aae929-7047-46d1-92e1-9102b07a7f6f",
"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f",
"name": "my-vpc"
},
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
}
Création d'un volume de démarrage sdp dans le cadre du provisionnement d'une instance avec l'API
En plus de la capacité et des IOPS, vous pouvez également spécifier une limite de débit personnalisée avec la propriété bandwidth. Consultez l'exemple suivant.
curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-09-24&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
"boot_volume_attachment": {
"volume": {
"encryption_key": {"crn": "crn:[...]"},
"name": "my-defined-performance-boot-volume",
"profile": {"name": "sdp"},
"boot_capacity": 250,
"iops": 3000,
"bandwidth": 1000
"storage_generation": 2,
"user_tags": {"env:test","env:prod"}},
"image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
"keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
"name": "my-instance",
"placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
"primary_network_interface": {
"name": "my-network-interface",
"subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
"profile": {"name": "bx3dc-2x10"},
"vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
"zone": {"name": "us-east-1"}
}
}
Pour plus d'informations sur la création de volumes avec l'API, voir Création de volumes Block Storage et la référence API pour la création d'une instance
Création d'un volume Block Storage for VPC autonome avec l'API
Effectuez une demande POST /volumes pour créer un volume. Indiquez un nom, le nombre d'IOPS, la capacité, le profil et la zone.
L'exemple suivant a créé un volume custom avec une capacité de 50 Mo et 100 IOPS dans la région us-south. La demande spécifie également une clé racine client pour le chiffrement géré par le client et un groupe de
ressources.
curl -X POST "$vpc_api_endpoint/v1/volumes?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-volume-4",
"iops": 100,
"capacity": 50,
"zone": {"name": "us-south-2"},
"profile": {"name": "custom"},
"encryption_key":{"crn":"crn:[...]"},
"resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
}'
Une réponse réussie ressemble à celle de l'exemple ci-après.
{
"capacity": 50,
"created_at": "2022-06-14T23:16:53.000Z",
"crn": "crn:[...]",
"encryption": "user_managed",
"encryption_key": {
"crn": "crn:[...]"
},
"health_reasons": [],
"health_state": "ok",
"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",
"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"
}
}
Lorsque vous utilisez le profil sdp, vous pouvez créer un volume de données avec une capacité et un nombre d'IOPS personnalisés, et vous pouvez également spécifier une limite de débit personnalisée avec la propriété bandwidth.
L'exemple suivant crée un tel volume de données autonome dans la région us-east.
curl -X POST "$vpc_api_endpoint/v2/volumes?version=2024-09-27&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-special-volume-1",
"iops": 3000,
"capacity": 250,
"bandwidth": 5000,
"zone": {"name": "us-east-2"},
"profile": {"name": "sdp"},
"encryption_key":{"crn":"crn:[...]"},
"resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
}'
Une réponse réussie ressemble à celle de l'exemple ci-après.
{
"adjustable_capacity_states:": "attached, unattached",
"adjustable_iops_states": "attached, unattached",
"bandwidth": 5000,
"capacity": 250,
"created_at": "2024-09-27T23:16:53.000Z",
"crn": "crn:[...]",
"encryption": "user_managed",
"encryption_key": {
"crn": "crn:[...]"
},
"health_reasons": [],
"health_state": "ok",
"href": "https://us-east.iaas.cloud.ibm.com/v2/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"iops": 3000,
"name": "my-special-volume-1",
"profile": {
"href": "https://us-east.iaas.cloud.ibm.com/v2/volume/profiles/sdp",
"name": "sdp"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
"name": "Default"
},
"status": "available",
"status_reasons": [],
"volume_attachments": [],
"zone": {
"href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2",
"name": "us-east-2"
}
}
Pour plus d'informations sur la création de volume avec l'API, voir Création de volumes Block Storage et la référence d'API pour la création d'un volume.
Création d'un volume de données à partir d'un instantané via l'API
Vous pouvez spécifier un ID de cliché, un nom ou un CRN dans un appel POST /volumes pour créer un volume de données autonome. Lorsque vous spécifiez un instantané dont la valeur de la propriété d' storage_generation s est 1, le nouveau volume de stockage en bloc est créé avec la même valeur d' storage_generation s et seuls les profils de volume de la même génération peuvent lui être appliqués.
Les données sont entièrement restaurées lorsque vous connectez le volume de données à une instance de serveur virtuel. Pour plus d'informations, voir À propos de la restauration d'un volume à partir d'un instantané. Pour un exemple d'appel d'API, voir Restauration d'un volume de données à partir d'un instantané d'un volume non connecté.
Création de volumes Block Storage for VPC avec Terraform
Pour utiliser Terraform, téléchargez le CLI Terraform et configurez le plug-in IBM Cloud® 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"
}
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 est générée.
Création de volumes Block Storage for VPC autonomes avec Terraform
Pour créer un volume Block Storage for VPC, utilisez la ressource ibm_is_volume. L'exemple suivant crée un volume de première génération avec une capacité de 4 To et le profil de performance 10iops-tier.
resource "ibm_is_volume" "10iops_volume_example" {
name = "example-volume-10iops"
profile = "10iops-tier"
zone = "us-south-1"
capacity = 4000
}
L'exemple suivant crée un volume de première génération avec un profil custom. Le volume créé a une capacité de 200 Mo et peut effectuer 1000 IOPS.
resource "ibm_is_volume" "custom_volume_example" {
name = "example-volume-custom"
profile = "custom"
zone = "us-south-1"
iops = 1000
capacity = 200
encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}
L'exemple suivant crée un volume de deuxième génération avec le profil sdp. Le volume créé a une capacité de 250 Mo, peut effectuer 3000 IOPS avec une limite de bande passante maximale de 1000 Mbps.
resource "ibm_is_volume" "sdp_volume_example" {
name = "example-volume-sdp"
profile = "sdp"
zone = "us-south-1"
iops = 3000
capacity = 250
bandwidth = 1000
encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_volume.
Création d'un volume Block Storage for VPC autonome à partir d'un instantané avec Terraform
Pour créer un volume Block Storage for VPC à partir d'un instantané, utilisez la ressource ibm_is_volume. L'exemple suivant crée un volume basé sur un instantané identifié par son ID. Vous pouvez également utiliser le nom ou le
CRN pour identifier le snapshot.
resource "ibm_is_volume" "example-volume-from-snapshot" {
name = "example-volume"
profile = "general-purpose"
zone = "us-south-1"
source_snapshot = ibm_is_snapshot.example.id
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_volume.
Les profils de volume de première et de deuxième génération ne sont pas interchangeables. Vous pouvez utiliser un instantané d'un volume de deuxième génération pour créer un autre volume de deuxième génération, mais vous ne pouvez pas remplacer
le profil de volume par un profil de volume de première génération. De la même manière, vous pouvez utiliser un instantané d'un volume de première génération pour créer un autre volume de première génération avec les mêmes données, mais
vous ne pouvez pas basculer le nouveau volume sur le profil sdp.
Création d'un volume de démarrage dans le cadre du provisionnement d'une instance avec Terraform
Pour créer un volume de données à partir d'un instantané lorsque vous créez une instance de serveur virtuel, utilisez la ressource ibm_is_instance. L'exemple suivant crée une instance de serveur virtuel avec un volume de démarrage
qui utilise le profil de volume sdp et est protégé par une clé de cryptage gérée par le client. Lorsque vous spécifiez le profil sdp pour le volume de démarrage, vous pouvez spécifier des limites de capacité, d'IOPS
et de bande passante personnalisées.
resource "ibm_is_instance" "example_instance" {
name = "example-instance-reserved-ip"
image = data.ibm_is_image.example_image.id
profile = data.ibm_is_instance_profile.example_profile.name
primary_network_interface {
name = "eth0"
subnet = ibm_is_subnet.example_subnet.id
primary_ip {
reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
}
}
network_interfaces {
name = "eth1"
subnet = ibm_is_subnet.example_subnet.id
primary_ip {
name = "example-reserved-ip1"
auto_delete = true
address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
}
}
vpc = ibm_is_vpc.example_vpc.id
zone = "us-south-1"
keys = [ibm_is_ssh_key.example_sshkey.id]
boot_volume {
name = "example-boot-volume"
profile = "sdp"
size = 250
iops = 3000
bandwidth = 1000
encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_instance.
Création d'un volume d'amorçage à partir d'un instantané dans le cadre de la mise à disposition d'instance avec Terraform
Pour créer un volume de données à partir d'un instantané lorsque vous créez une instance de serveur virtuel, utilisez la ressource ibm_is_instance. L'exemple suivant crée une instance de serveur virtuel avec le nom "example-vsi-restore".
Le volume d'amorçage est défini dans l'argument boot_volume avec son nom, son instantané source et les balises utilisateur.
resource "ibm_is_snapshot" "example" {
name = "example-snapshot"
source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
}
resource "ibm_is_instance" "example" {
name = "example-vsi-restore"
profile = "cx2-2x4"
boot_volume {
name = "boot-restore"
snapshot = ibm_is_snapshot.example.id
tags = ["tags-0"]
}
primary_network_interface {
subnet = ibm_is_subnet.example.id
}
vpc = ibm_is_vpc.example.id
zone = "us-south-1"
keys = [ibm_is_ssh_key.example.id]
network_interfaces {
subnet = ibm_is_subnet.example.id
name = "eth1"
}
}
Si vous souhaitez restaurer un volume à partir d'un instantané d'un autre compte, vous pouvez utiliser l'argument " source_snapshot_crn pour identifier l'instantané par son CRN au lieu de son ID.
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_instance.
Création d'un volume de données à ajouter à une instance existante avec Terraform
Pour créer un volume de données et le connecter à une instance de serveur virtuel, utilisez la ressource ibm_is_instance_volume_attachment. L'exemple suivant crée un volume de données de 20 Mo avec un profil de volume general-purpose et l'attache à l'instance ibm_is_instance.example.id.
rresource "ibm_is_instance_volume_attachment" "example" {
instance = ibm_is_instance.example.id
name = "example-vol-att-1"
profile = "general-purpose"
capacity = "20"
delete_volume_on_attachment_delete = true
delete_volume_on_instance_delete = true
volume_name = "example-vol-1"
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_instance_volume_attachment.
Etapes suivantes
Vous pouvez continuer à créer d'autres volumes Block Storage for VPC ou gérer les volumes existants.