Ajustement de la limite de bande passante pour un partage de fichiers régional

Sélectionner la disponibilité Les clients disposant d'un accès spécial pour prévisualiser la nouvelle offre de partage de fichiers régional peuvent utiliser le profil rfs pour créer des partages de fichiers avec une disponibilité régionale des données et des valeurs de bande passante ajustables.

Ajustez la bande passante des partages de fichiers régionaux à l'aide du profil rfs, en la faisant passer de 800 à 8 192 Mbps (1 024 MBps) pour le débit combiné en lecture et en écriture. Gérez la limite de bande passante via la console, l'interface en ligne de commande (CLI) ou l'API.

Cette fonctionnalité vous permet d'augmenter ou de réduire la limite de bande passante de votre partage dans la console, à partir du CLI ou avec l'API. Pour modifier cet attribut, le partage doit être dans un état disponible. L'autorisation de l'utilisateur est vérifiée avant que la limite de bande passante ne soit ajustée.

La facturation relative à un partage de fichiers mis à jour est automatiquement mise à jour. 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.

Réglage de la largeur de bande dans la console

Accédez à la liste de tous les partages de fichiers. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Partages de stockage de fichiers.
Cliquez sur le nom d'un partage de fichiers pour afficher la page des détails.
Localisez la section Profil et cliquez sur l'icône , ou utilisez le menu Actions et sélectionnez Modifier la bande passante.
Dans le panneau latéral, vous pouvez spécifier une limite de bande passante pour le partage de fichiers entre la valeur minimale de 800 et la valeur maximale de 8192 Mbps.
Examinez le récapitulatif des commandes mensuelles estimées.
Si vous êtes satisfait, cliquez sur Enregistrer et continuer.

Ajuster la bande passante à partir de l'interface de ligne de commande

À partir de l'interface utilisateur, utilisez la commande ibmcloud is share-update avec l'option --bandwidth pour indiquer la nouvelle valeur de la bande passante pour un profil personnalisé.

ibmcloud is share-update share_ID --bandwidth BANDWIDTH

Cet exemple montre une augmentation de la limite de la bande passante à 3 000 Mbps.

ibmcloud is share-update my-file-share --bandwidth 2000

Updating 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
   Allowed transit encryption modes   stunnel,none
   Zone                               us-south-1
   Profile                            rfs
   Size(GB)                           1000
   IOPS                               35000
   Bandwidth                          3000
   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                            2025-09-23T22: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           nsf4
   Availability Mode                  zonal
   Storage Generation                 2

Les partages de fichiers avec disponibilité régionale servent les données dans chaque zone de la région. La réponse de la commande affiche par défaut la première zone de la région.

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

Ajuster la bande passante avec l'API

Vous pouvez ajuster la bande passante pour les partages de données existants en appelant l'API VPC. Faites une demande PATCH /shares et spécifiez le paramètre bandwidth pour ajuster la limite de la bande passante.

Vous ne pouvez pas mettre à jour le nom du partage, augmenter la taille, ajuster l'IOPS et ajuster la limite de bande passante dans la même requête PATCH /shares. Faites des demandes séparées pour PATCH /shares.

Cet exemple montre que la valeur de la bande passante a été augmentée à 3 000 Mbps.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2025-09-23&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "bandwidth": 3000
    }'

L'état du partage de fichiers indique « updating » pendant que la bande passante est en cours d'ajustement. La largeur de bande prédéfinie reste affichée jusqu'à ce que la mise à jour soit terminée.

{
	"bandwidth": 400,
	"created_at": "2025-09-23T09:46:43.000Z",
	"crn": "crn:v1:bluemix:public:is:us-east-1:a/<Acc id>::share:<file shareID>",
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

Ajuster la limite de bande passante avec Terraform

Pour modifier les IOPS d'un partage, utilisez la ressource ibm_is_share. Une fois appliqué, l'exemple suivant met à jour la limite de bande passante du partage de fichiers à 4 000 Mbps.

resource "ibm_is_share" "storage" {
   name         = "demo-share-update"
   size         = 8000
   bandwidth    = 4000
}

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