地域ファイル共有の帯域幅制限の調整

可用性の選択新しい地域ファイル共有をプレビューする特別なアクセス権を持つお客様は、 rfs プロファイルを使用して、地域データの可用性と調整可能な帯域幅値を持つファイル共有を作成できます。

rfs プロファイルを使用して、地域別ファイル共有の帯域幅を、読み取りと書き込みの合計スループットにおいて 800 から 8192 Mbps（1024 MBps）に調整します。コンソール、CLI、またはAPIを通じて帯域幅制限を管理します。

この機能を使用すると、コンソール、CLI、またはAPIから、共有の帯域幅制限を増減できます。この属性を変更するには、共有が_利用可能な_状態でなければならない。帯域幅の制限が調整される前に、ユーザーの承認が確認されます。

更新されたファイル共有の請求情報は自動的に更新されます。新価格の日割り計算された差額が現在の請求サイクルに加算されます。その後、次の請求サイクルでは新しい金額全体が請求されます。

コンソールでの帯域幅の調整

すべてのファイル共有のリストにアクセスします。 IBM Cloud コンソールから、 ナビゲーションメニュー> インフラストラクチャ> ストレージ > ファイルストレージ共有をクリックします。
ファイル共有の名前をクリックして、詳細ページを表示します。
Profile セクションを探し、 Editアイコン クリックするか、 Actions メニュー Actionsを使用し、 Edit bandwidthを選択する。
サイドパネルでは、最小値800～最大値8192Mbpsの間でファイル共有帯域幅の制限を指定できます。
月次発注予定概要を確認する。
問題がなければ、**「保存して続行 (Save and continue)」**をクリックします。

CLIからの帯域幅の調整

CLIでは、 ibmcloud is share-update コマンドに --bandwidth オプションを付けて使用し、カスタムプロファイルの新しい帯域幅値を示します。

ibmcloud is share-update share_ID --bandwidth BANDWIDTH

この例では、帯域幅の制限を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

リージョナル可用性を持つファイル共有は、リージョンのすべてのゾーンでデータを提供する。コマンドの応答は、デフォルトでリージョンの最初のゾーンを表示する。

使用可能なコマンドオプションの詳細については ibmcloud is share-update.

APIによる帯域幅の調整

VPC APIを呼び出すことで、既存のデータ共有の帯域幅を調整できます。 PATCH /shares 、 bandwidth パラメータを指定して帯域幅制限を調整する。

共有名の更新、サイズの増加、IOPSの調整、帯域幅制限の調整を、同じ PATCH /shares リクエストで行うことはできません。 PATCH /shares。

この例では、帯域幅の値が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
    }'

帯域幅の調整が行われている間、ファイル共有の状態は「 updating 」と表示されます。プリセット帯域幅は、更新が完了するまで表示される。

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

Terraformで帯域制限を調整する

共有のIOPSを変更するには、 ibm_is_share。次の例を適用すると、ファイル共有の帯域幅制限が4,000 Mbpsに更新されます。

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

引数と属性の詳細については、 ibm_is_share を参照のこと。