Anpassen der Bandbreitenbegrenzung für eine regionale Dateifreigabe

Verfügbarkeit auswählen Kunden mit speziellem Zugang zur Vorschau des neuen regionalen Dateifreigabeangebots können das Profil rfs verwenden, um Dateifreigaben mit regionaler Datenverfügbarkeit und einstellbaren Bandbreitenwerten zu erstellen.

Passen Sie die Bandbreite für regionale Dateifreigaben mithilfe des rfs-Profils von 800 auf 8192 Mbps (1024 MBps) an, um den kombinierten Lese- und Schreibdurchsatz zu erzielen. Verwalten Sie die Bandbreitenbegrenzung über die Konsole, die CLI oder die API.

Mit dieser Funktion können Sie das Bandbreitenlimit Ihrer Freigabe in der Konsole, über die Befehlszeilenschnittstelle (CLI) oder über die API erhöhen oder verringern. Um dieses Attribut zu ändern, muss sich die Aktie in einem verfügbaren Zustand befinden. Ihre Benutzerberechtigung wird überprüft, bevor die Bandbreitenbegrenzung angepasst wird.

Die Abrechnung für eine aktualisierte Dateifreigabe wird automatisch angepasst. Die anteilige Differenz des neuen Preises wird zum aktuellen Fakturierungszyklus hinzugefügt. Der neue Betrag wird dann vollständig erst im nächsten Abrechnungszyklus in Rechnung gestellt.

Einstellen der Bandbreite in der Konsole

  1. Rufen Sie die Liste aller Dateifreigaben auf. Klicken Sie in der Konsole IBM Cloud auf das Symbol Navigation > Infrastruktur VPC > Storage > File Storage Shares.
  2. Klicken Sie auf den Namen einer Dateifreigabe, um die Detailseite anzuzeigen.
  3. Suchen Sie den Abschnitt Profil und klicken Sie auf das Symbol Bearbeiten oder verwenden Sie das Menü Aktionen Aktionen Aktionen und wählen Sie Bandbreite bearbeiten.
  4. In der Seitenleiste können Sie eine Bandbreitenbegrenzung für die Dateifreigabe zwischen dem Mindestwert von 800 und dem Höchstwert von 8192 Mbit/s festlegen.
  5. Überprüfen Sie die geschätzte monatliche Auftragsübersicht.
  6. Klicken Sie auf Speichern und fortfahren, wenn Sie einverstanden sind.

Einstellen der Bandbreite über die CLI

Verwenden Sie in der CLI den Befehl ibmcloud is share-update mit der Option --bandwidth, um den neuen Bandbreitenwert für ein benutzerdefiniertes Profil anzugeben.

ibmcloud is share-update share_ID --bandwidth BANDWIDTH

Dieses Beispiel zeigt eine Erhöhung der Bandbreitengrenze auf 3.000 Mbit/s.

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

Dateifreigaben mit regionaler Verfügbarkeit dienen der Bereitstellung von Daten in jeder Zone der Region. In der Befehlsantwort wird standardmäßig die erste Zone der Region angezeigt.

Für weitere Informationen über die verfügbaren Befehlsoptionen siehe ibmcloud is share-update.

Anpassen der Bandbreite mit der API

Sie können die Bandbreite für vorhandene Datenfreigaben anpassen, indem Sie die VPC-API aufrufen. Stellen Sie eine Anfrage an PATCH /shares und geben Sie den Parameter bandwidth an, um die Bandbreitenbegrenzung anzupassen.

Es ist nicht möglich, den Namen der Freigabe zu aktualisieren, die Größe zu erhöhen, die IOPS und die Bandbreitenbegrenzung in derselben PATCH /shares Anfrage anzupassen. Stellen Sie separate PATCH /shares Anfragen.

In diesem Beispiel wurde der Bandbreitenwert auf 3.000 Mbps erhöht.

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

Der Status der Dateifreigabe lautet „ updating “, während die Bandbreite angepasst wird. Die voreingestellte Bandbreite wird so lange angezeigt, bis die Aktualisierung abgeschlossen ist.

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

Anpassen der Bandbreitenbegrenzung mit Terraform

Um die IOPS einer Freigabe zu ändern, verwenden Sie die Ressource ibm_is_share. Das folgende Beispiel aktualisiert die Bandbreitenbegrenzung für die Dateifreigabe auf 4.000 Mbit/s, wenn es angewendet wird.

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

Weitere Informationen zu den Argumenten und Attributen finden Sie unter ibm_is_share.