Ajustement des IOPS d'un volume Block Storage for VPC

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.

1. 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.

Ajustement des IOPS pour un profil personnalisé

Depuis l'interface en ligne de commande (CLI), utilisez la commande « ibmcloud is volume-update » avec l'option « --iops » pour définir la nouvelle valeur d'IOPS d'un profil personnalisé. Les IOPS que vous choisissez doivent être comprises dans la plage de taille du volume. Pour plus d'informations, voir le profil de volume personnalisé.

ibmcloud is volume-update VOLUME_ID --iops IOPS

Cet exemple montre une augmentation de l'IOPS 100 IOPS à 3 000 IOPS pour un volume de 100 Go basé sur un profil personnalisé 100 - 499. La plage IOPS de cette bande personnalisée est de 100 - 6 000 IOPS.

ibmcloud is volume-update 933c8781-f7f5-4a8f-8a2d-3bfc711788ee --iops 3000

Updating volume 933c8781-f7f5-4a8f-8a2d-3bfc711788ee under account Test Account as user test.user@ibm.com...
ID                                      0738-933c8781-f7f5-4a8f-8a2d-3bfc711788ee
Name                                    demo-volume-update
Capacity                                100
IOPS                                    3000
Profile                                 custom
Encryption Key                          -
Encryption                              provider managed
Status                                  available
Created                                 2021-08-23 10:09:28
Resource Group                          Default(c16d1edde3fd4a71a0130aed371405a0)
Zone                                    us-south-2
Resource Group                          Default(c16d1edde3fd4a71a0130aed371405a0)
Volume Attachment Instance Reference    Vdisk Name    Vdisk ID                                    Vdisk Type   Auto Delete
                                        Vdisk-data1   0738-fd146b1f-e1bb-4eab-ba78-3109e6bc3a2d   data         true
    									Instance Name   Instance ID
       									vsi-test1       0738-8b56da93-7990-4ccf-9dc5-5aee6a5f08f9

Vous pouvez utiliser la même commande pour ajuster l'IOPS d'un volume qui a été créé avec un profil sdp. La nouvelle valeur IOPS peut être comprise entre 100 et 64 000.

Ajuster les E-S/s en spécifiant un profil de niveau d'E-S/s différent

Dans l'interface de ligne de commande, utilisez la commande volume-update avec le paramètre --profile et indiquez le nom ou le href du profil de niveau IOPS.

ibmcloud is volume-update VOLUME_ID --profile VOLUME_PROFILE_NAME

Cet exemple permet de passer d'un profil de 3 IOPS/Go à un profil de 5 IOPS/Go. Dans ce cas, le volume ne peut pas dépasser 9 600 Go pour passer au profil supérieur.

ibmcloud is volume-update demo-volume-update --profile 5iops-tier

Updating volume demo-volume-update under account Test Account as user test.user@ibm.com...

ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   demo-volume-update
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                5iops-tier
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-06-29T16:14:59+00:00
Zone                                   us-east-1
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       data              0757_11f5db7f-35a1-4678-bcbd-c85204e09507   kj-test-ro      false         0757-4dfc4384-c4b5-497e-bab3-6415f9c4d44b   otp

Active                                 true
Busy                                   false
Tags                                   -

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

Ajuster les IOPS pour un volume avec le profil de performance Personnalisé ou Défini

Effectuez une requête « PATCH /volumes » et spécifiez le paramètre « iops » pour ajuster les IOPS dans une plage définie au sein d'un profil de volume personnalisé.

Vous ne pouvez pas mettre à jour le nom du volume et ajuster les IOPS dans la même demande PATCH /volumes. Effectuez deux demandes PATCH /volumes.

Cet exemple montre une augmentation de 100 IOPS à 3 000 IOPS pour un volume de 100 Go basé sur un profil personnalisé 100 - 499. La plage IOPS de cette bande personnalisée est de 100 - 6 000 IOPS.

curl -X PATCH \
 "$vpc_api_endpoint/v1/volumes/$volume_id?version=2022-01-11&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "iops": 3000
    }'

L'état du volume indique « updating » pendant que le nombre d'IOPS est en cours d'ajustement. Les IOPS en cours sont affichées jusqu'à ce que vous redémarriez l'instance. Dans cet exemple, le nombre d'IOPS passe de 100 à 3 000 pour le profil à 3 IOPS/Go.

{
	"iops": 100,
	"created_at": "2022-01-11T09:46:43.000Z",
	"crn": "crn:v1:bluemix:public:is:us-south-1:a/<Acc id>::volume:<Volume ID>",
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

Lorsque l'expansion des IOPS est terminée, redémarrez l'instance. La nouvelle valeur s'affiche, et l'état du volume est « available ».

{
	"capacity": 250,
	"created_at": "2022-01-11T09:46:43.000Z",
	"crn": "crn:[...]",
	"encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
    "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
	"iops": 3000,
	"name": "my-volume-1",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
		"name": "custom"
	},
    "resource_group": {
        "href": "https://resource-manager.bluemix.net/v1/resource_groups/83daf012-5920-4ba9-9689-cc0d2d2281fb",
        "id": "83daf012-5920-4ba9-9689-cc0d2d2281fb",
		"name": "Default"
	},
	"status": "available",
	"volume_attachments": [{
		"delete_volume_on_instance_delete": true,
		"device": {
			"id": "4cbb38bc-57d5-4121-a796-d5b10cf0810a"
		},
		"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/4cbb38bc-57d5-4121-a796-d5b10cf0810a",
		"id": "<4cbb38bc-57d5-4121-a796-d5b10cf0810aAttachment ID>",
		"instance": {
			"crn": "crn:[...]",
			"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5",
			"id": "8f06378c-ed0e-481e-b98c-9a6dfbee1ed5",
			"name": "my-instance-1"
		},
		"name": "my-volume-attachment-1",
		"type": "data"
	}],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
}

Vous pouvez utiliser la même requête API pour ajuster l'IOPS d'un volume qui a été créé avec le profil sdp. La nouvelle valeur IOPS peut être comprise entre 100 et 64 000. Pour atteindre plus de 48 000 IOPS, le volume doit être attaché à une instance de serveur virtuel avec un profil d'instance de 3ème génération.

Ajuster les E-S/s en spécifiant un profil de niveau d'E-S/s différent

Effectuez une demande PATCH /volumes, spécifiez le paramètre profile et indiquez le nom ou le href du profil de niveau IOPS.

Cet exemple permet de passer d'un profil de 3 IOPS/Go à un profil de 5 IOPS/Go. Dans ce cas, le volume ne peut pas dépasser 9 600 Go pour passer au profil supérieur.

curl -X PATCH \
 "$vpc_api_endpoint/v1/volumes/$volume_id?version=2022-01-11&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "profile": "5iops-tier"
    }'

Ajustement des IOPS pour un profil personnalisé

Pour modifier les IOPS d'un volume, utilisez la ressource ibm_is_volume. Lorsqu'il est appliqué, l'exemple suivant met à jour le nombre d'IOPS du volume à 24 000.

resource "ibm_is_volume" "storage" {
  name    = "demo-volume-update"
  size    = 8000
  iops    = 24000
  zone    = "us-south-2"
}

Ajuster les IOPS pour un profil à plusieurs niveaux

Pour modifier les E-S/s d'un volume créé à l'aide d'un niveau de performances, utilisez la ressource ibm_is_volume et spécifiez un autre niveau. Une fois appliqué, l'exemple suivant met à jour le profil de volume vers 5iops-tier.

resource "ibm_is_volume" "storage" {
  name    = "demo-volume-update"
  size    = 8000
  profile = "5iops-tier"
  zone    = "us-south-2"
}

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