Connexion d'un volume à une instance à partir de la liste des volumes

À partir de la liste de tous les volumes Block Storage for VPC, procédez comme suit.

1. Dans la console IBM Cloud console, cliquez sur l'icône Menu de navigation > Infrastructure > Stockage > Block Storage volumes.
2. Dans la liste des volumes, identifiez un volume disponible non connecté et cliquez sur l'icône Actions à la fin d'une ligne.
3. Sélectionnez Connecter à l'instance.
4. Sélectionnez une instance de serveur virtuel dans la liste des instances disponibles, puis cliquez sur Enregistrer. Si la liste n'affiche aucune instance de serveur virtuel, cliquez sur Créer un serveur pour accéder à la page Mise à disposition d'instance.
5. Les messages s'affichent sur la page des détails du volume pour indiquer que le volume est connecté à l'image. Une fois l'opération terminée, le nom de l'image apparaît sous Instances connectées.

Lorsque vous créez une instance d' Hyper Protect Virtual Servers e et que le contrat fait référence à des volumes, vous disposez de 15 minutes après la création de l'instance pour y associer un volume de données. Si vous ne le faites pas, l'instance passe à l'état d'arrêt après la fenêtre de 15 minutes.

Connexion d'un volume à une instance à partir de la page des détails du volume

Dans la page des détails du volume, procédez comme suit:

1. Sélectionnez un volume non connecté dans la liste des Block Storage.
2. Sur la page des détails du volume, dans la vignette Instances de serveur virtuel, cliquez sur Connecter.
3. Dans le panneau latéral, sélectionnez une instance de serveur virtuel et cliquez sur Sauvegarder. Si la liste n'affiche aucune instance de serveur virtuel, cliquez sur Créer un serveur pour accéder à la page Mise à disposition d'instance. Le volume d'amorçage ou de données s'affiche sur la page de mise à disposition de l'instance dans leurs zones respectives.
4. Des messages indiquent que le volume est connecté à l'image. Une fois l'opération terminée, le nom de l'image apparaît sous Instances connectées.

Connexion d'un volume à une instance à partir de la page des détails de l'instance

Connectez un volume Block Storage for VPC à partir de la page des 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.
2. Sélectionnez une instance dans la liste de toutes les instances de serveur virtuel. Si des volumes Block Storage for VPC sont connectés, ils sont répertoriés sous Volumes de stockage.
3. Sélectionnez Connecter un volume.
4. Sélectionnez un volume dans la liste des ressources disponibles, puis cliquez sur Connecter. Les messages s'affichent sur la page des détails de l'instance pour indiquer que le volume est connecté. Une fois l'opération terminée, la liste des volumes de stockage est mise à jour pour inclure le nouveau volume.

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.

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

Cette commande renvoie une URL et des invites pour un code d'accès. Accédez à cette URL dans votre navigateur et connectez-vous. En cas de réussite, vous obtenez un code d'accès à usage unique. Copiez ce code et collez-le en réponse à l'invite. Une fois l'authentification réussie, vous êtes invité à choisir votre compte. Si vous avez accès à plusieurs comptes, sélectionnez celui avec lequel vous souhaitez vous connecter. Répondez à toutes les invites restantes pour terminer la connexion.

Montage d'un volume Block Storage for VPC à partir de l'interface de ligne de commande (CLI)

Pour connecter un volume à une instance de serveur virtuel dans le groupe de ressources en cours, exécutez cette commande.

ibmcloud is instance-volume-attachment-add NAME INSTANCE_ID VOLUME_ID [--auto-delete true | false] [--json]

NAME est le nom que vous fournissez pour la connexion de volume et INSTANCE_ID est l'ID de l'instance de serveur virtuel. VOLUME_ID indique le volume que vous connectez. Si vous souhaitez que le volume soit automatiquement supprimé lorsque l'instance de serveur virtuel est supprimée, indiquez --auto-delete true.

Pour afficher la liste des instances de serveurs virtuels disponibles, exécutez la ibmcloud is instances commande. Consultez l'exemple suivant.

ibmcloud is instances

Listing instances in all resource groups and region us-east under account Test Account as user test.user@ibm.com...
ID                                          Name                 Status    Reserved IP   Floating IP      Profile    Image                                VPC                              Zone        Resource group
0757_506a787d-0672-4209-854b-3e280ec50b44    my-rhel-instance    running   10.241.0.4    169.63.96.188    bx2-2x8    ibm-redhat-9-0-minimal-amd64-2       test-pbalak1                     us-east-1   defaults
0757_4fc00b09-c967-46bf-9203-d17a08078d1d    my-rhel-instance2   running   10.241.0.5    150.239.86.22    bx2-2x8    ibm-redhat-9-0-minimal-amd64-2       test-pbalak1                     us-east-1   defaults
0757_11f5db7f-35a1-4678-bcbd-c85204e09507    my-test-ro          stopped   10.241.0.5    -                bx2d-2x8   ibm-ubuntu-18-04-5-minimal-amd64-1   test-vpc-blu-wdc                 us-east-1   defaults
0767_7ac6da13-c16a-4f58-9981-612d6e33ec53    my-ubuntu-vsi       running   10.241.64.4   -                bx2-2x8    ibm-centos-7-9-minimal-amd64-3       test-vpc-blu-wdc                 us-east-2   defaults
0757_ff64452f-7e81-4a48-b938-7fc601597dcd    my-new-ubuntu-vsi   running   10.241.14.4   52.116.121.167   mx2-2x16   ibm-ubuntu-20-04-6-minimal-amd64-1   test-vpc-do-not-delete-default   us-east-1   Default
0757_337977c1-f1f0-42ad-9de4-16fe0cda2ba9    my-virtual-server   running   10.241.4.4    52.116.124.193   mx2-2x16   ibm-ubuntu-20-04-6-minimal-amd64-1   test-vpc-do-not-delete-default   us-east-1   Default

Sélectionnez ensuite l'instance de serveur virtuel qui se trouve dans la même zone que le volume à connecter.

ibmcloud is instance-volume-attachment-add otp1 0757_11f5db7f-35a1-4678-bcbd-c85204e09507 demo-volume-update --auto-delete true

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

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

Affichage des détails d'un volume connecté à une instance de serveur virtuel

Une fois le volume attaché, vous pouvez afficher ses détails en indiquant l'ID ou le nom de l'instance ainsi que l'ID ou le nom de l'attachement du volume dans la commande instance-volume-attachment.

ibmcloud is instance-volume-attachment INSTANCE VOLUME_ATTACHMENT [--json]

ibmcloud is instance-volume-attachment my-test-ro otp1

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

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

Affichage de toutes les connexions de volume d'une instance de serveur

Utilisez la commande instance-volume-attachments et indiquez l'ID ou le nom de l'instance pour afficher tous les volumes associés à une instance.

ibmcloud is instance-volume-attachments INSTANCE [--json]

Consultez l'exemple suivant.

ibmcloud is instance-volume-attachments my-test-ro

Listing volume attachments of instance my-test-ro under account Test Account as user test.user@ibm.com...
ID                                          Name                                 Volume                          Status     Type   Device                                            Auto delete
0757-6757e676-0bf5-4b79-9a5b-29c24e17420c   otp1                                 demo-volume-update              attached   data   0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7   true
0757-af470ade-9d5c-491e-97b2-f000ed4ee49b   scheming-tipper-shivering-decrease   my-test-ro-boot-1629867631000   attached   boot   0757-af470ade-9d5c-491e-97b2-f000ed4ee49b-fc4tl   true

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

Création d'un fichier JSON de connexion de volume

Lorsque vous provisionnez une instance de serveur virtuel à partir de l'interface de ligne de commande (CLI) et que vous créez un volume Block Storage for VPC dans le cadre de ce processus, vous pouvez spécifier un fichier JSON de montage de volume. Le fichier JSON d'attachement de volume, spécifié dans la commande ou sous forme de fichier, contient les paramètres du volume.

Dans la commande CLI que vous utilisez pour créer une instance, vous spécifiez l'option --volume-attach et le fichier JSON de volume. Par exemple, --volume-attach @/Users/myname/myvolume-attachment_create.json.

L'exemple suivant montre le contenu d'un fichier JSON de connexion de volume qui définit un volume personnalisé et spécifie des balises utilisateur.

[
    {
        "name": "myvolume-attachment",
        "delete_volume_on_instance_delete": true,
        "volume": {
            "name": "myvolume",
            "capacity": 100,
            "iops": 1000,
            "profile": {
                "name": "custom"
            },
            "user_tags": {
                "env:test"
            }
        }
    }
]

Attacher un volume Block Storage for VPC à une instance de serveur virtuel à l'aide de l'API

Ajoutez des volumes d' Block Storage for VPC s à une instance de serveur virtuel en appelant directement les API REST.

Créer une connexion de volume pour une instance afin d'y associer un volume Block Storage for VPC. Effectuez une demande POST /instances et précisez volume_attachments.

POST/instances/{instance_id}/volume_attachments

L'exemple suivant crée un montage de volume et spécifie le volume par son ID.

curl -X POST "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments?version=2021-04-20&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "delete_volume_on_instance_delete": true,
      "name": "my-volume-attachment-data-5iops",
      "volume": {"id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945"}
    }'

Une réponse réussie indique que le volume est connecté.

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