Regolazione del limite di larghezza di banda per una condivisione di file regionale

Selezionare la disponibilità I clienti con accesso speciale all'anteprima della nuova offerta di condivisione di file regionali possono utilizzare il profilo rfs per creare condivisioni di file con disponibilità di dati regionali e valori di larghezza di banda regolabili.

Regolare la larghezza di banda per le condivisioni di file regionali utilizzando il profilo rfs, portandola da 800 a 8192 Mbps (1024 MBps) per la velocità di trasmissione combinata in lettura e scrittura. Gestisci il limite di larghezza di banda tramite la console, l'interfaccia a riga di comando (CLI) o l'API.

Con questa funzione, è possibile aumentare o diminuire il limite di larghezza di banda della condivisione nella console, dalla CLI o con l'API. Per modificare questo attributo, la condivisione deve essere in uno stato disponibile. L'autorizzazione dell'utente viene verificata prima di modificare il limite di banda.

La fatturazione di una condivisione di file aggiornata viene aggiornata automaticamente. La differenza proporzionale del nuovo prezzo viene aggiunta al ciclo di fatturazione corrente. L'intero nuovo ammontare viene quindi fatturato nel prossimo ciclo di fatturazione.

Regolazione della larghezza di banda nella console

  1. Andare all'elenco di tutte le condivisioni di file. Dalla console IBM Cloud, fare clic sull'icona del menu di navigazione > icona VPC infrastruttura > Archiviazione > Condivisioni di archiviazione file.
  2. Fare clic sul nome di una condivisione di file per visualizzare la pagina dei dettagli.
  3. Individuare la sezione Profilo e fare clic sull'icona Modifica Icona Modifica, oppure utilizzare il menu Azioni Icona Azioni Azioni e selezionare Modifica larghezza di banda.
  4. Nel pannello laterale è possibile specificare un limite di larghezza di banda per la condivisione dei file compreso tra il valore minimo di 800 e il massimo di 8192 Mbps.
  5. Esaminare il riepilogo degli ordini mensili stimati.
  6. Se si è soddisfatti, fare clic su Salva e continuare.

Regolazione della larghezza di banda dalla CLI

Dalla CLI, utilizzare il comando ibmcloud is share-update con l'opzione --bandwidth per indicare il nuovo valore di larghezza di banda per un profilo personalizzato.

ibmcloud is share-update share_ID --bandwidth BANDWIDTH

Questo esempio mostra un aumento del limite di banda a 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

Le condivisioni di file con disponibilità regionale servono i dati in ogni zona della regione. La risposta del comando mostra la prima zona della regione per impostazione predefinita.

Per ulteriori informazioni sulle opzioni di comando disponibili, vedere ibmcloud is share-update.

Regolazione della larghezza di banda con l'API

È possibile regolare la larghezza di banda per le condivisioni di dati esistenti chiamando l'API VPC. Effettuare una richiesta PATCH /shares e specificare il parametro bandwidth per regolare il limite di larghezza di banda.

Non è possibile aggiornare il nome della condivisione, aumentare le dimensioni, regolare gli IOPS e regolare il limite di larghezza di banda nella stessa richiesta a PATCH /shares. Fate richieste separate a PATCH /shares.

Questo esempio mostra il valore della larghezza di banda aumentato a 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
    }'

Lo stato della condivisione file mostra updating mentre la larghezza di banda viene regolata. La larghezza di banda preimpostata viene visualizzata fino al completamento dell'aggiornamento.

{
	"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",
    .
    .
    .
}

Regolazione del limite di banda con Terraform

Per modificare le IOPS di una condivisione, utilizzare la risorsa ibm_is_share. Una volta applicato, l'esempio seguente aggiorna il limite di larghezza di banda della condivisione file a 4.000 Mbps.

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

Per ulteriori informazioni sugli argomenti e gli attributi, vedere ibm_is_share.