管理 File Storage for Classic

透過 IBM Cloud 控制台、命令列介面 (CLI)、API 或 Terraform 管理檔案儲存卷,以授權主機、調整容量與 IOPS,並控制快照和複製功能。

您可以透過 IBM Cloud® 控制台、命令列介面 (CLI)、API 或 Terraform 來管理您的 IBM Cloud® File Storage for Classic 儲存卷。 您可以新增備註、授權運算主機存取您的磁碟區、撤銷存取權,以及在不再需要時刪除磁碟區。 您可以 增加容量、調整 IOPS、 管理快照 和管理 複製。

在主控台中檢視 File Storage for Classic 磁碟區清單

您可以從資源清單檢視您的磁碟區,或前往 File Storage for Classic 磁碟區清單。

  1. 移至 IBM Cloud® 主控台。 從選單中選擇基礎架構VPC 圖示>經典基礎架構。
  2. 點選「儲存空間」> File Storage for Classic。 顯示檔案共用清單。
  3. 您可以按一下篩選器圖示,然後選擇位置或輸入特定容量來篩選清單。 請按「套用」以確認您的選擇。
  4. 從清單中按一下適當的磁區名稱。

您可以點擊「下載 下載圖示」以 CSV 格式下載此清單。

表中顯示關於磁碟區的資訊,例如名稱、位置、狀態、儲存類型、最大 IOPS、容量、使用量、快照容量、開始日期和備註,這些資訊都是可編輯的。

從 CLI 檢視 File Storage for Classic 磁碟區清單

開始之前,請決定您要使用的 CLI 用戶端。

從 IBMCLOUD CLI 檢視磁碟區清單

若要從 IBMCLOUD CLI 取得 File Storage for Classic 的清單,請使用 ibmcloud sl file volume-list 指令。 以下範例會列出位於 dal13 目錄下的所有當前帳戶耐力卷,並按容量進行排序。

ibmcloud sl file volume-list -d dal13 -t endurance --sortby capacity_gb
id          username              datacenter   storage_type             capacity_gb   bytes_used   IOPs   ip_addr                                lunId   active_transactions   rep_partner_count   notes
233039512   IBM02SEV1414935_79    dal13        endurance_file_storage   20            0            -      fsf-dal1303g-fz.adn.networklayer.com   -       0                     1                   -
703233985   IBM02SEV1414935_538   dal13        endurance_file_storage   20            0            -      fsf-dal1303d-fz.adn.networklayer.com   -       0                     0                   -
221349094   IBM02SEV1414935_68    dal13        endurance_file_storage   30            0            -      fsf-dal1302c-fz.adn.networklayer.com   -       0                     1                   Testing

命令輸出會顯示關於磁碟區的資訊,例如磁碟區 ID、磁碟區名稱、位置、儲存類型、容量、使用量、最大 IOPS、IP 位址、lunID, 活動交易計數、複製夥伴計數,以及備註。

如需更多關於此指令所有可用參數的資訊,請參閱 ibmcloud sl file volume-list。

從 SL CLI 檢視磁碟區清單

要從 SL CLI 取得 File Storage for Classic 的清單,請使用 slcli file volume-list 指令。

$ slcli file volume-list --help
Usage: slcli file volume-list [OPTIONS]
        List file storage.
Example::
        slcli file volume-list -d dal10 --storage-type endurance --sortby capacity_gb
┌────┬────────────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ -u │ --username     │ Volume username                                                                                                                                                              │
│ -d │ --datacenter   │ Datacenter shortname                                                                                                                                                         │
│ -o │ --order        │ Filter by ID of the order that purchased the block storage                                                                                                                   │
│    │ --storage-type │ Type of storage volume Choices: performance, endurance                                                                                                                       │
│    │ --sortby       │ Column to sort by                                                                                                                                                            │
│    │ --columns      │ Columns to display. Options: id, username, datacenter, storage_type, capacity_gb, bytes_used, ip_addr, active_transactions, mount_addr, rep_partner_count, created_by, notes │
│ -h │ --help         │ Show this message and exit.                                                                                                                                                  │
└────┴────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

使用 API 檢視 File Storage for Classic 磁碟區清單

若要使用 API 擷取 File Storage for Classic 磁碟區清單,您可以使用 list_file_volumes 方法,並使用參數 datacenter、storage_type (Endurance 或 Performance) 和 order 篩選結果。 該請求會傳回一份包含詳細資訊的檔案卷清單。

您也可以使用類似以下範例的 curl 指令來查詢儲存卷的各個方面。 此範例回傳目前使用的位元組數量。

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/collectBytesUsed'

以下請求會返回磁碟區的最大 IOPS 值。

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/getIops'

如需詳細資訊,請參閱 SoftLayer_Network_Storage API 參考中的文章。

在控制台中更新音量的註解

  1. 移至 IBM Cloud® 主控台。 從功能表中,選取 Infrastructure VPC 圖示 > Classic Infrastructure。
  2. 點選「儲存空間」> File Storage for Classic。
  3. 請找到您要更新的磁碟。 按一下磁碟區名稱,檢視磁碟區詳細資料頁。
  4. 按一下 注意事項 旁邊的 編輯圖示 編輯圖示,然後輸入您的文字。

從 CLI 更新磁碟區的備註

您可以使用 ibmcloud sl call-api 指令新增和修改磁碟區的備註。

$ ibmcloud sl call-api --help
NAME:
  call-api - Call arbitrary API endpoints
USAGE:
  ibmcloud sl call-api SERVICE METHOD [OPTIONS]
OPTIONS:
  --filter value      Object filters
  -h, --help          Usage information.
  --init value        Init parameter
  --limit value       Result limit
  --mask value        Object mask: use to limit fields returned
  --offset value      Result offset
  --output value      Specify output format, only JSON is supported now.
  --parameters value  Append parameters to web call

在 --init 選項中指定音量 ID,並使用 --parameters 選項設定新筆記。 請參閱下列範例:

ibmcloud sl call-api SoftLayer_Network_Storage editObject --init 562193766 --parameters '[{"notes":"Testing."}]'

如需詳細資訊,請參閱 ibmcloud sl call-api。

使用 API 更新卷的筆記

若要使用 API 更新卷上的筆記,您可以進行 POST /SoftLayer_Network_Storage/$VOLUME_ID/editObject.json curl 請求。 以下 API 範例將「Testing」(測試)一詞新增為儲存卷的備註。

curl -u $SL_USER:$SL_APIKEY -X POST -H "Accept: */*" -H "Accept-Encoding: gzip, deflate, compress" -d '{"parameters": [{"notes": "Testing"}]}' 'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/123456789/editObject.json'

另外,您也可以使用 API Python Client 中的 volume_set_note 方法。

授權主機存取 File Storage for Classic

「授權」主機是指被授予存取特定卷的權限的主機。 如果沒有主機授權,則無法從系統中存取或使用儲存空間。 授權主機存取您的磁碟區時,系統會產生使用者名稱和密碼。

您可以授權及連接與儲存空間位於相同資料中心的主機。 您可以有多個帳戶,但無法授權某個帳戶的主機存取您在另一個帳戶上的儲存空間。

您最多可以授權 64 部伺服器存取檔案共用。 此限制包括所有結合的子網路、主機及 IP 授權。 如需增加此限制的相關資訊,請參閱 常見問題。

主機授權後,您可以掛載檔案共用,並為新資料夾結構和檔案指定擁有者。 在 Linux 中,您可以使用 chown 和 chmod 指令為個別使用者和群組指定讀取、寫入和執行權限,從而精細存取控制。 如需詳細資訊,請參閱 Red Hat Linux® 上的安裝 File Storage for Classic,以及 Ubuntu 上的安裝 File Storage for Classic。

授權主機存取File Storage for Classic在控制台中

  1. 移至 IBM Cloud® 主控台。 從選單中選擇基礎架構VPC 圖示>經典基礎架構。

  2. 點選「儲存空間」> File Storage for Classic,然後點選您的「磁碟區名稱」。

  3. 捲動至頁面的授權主機區段。

  4. 按一下右側的授權主機。

  5. 選取裝置類型、子網路或 IP 位址,以過濾可用的主機清單。

    當清單依子網路過濾時,顯示的子網路就是與儲存空間磁區位於相同資料中心內的已訂閱子網路。

  6. 從清單選取一台或多台主機,然後按一下儲存。

授權主機從 CLI 存取 File Storage for Classic

從 IBMCLOUD CLI 授權主機

使用 ibmcloud sl file access-authorize 指令來授權主機存取檔案共用。 下列範例授權虛擬伺服器實例 87654321 裝載檔案共用 12345678。

ibmcloud sl file access-authorize 12345678 --virtual-id 87654321

如需此指令可用的所有參數的相關資訊,請參閱 ibmcloud sl file access-authorize。

從 SLCLI 授權主機

若要授權主機存取磁碟區,您可以使用 slcli file access-authorize 指令。

$ slcli file access-authorize --help
Usage: slcli file access-authorize [OPTIONS] VOLUME_ID
Options:
  -h, --hardware-id TEXT    The ID of one hardware server to authorize.
  -v, --virtual-id TEXT     The ID of one virtual server to authorize.
  -i, --ip-address-id TEXT  The ID of one IP address to authorize.
  -p, --ip-address TEXT     An IP address to authorize.
  -s, --subnet-id TEXT      An ID of one subnet to authorize.
  --help                    Show this message and exit.

授權主機使用 API 存取 File Storage for Classic

若要授權主機存取您的檔案卷,您可以使用 API Python Client 中的 authorize_host_to_volume 方法。 您必須透過提供下列參數之一來指定 volume_id 和運算主機:hardware_ids (針對裸機伺服器)、virtual_guest_ids (針對虛擬伺服器實體)、ip_address_ids, subnet_ids。請求會傳回一個可存取指定卷的 SoftLayer_Network_Storage_Allowed_Host 物件陣列。

使用 Terraform 授權主機

若要授權計算主機存取共用,請使用 ibm_storage_file 資源並指定 allowed_virtual_guest_ids (若為虛擬伺服器) 或 allowed_hardware_ids (若為裸機伺服器)。 指定 allowed_ip_addresses 以定義哪些 IP 位址可以存取儲存體。

下列範例定義 ID 為 28961689 的虛擬伺服器可以從 10.146.139.64/26 子網路及 10.146.139.84 位址存取磁區。

resource "ibm_storage_file" "fs_endurance" {
  type       = "Endurance"
  datacenter = "dal09"
  capacity   = 20
  iops       = 0.25
  allowed_virtual_guest_ids = ["28961689"]
  allowed_subnets           = ["10.146.139.64/26"]
  allowed_ip_addresses      = ["10.146.139.84"]
  snapshot_capacity         = 10
  hourly_billing            = true
}

建立儲存體資源之後,您可以存取 hostname 及 volumename 屬性,稍後可使用這些屬性來決定裝載目標。 例如,hostname 引數設為 nfsdal0901a.service.softlayer.com 且 volumename 引數設為 IBM01SV278685_7 的 File Storage 資源具有裝載點 nfsdal0901a.service.softlayer.com:-IBM01SV278685_7。

如需引數及屬性的相關資訊,請參閱 ibm_storage_file。

在控制台中檢視獲授權存取 File Storage for Classic 卷的主機清單

  1. 移至 IBM Cloud® 主控台。 從選單中選擇基礎架構VPC 圖示>經典基礎架構。
  2. 點選「儲存空間」> File Storage for Classic,然後點選您的「磁碟區名稱」。
  3. 按一下 授權主機,以顯示可存取檔案共用的計算實例。
  4. 點擊省略號操作圖示 並選擇查看主機詳細資料。 側面板會顯示裝置名稱、IP 位址、使用者名稱和密碼等詳細資訊。 也會顯示存取控制清單部分。 在存取控制清單部分,您可以新增或移除子網路。

「目標」位址列在儲存空間詳細資料頁面。 若為 NFS,「目標」位址會描述為 DNS 名稱,若為 iSCSI,它是「探索目標入口網站」的 IP 位址。

透過 CLI 檢視獲授權存取 File Storage for Classic 卷的宿主清單

從 IBMCLOUD CLI 檢視授權主機清單

您可以使用 ibmcloud sl file access-list 指令來列出授權存取檔案共用的主機。 下列範例列出可以裝載檔案共用 12345678 並依其 ID 排序的主機。

ibmcloud sl file access-list 12345678 --sortby id

如需此指令可用的所有參數的相關資訊,請參閱 ibmcloud sl file access-list。

從 SLCLI 檢視授權主機清單

若要顯示授權主機的清單,您可以使用下列指令。

$ slcli file access-list --help
Usage: slcli file access-list [OPTIONS] VOLUME_ID
Options:
 --sortby TEXT   Column to sort by
 --columns TEXT  Columns to display. Options: id, name, type,
                 private_ip_address, source_subnet, host_iqn, username,
                 password, allowed_host_id
 -h, --help      Show this message and exit.

查看File Storage for Classic主機在控制台中被授權存取的捲

您可以檢視主機可存取的儲存卷,其中包括建立連線所需資訊——儲存卷名稱、儲存類型、目標位址、容量及位置。

  1. 移至 IBM Cloud® 主控台。
  2. 從選單中選擇基礎架構VPC 圖示>經典基礎架構。
  3. 按一下「裝置」>「裝置清單」。
  4. 按一下適當的裝置。
  5. 選取「儲存空間」標籤。

您會看到此特定主機可存取的儲存空間磁區清單,這些儲存空間磁區全部是依儲存空間類型(區塊、檔案、其他)分組。 從個別的動作功能表中,您可以授權更多的儲存空間或移除存取權。

撤銷主機的存取權限File Storage for Classic在控制台中

如果您要停止主機對特定儲存空間磁區的存取權,則可以撤銷存取權。 撤銷存取權時,會從磁區中捨棄主機連線。 作業系統及應用程式無法再與磁區通訊。

若要避免主機端問題,請先從您的作業系統卸載儲存空間磁區,然後再撤銷存取權,以避免遺漏磁碟機或資料毀損。

您可以從「裝置清單」中的「儲存空間」或從「儲存空間」視圖中,撤銷存取權。

從控制台中的裝置清單撤銷存取權限

  1. 移至 IBM Cloud® 主控台。
  2. 從選單中選擇基礎架構VPC 圖示>經典基礎架構。
  3. 按一下「裝置」>「裝置清單」。
  4. 按兩下適當的裝置。
  5. 選取儲存空間標籤。
  6. 您會看到此特定主機可存取的儲存空間磁區清單,這些儲存空間磁區全部是依儲存空間類型(區塊、檔案、其他)分組。 選取您要撤銷其存取權之磁區旁的個別動作功能表,然後按一下撤銷存取權。
  7. 請確認您是否要撤銷磁區的存取權,因為此動作無法復原。 按一下是來撤銷磁區存取權,或按一下否來取消動作。

如果您要中斷多個磁區與特定主機的連線,則需要對每個磁區重複「撤銷存取權」動作。

從控制台中的儲存視圖撤銷存取權限

  1. 移至 IBM Cloud® 主控台。
  2. 從選單中選擇基礎架構VPC 圖示>經典基礎架構。
  3. 點選「儲存空間」> File Storage for Classic,然後選取您要撤銷存取權限的卷。
  4. 按一下 授權主機,以顯示可存取檔案共用的計算實例。
  5. 點擊要撤銷其存取權限的主機旁邊的「動作 「動作」圖示」,然後選擇「撤銷存取權限」。
  6. 請確認您是否要撤銷磁區的存取權,因為此動作無法復原。 按一下是來撤銷磁區存取權,或按一下否來取消動作。

如果您要中斷多個主機與特定磁區的連線,則需要對每個主機重複「撤銷存取權」動作。

從 CLI 撤銷主機對 File Storage for Classic 的存取權

撤銷 IBMCLOUD CLI 的主機授權

您可以使用 ibmcloud sl file access-revoke 指令,從主機移除授權。 下列指令禁止虛擬伺服器實例 87654321 裝載檔案共用 12345678。

ibmcloud sl file access-revoke 12345678 --virtual-id 87654321

如需此指令可用的所有參數的相關資訊,請參閱 ibmcloud sl file access-revoke。

撤銷 SLCLI 的主機授權

您可以在 SLCLI 中使用下列指令。

$ slcli file access-revoke --help
Usage: slcli file access-revoke [OPTIONS] VOLUME_ID
Options:
  -h, --hardware-id TEXT    The ID of one hardware server to revoke authorization.
  -v, --virtual-id TEXT     The ID of one virtual server to revoke authorization.
  -i, --ip-address-id TEXT  The ID of one IP address to revoke authorization.
  -p, --ip-address TEXT     An IP address to revoke authorization.
  -s, --subnet-id TEXT      An ID of one subnet to revoke authorization.
  --help                    Show this message and exit.

如果您要中斷多個主機與特定磁區的連線,則需要對每個主機重複「撤銷存取權」動作。

使用 API 撤銷主機存取 File Storage for Classic 的權限

若要撤銷主機存取檔案卷的授權,您可以使用 API Python Client 中的 deauthorize_host_to_volume 方法。 您必須透過提供下列參數之一來指定 volume_id 和運算主機:hardware_ids (針對裸機伺服器)、virtual_guest_ids (針對虛擬伺服器實體)、ip_address_ids, subnet_ids。該請求會返回一個 SoftLayer_Network_Storage_Allowed_Host 物件的陣列,該陣列具有指定卷的存取權,因此您可以確認所請求的計算主機已被移除。

刪除儲存卷

在刪除卷之前,請先完成 刪除前檢查清單,以確認該卷未被使用,且您已了解資源回收的時間表。

有關在控制台、CLI、API 和 Terraform 中逐步刪除的說明,請參閱《 停用並刪除 File Storage for Classic 儲存卷 》。