Ajustement de l'IOPS pour un partage de fichiers zonal
Ajustez les limites d'opérations d'entrée-sortie par seconde (IOPS) pour les partages de fichiers par zone utilisant le profil « dp2 » de 100 à 96 000 IOPS sans interruption de service.
Les modifications prennent effet immédiatement, sans interruption de service. Vous pouvez gérer la limite d'IOPS via la console, l'interface de ligne de commande (CLI), l'API ou Terraform.
La facturation d'un partage mis à jour est automatiquement ajustée. La différence au prorata du nouveau prix est ajoutée au cycle de facturation actuel. Le nouveau montant total est ensuite facturé dans le cycle de facturation suivant.
Sélectionnez la disponibilité Vous ne pouvez pas modifier la valeur IOPS des partages de fichiers régionaux qui sont créés avec le profil rfs. Cependant, vous pouvez ajuster la valeur
de la bande passante pour affiner les performances du partage.
Concepts d'IOPS ajustables
Vous pouvez ajuster le nombre d'IOPS de vos partages de fichiers par zone afin d'adapter les performances à vos besoins.
-
Par exemple, vous pourriez constater qu'une application a évolué à tel point que la limite actuelle d'IOPS constitue désormais un goulot d'étranglement au niveau des performances. Vous pouvez modifier les caractéristiques de performance du partage de fichiers existant en augmentant les IOPS.
-
Dans un autre cas de figure, vous pourriez souhaiter configurer initialement votre stockage de fichiers avec un niveau d'IOPS plus élevé afin d'accélérer le téléchargement des données. Une fois le téléchargement terminé, vous pouvez réinitialiser les paramètres de stockage à 5 IOPS/Go pour un fonctionnement normal. Vous pouvez également augmenter les IOPS de votre partage de fichiers pendant les heures de pointe de votre application et diminuer les IOPS pendant les heures creuses.
Lorsque votre partage utilise le profil dp2 les IOPS du partage peuvent varier de 100 à 96 000. Vous pouvez spécifier votre valeur IOPS avec des restrictions minimales. L'IOPS peut être ajusté à plusieurs reprises jusqu'à ce que la limite maximale ou minimale soit atteinte.
Pour atteindre les 96 000 IOPS, un même partage de fichiers doit être accessible par plusieurs instances de serveurs virtuels. Un partage de fichiers unique auquel accède un seul client est limité à 48 000 IOPS.
Lorsque votre partage de fichiers utilise le profil de partage personnalisé Deprecated, la plage d'IOPS est basée sur la taille du partage de fichiers.
- Par exemple, pour un partage de fichiers de 25 Go, vous pouvez augmenter les IOPS n'importe où dans la plage de 100 à 1 000 IOPS avec un profil personnalisé. Si vous passez par la suite augmenter la capacité d'un partage de fichiers à la tranche de prix supérieure, vous pourrez à nouveau augmenter le nombre d'IOPS. L'IOPS peut être ajusté à plusieurs reprises jusqu'à ce que la limite maximale ou minimale soit atteinte.
- Vous pouvez également passer d'un profil personnalisé à un profil de niveau IOPS ou au profil dp2. La sélection des niveaux d'IOPS est limitée par la taille du partage de fichiers. Lorsque vous passez d'un profil personnalisé à un profil à plusieurs niveaux, la facturation est mise à jour et le nombre d'IOPS est ajusté en fonction du profil.
Lorsque votre partage de fichiers utilise l'un des profils de partage hiérarchisés Deprecated, vous pouvez ajuster votre limite d'IOPS de la manière suivante :
-
Passage d'un profil de niveau IOPS au profil
dp2oucustom. Dans ce cas, la taille du partage de fichiers limite la plage d'IOPS que vous pouvez sélectionner.- Par exemple, si vous ajustez l'IOPS pour le partage de fichiers avec un profil de 3 IOPS/GB et qu'il y a 12 000 GB, vous pouvez ajuster l'IOPS en utilisant un profil personnalisé ou dp2. C'est possible parce que les deux prennent en charge une taille de partage de 12 000 Go.
- Si la taille du partage de fichiers était supérieure à 16 000 Go, le profil personnalisé ne permettrait pas d'ajuster l'IOPS, mais le profil dp2 le permettrait car il prend en charge des tailles de partage allant jusqu'à 32 000 Go. Les tailles maximales des niveaux IOPS sont de 32 000 Go pour 3 IOPS/Go, de 9 600 Go pour 5 IOPS/Go et de 4 800 Go pour 10 IOPS/Go.
Lorsque vous passez d'un profil à niveaux à un profil personnalisé ou « dp2 », la facturation est mise à jour en fonction des IOPS spécifiées.
-
Sélection d'un autre niveau d'IOPS. L'IOPS est ajusté au sein du niveau. Le niveau d'augmentation des IOPS est déterminé par la valeur maximale autorisée par le profil de niveau d'IOPS du partage de fichiers. Vous pouvez ajuster les IOPS d'un niveau IOPS en fonction de la taille du partage ou sélectionner le profil suivant qui permet d'obtenir de meilleures performances.
Le nombre maximal d'IOPS pour un partage de fichiers avec un profil de niveau de 3 IOPS/Go est de 96 000 IOPS. Tous les autres profils sont plafonnés à 48 000 IOPS. Pour atteindre 96 000 IOPS, un partage de fichiers unique doit être accessible à plusieurs instances de serveur virtuel. Un partage de fichiers unique auquel accède une seule instance est limité à 48 000 IOPS.
Pour ajuster les IOPS d'un partage de fichiers, le partage de fichiers doit être à l'état stable. Votre autorisation utilisateur est vérifiée avant l'ajustement des IOPS.
Vous pouvez surveiller la progression des modifications d'IOPS de votre partage de fichiers à partir de l'interface utilisateur ou de l'interface de ligne de commande. Vous pouvez également consulter les événements de suivi de l'activité pour vérifier que les IOPS ont bien été ajustées.
Limitations
Les limitations suivantes s'appliquent.
- Pour ajuster les IOPS, le partage de fichiers doit être à l'état stable.
- Un profildp2 peut être étendu au maximum autorisé par la bande dp2. Vous ne pouvez pas changer de tranche d'IOPS d' dp2, sauf si vous augmentez la taille du partage de fichiers, puis passez à une tranche supérieure.
- Pour un partage de fichiers créé avec un profil de niveau IOPS afin d'augmenter ou de réduire les IOPS, sélectionnez un autre profil pour la taille de partage de fichiers. Si la taille du partage de fichiers dépasse celle du nouveau profil de niveau IOPS, vous ne pouvez pas modifier le profil.
- Un profil d'IOPS personnalisé peut être étendu jusqu'au maximum autorisé par la bande personnalisée. Vous ne pouvez pas changer de tranche personnalisée sans augmenter la taille du partage de fichiers, puis passer à une tranche supérieure.
- L'ajustement des IOPS en se déplaçant entre les profils est limité par la taille du partage de fichiers.
- Le nombre maximal d'IOPS pour un partage de fichiers pour tous les profils est de 96 000 IOPS. Pour atteindre 96 000 IOPS, un partage de fichiers unique doit être accessible à plusieurs instances de serveur virtuel. Un partage de fichiers donné au sein d'une instance est limité à 48 000 IOPS.
Réglage des IOPS dans la console
Procédez comme suit pour ajuster les IOPS en sélectionnant un nouveau niveau d'IOPS ou la bande personnalisée d'IOPS :
-
Accédez à la liste des partages de fichiers. Dans la console IBM Cloud, cliquez sur l'icône de
Navigation > Infrastructure 
> Stockage > Partages de stockage de fichiers. Par défaut, les partages de fichiers s'affichent pour tous les groupes de ressources de votre région. -
Sur la page de la liste des partages de fichiers pour VPC, cliquez sur le nom d'un partage de fichiers pour en afficher les détails.
-
Sur la page de détails du partage de fichiers, repérez « Profil » et cliquez sur « Icône « Modifier »
» ou utilisez le menu
« Actions » et sélectionnez « Modifier le profil IOPS ». Les volumes doivent être connectés à une instance de serveur virtuel pour ces actions. -
Dans le panneau latéral, ajustez les IOPS comme suit :
-
Pour le profil « dp2 » ou le profil personnalisé, la valeur actuelle des IOPS et la taille du partage de fichiers sont affichées. Entrez une nouvelle valeur d'E-S/s dans la plage autorisée pour cette taille.
-
Pour un niveau IOPS, sélectionnez un autre niveau dans le menu. Par exemple, vous pouvez avoir un profil général de 3 IOPS/Go que vous souhaitez augmenter à un profil de 5 IOPS/Go.
-
-
Examinez le récapitulatif de commande mensuel estimé pour votre zone géographique et la nouvelle tarification.
-
Si vous êtes satisfait, cliquez sur Enregistrer et continuer. Votre nouvelle allocation d'IOPS prend effet lorsque vous redémarrez l'instance.
Ajustement des IOPS à partir de l'interface de ligne de commande
Ajustement des IOPS pour un profil personnalisé ou dp2
Depuis l'interface en ligne de commande (CLI), utilisez la commande « share-update » avec la propriété « --iops » pour spécifier la nouvelle valeur d'IOPS pour un profil personnalisé ou un profil « dp2 ». Les IOPS
que vous indiquez doivent se situer dans la plage correspondant à la taille du partage de fichiers. Pour plus d'informations, voir le " dp2 ou le " Profil IOPS personnalisé.
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.
-
Localisez votre partage à partir de l'interface de ligne de commande en répertoriant vos partages de fichiers dans la région à l'aide de la commande
ibmcloud is shares.ibmcloud is sharesListing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com... ID Name Lifecycle state Zone Profile Size(GB) Resource group Replication role r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516 my-replica-file-share stable us-south-1 dp2 1500 Default replica r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-file-share stable us-south-2 dp2 1500 Default source r006-6d1719da-f790-45cc-9f68-896fd5673a1a my-replica-share stable us-south-3 dp2 1500 Default replica r006-925214bc-ded5-4626-9d8e-bc4e2e579232 my-new-file-share stable us-south-2 dp2 500 Default none r006-b1707390-3825-41eb-a5bb-1161f77f8a58 my-vpc-file-share stable us-south-2 dp2 1000 Default none r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 my-file-share stable us-south-2 dp2 1500 Default source -
Affichez les détails du partage de fichiers que vous souhaitez modifier à l'aide de la commande
ibmcloud is share.ibmcloud is share my-file-shareGetting file share my-file-share under account Test Account as user test.user@ibm.com... ID r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 Name my-file-share CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 Lifecycle state stable Access control mode security_group Accessor binding role none Zone us-south-2 Profile dp2 Size(GB) 1000 IOPS 1000 User Tags docs:test Encryption provider_managed Mount Targets ID Name r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61 my-cli-share-mount-target-1 Resource group ID Name db8e8d865a83e0aae03f25a492c5b39e Default Created 2023-10-18T22:15:15+00:00 Replication role none Replication status none Replication status reasons Status code Status message - - Snapshot count 0 Snapshot size 0 Source snapshot - -
Utilisez la commande
ibmcloud is share-updatepour augmenter ou réduire les IOPS de votre partage de fichiers.ibmcloud is share-update my-file-share --iops 2000Updating file share my-file-share under account Test Account as user test.user@ibm.com... ID r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 Name my-file-share CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 Lifecycle state updating Access control mode security_group Accessor binding role none Zone us-south-2 Profile dp2 Size(GB) 1000 IOPS 2000 User Tags docs:test Encryption provider_managed Mount Targets ID Name r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61 my-cli-share-mount-target-1 Resource group ID Name db8e8d865a83e0aae03f25a492c5b39e Default Created 2023-10-18T22:15:15+00:00 Replication role none Replication status none Replication status reasons Status code Status message - - Snapshot count 0 Snapshot size 0 Source snapshot - Allowed Access Protocols nfs4 Availability Mode zonal Bandwidth(Mbps) 1 Storage Generation 1
Pour plus d'informations sur les options de commande, voir ibmcloud is share-update my-file-share.
Ajustement des E-S/s en spécifiant un profil de niveau d'E-S/s différent
Ces instructions concernent la génération précédente de profils de partage de fichiers (usage général, 5-iops, 10-iops ou personnalisé) qui ont été utilisés dans la version bêta des partages de fichiers zonaux. A partir du 06 mai 2026, ces profils d'actions sont obsolètes. Pour accéder aux dernières fonctionnalités, vous devez changer le profil IOPS de votre partage en dp2.
A partir de l'interface de ligne de commande, utilisez la commande ibmcloud is share-update avec la propriété --profile et indiquez le nom ou l'attribut href du profil de niveau IOPS.
L'exemple suivant permet de passer d'un profil de 3 IOPS/Go à un profil de 5 IOPS/Go. Dans ce cas, le partage de fichiers ne peut pas dépasser 9 600 Go pour passer au profil supérieur.
ibmcloud is share-update my-file-share --profile tier-5iops
Updating file share my-file-share under account Test Account as user user@mycompany.com...
ID ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Name my-file-share
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Lifecycle state updating
Access control mode security_group
Accessor binding role none
Zone us-south-1
Profile tier-5iops
Size(GB) 100
IOPS 3000
User Tags docs:test
Encryption provider_managed
Mount targets ID Name VPC ID VPC Name
No mount targets found.
Resource group ID Name
7f1645c5-8afa-4a7e-860d-3df563e0aa8d Default
Created 2023-02-26T20:01:18+05:30
Snapshot count 0
Snapshot size 0
Source snapshot -
Pour plus d'informations sur les options de commande, voir ibmcloud is share-update my-file-share.
Réglage des IOPS via l'API
Vous pouvez ajuster les IOPS de partages de fichiers de données existants en appelant l'API VPC (Virtual Private Cloud).
Ajuster les IOPS pour le dp2 ou le profil personnalisé
Effectuez une demande PATCH /shares et spécifiez la propriété iops pour ajuster les IOPS dans la plage autorisée pour un profil dp2 personnalisé.
Vous ne pouvez pas mettre à jour le nom du partage de fichiers et ajuster les IOPS dans la même demande PATCH /shares. Effectuez deux demandes PATCH /shares.
L'exemple suivant illustre une augmentation de 100 IOPS à 3 000 IOPS pour un partage de fichiers de 100 Go, sur la base d'un profil personnalisé « 100 - 499 ». La plage IOPS de cette bande personnalisée est de 100 - 6 000 IOPS. Pour plus d'informations sur les plages d'IOPS disponibles, voir Aperçu des profils de stockage de fichiers.
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-086&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"iops": 3000
}'
L'état du partage de fichiers indique « updating » pendant que les IOPS sont en cours d'ajustement. Les IOPS en cours sont affichées jusqu'à ce que vous redémarriez l'instance. Dans l'exemple suivant, la valeur IOPS est ajustée
à partir de 100.
{
"created_at": "2023-08-08T22:58:49.000Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-a0c07083-f411-446c-9316-7b08d6448c86",
"id": "r006-a0c07083-f411-446c-9316-7b08d6448c86",
"iops": 100,
.
.
.
"status": "updating",
.
.
.
}
Lorsque l'expansion des IOPS est terminée, redémarrez l'instance. La nouvelle valeur s'affiche et l'état du partage de fichiers est « stable ».
{
"created_at": "2023-08-08T22:58:49.000Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86",
"id": "a0c07083-f411-446c-9316-7b08d6448c86",
"iops": 3000,
"lifecycle_state": "stable",
"name": "my-share-updated",
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-3iops",
"name": "custom",
"resource_type": "share_profile"
},
"access_control_mode": "security-group",
"allowed_transit_encryption_modes": ["none", "user-managed"],
"replication_role": "none",
"replication_status": "none",
"replication_status_reasons": [],
"resource_group": {
"crn": "crn:[...]",
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
"id": "678523bcbe2b4eada913d32640909956",
"name": "Default"
},
"resource_type": "share",
"size": 4800,
"mount_targets": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86/mount_targets/1b5571cb-536d-48d0-8452-81c05c6f7b80",
"id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
"name": "my-mount-target",
"resource_type": "share_target",
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/r006-12bb28fc-856d-4902-813b-dc065d1ed084",
"id": "12bb28fc-856d-4902-813b-dc065d1ed084",
"name": "my-vpc",
"resource_type": "vpc"
}
}
],
"snapshot_count": 10,
"snapshot_size": 10,
"user_tags": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1",
"resource_type": "zone"
}
}
Ajustement des E-S/s en spécifiant un profil de niveau d'E-S/s différent
Ces instructions concernent la génération précédente de profils de partage de fichiers (usage général, 5-iops, 10-iops ou personnalisé) qui ont été utilisés dans la version bêta des partages de fichiers zonaux. A partir du 06 mai 2026, ces profils d'actions sont obsolètes. Pour accéder aux dernières fonctionnalités, vous devez changer le profil IOPS de votre partage en dp2.
Effectuez une demande PATCH /shares et spécifiez la propriété profile, puis indiquez le nom ou l'attribut href du profil de niveau IOPS.
L'exemple suivant permet de passer d'un profil de 3 IOPS/Go à un profil de 5 IOPS/Go. Dans ce cas, le partage de fichiers ne peut pas dépasser 9 600 Go pour passer au profil supérieur.
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-07-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"profile": "5iops-tier"
}'
Ajustement des E-S/s avec Terraform
Vous pouvez ajuster les IOPS pour les partages de fichiers de données existants dans Terraform.
Ajustement des IOPS pour un profil personnalisé ou dp2
Pour modifier le niveau de performance d'un partage de fichiers, utilisez la ressource ibm_is_share et indiquez la valeur d'IOPS de votre choix. Lorsque vous spécifiez la valeur IOPS, assurez-vous qu'elle est comprise dans la
plage de performances pour la taille du partage de fichiers. Pour plus d'informations, voir Profil de stockage de fichiersdp2.
Lorsqu'il est appliqué, l'exemple suivant met à jour les performances de partage à 5000 IOPS.
resource "ibm_is_share" "example" {
name = "my-new-share"
size = 200
iops = 5000
profile = "dp2"
zone = "us-south-2"
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_share.
Ajustement des E-S/s en spécifiant un profil de niveau d'E-S/s différent
Pour modifier le niveau de performance d'un partage de fichiers avec un profil de niveau IOPS, utilisez la ressource ibm_is_share et spécifiez un autre niveau IOPS. Lorsqu'il est appliqué, l'exemple suivant met à jour les performances
de partage à 5000 IOPS.
resource "ibm_is_share" "example" {
name = "my-share"
size = 220
profile = "tier-5iops"
zone = "us-south-2"
}
Pour plus d'informations sur les arguments et les attributs, voir ibm_is_share.
Etapes suivantes
Créez d'autres partages de fichiers ou gérez vos partages existants :