調整區域檔案共用的頻寬限制

選擇可用性 具有預覽新區域檔案共用產品特殊存取權限的客戶,可以使用 rfs 設定檔建立具有區域資料可用性和可調整頻寬值的檔案共用。

使用 rfs 設定檔,將區域性檔案共用空間的頻寬調整為 800 至 8192 Mbps(1024 MBps),以實現讀寫合併吞吐量。 透過控制台、命令列介面 (CLI) 或 API 管理頻寬限制。

使用此功能,您可以在主控台、CLI 或 API 中增加或減少共用的頻寬限制。 若要變更此屬性,共用必須處於_可用_狀態。 在調整頻寬限制之前,會先確認您的使用者授權。

更新檔案共用的計費會自動更新。 新價格按比例計算的差額會加入當前的帳單週期。 然後在下一個計費週期計算完整的新金額。

在控制台中調整頻寬

  1. 前往所有檔案共用的清單。 從 IBM Cloud 控制台中,按一下導覽功能表圖示> 基礎架構VPC 圖示> 儲存 > 檔案儲存共用
  2. 按一下檔案共用的名稱,以查看詳細資料頁面。
  3. 找到 Profile 區段,然後按一下 Edit 圖示 Edit 圖示,或使用 Actions 功能表 Actions 圖示,然後選擇 Edit bandwidth
  4. 在側面板中,您可以在最小值 800 和最大值 8192 Mbps 之間指定檔案共用頻寬限制。
  5. 檢視估計每月訂單摘要。
  6. 如果您滿意,請按一下儲存並繼續

從 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 參數來調整頻寬限制。

您無法在同一個 PATCH /shares 請求中更新共用名稱、增加大小、調整 IOPS 以及調整頻寬限制。 分別提出 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。