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

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

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

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

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

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

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

• 您可以安裝 IBM Cloud CLI，並使用 ibmcloud plugin install sl 來安裝 SL 外掛程式。 如需相關資訊，請參閱 使用外掛程式延伸 IBM Cloud CLI。
• 或者，您可以安裝 SLCLI。

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

$ 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 > 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 卷宗的主機清單

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

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

透過命令列介面 (CLI) 檢視獲授權存取 File Storage for Classic 卷宗的主機清單

ibmcloud sl file access-list 12345678 --sortby id

$ 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. 從選單中選擇基礎架構>經典基礎架構。
3. 按一下裝置 > 裝置清單。
4. 按一下適當的裝置。
5. 選取「儲存空間」標籤。

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

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

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

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

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

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

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

$ 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 物件的陣列，該陣列具有指定卷的存取權，因此您可以確認所請求的計算主機已被移除。

在控制台中刪除儲存卷

如果您不再需要某個特定磁碟區，可以刪除該檔案共用。 若要取消儲存空間磁區，您需要先撤銷任何主機的存取權。

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

2. 按一下儲存空間 > File Storage for Classic。

3. 針對要取消的磁區按一下 動作 ，然後選取 刪除 File Storage for Classic。

4. 請確認您是要立即刪除此卷，還是等到該卷的配置週年日再刪除。

   如果您選取在磁區週年日取消磁區的選項，則可以在其週年日之前讓取消要求失效。

5. 按一下繼續或關閉。

6. 勾選確認方塊，然後按一下「確認」。

取消磁區時，要求後面會接著 24 小時收回等待期間。 在那 24 小時內，您仍可以在主控台看到磁區。 該流量的計費將立即停止。 收回期間到期時，會破壞資料，並且也會從主控台移除磁區。 如需相關資訊，請參閱常見問題。

活躍的複本和依賴的複本可能會阻礙儲存卷的回收。 在嘗試刪除原始卷之前，請務必確認該卷已不再掛載、主機授權已撤銷、複製作業已取消，且不存在任何依賴的副本。

從 CLI 刪除儲存空間磁區

取消磁區時，要求後面會接著 24 小時收回等待期間。 在那 24 小時內，您仍可以在主控台看到磁區。 該流量的計費將立即停止。 收回期間到期時，會破壞資料，並且也會從主控台移除磁區。 如需相關資訊，請參閱常見問題。

活躍的複本和依賴的複本可能會阻礙儲存卷的回收。 在嘗試刪除原始卷之前，請務必確認該卷已不再掛載、主機授權已撤銷、複製作業已取消，且不存在任何依賴的副本。

ibmcloud sl file volume-cancel 12345678 --immediate -f

$ slcli file volume-cancel --help
Usage: slcli file volume-cancel [OPTIONS] VOLUME_ID

Options:
  --reason TEXT  An optional reason for cancellation.
  --immediate    Cancels the File Storage volume immediately instead of on the
                 billing anniversary.
  -h, --help     Show this message and exit.

使用 API 刪除儲存磁碟區

取消磁區時，要求後面會接著 24 小時收回等待期間。 在那 24 小時內，您仍可以在主控台看到磁區。 該流量的計費將立即停止。 收回期間到期時，會破壞資料，並且也會從主控台移除磁區。 如需相關資訊，請參閱常見問題。

活躍的複本和依賴的複本可能會阻礙儲存卷的回收。 在嘗試刪除原始卷之前，請務必確認該卷已不再掛載、主機授權已撤銷、複製作業已取消，且不存在任何依賴的副本。

然後，您可以在 API Python Client 中使用 cancel_volume 方法。 請指定「volume_id」，並選擇要立即取消訂閱，還是等到週年日再取消（immediate=False 或 immediate=True ）。此外，您也可以選擇提供取消的原因（reason='No longer needed' ）。

使用 Terraform 刪除儲存磁區

使用 terraform destroy 指令可方便地移除遠端物件，例如單一檔案共用。 以下範例取消 ID 為 ibm_file_share.example.id 的檔案共用。

terraform destroy --target ibm_file_share.example.id

如需相關資訊，請參閱 terraform destroy。

取消磁區時，要求後面會接著 24 小時收回等待期間。 在那 24 小時內，您仍可以在主控台看到磁區。 該流量的計費將立即停止。 收回期間到期時，會破壞資料，並且也會從主控台移除磁區。 如需相關資訊，請參閱常見問題。

活躍的複本和依賴的複本可能會阻礙儲存卷的回收。 在嘗試刪除原始卷之前，請務必確認該卷已不再掛載、主機授權已撤銷、複製作業已取消，且不存在任何依賴的副本。