使用 Block Storage for Classic 服務 (ibmcloud sl block)
IBM Cloud® Block Storage for Classic 是一種持久性、高效能的 iSCSI 儲存,可獨立於運算實體進行配置與管理。iSCSI-based Block Storage for Classic LUN 透過備援多路徑 I/O (MPIO) 連線連接至授權裝置。
如需 Block Storage for Classic 的相關資訊,請參閱 Block Storage for Classic 文件。
從 IBM Cloud 指令行介面使用下列指令來管理 IBM Cloud 標準基礎架構 Block Storage for Classic 服務的磁區。
ibmcloud sl block access-list
列出獲授權存取磁區的主機。
標記為 'IN ACL' 的存取主機屬於具有相同 allowed_host_id 的父存取主機。 範例:
ibmcloud sl block access-list 12345678 --sortby id 此指令列出所有授權存取 ID 為 12345678 的磁碟區的主機,並依 ID 排序。
ibmcloud sl block access-list IDENTIFIER [flags]
指令選項:
- --column
- 要顯示的直欄。 選項包含:id、name、type、private_ip_address、source_subnet、host_iqn、username、password、allowed_host_id。
- --sortby
- 要排序的直欄。 選項包含:id、name、type、private_ip_address、source_subnet、host_iqn、username、password、allowed_host_id。
ibmcloud sl block access-password
變更磁區存取權的密碼。
ibmcloud sl block access-password ACCESS_ID --password PASSWORD
ACCESS_ID is the allowed_host_id from 'ibmcloud sl block access-list'
ibmcloud sl block access-password IDENTIFIER
指令選項:
- --p,密碼
- 您要設定的密碼,如果密碼不強,此指令會失敗。[required]
ibmcloud sl block access-revoke
撤銷存取特定磁區之主機的授權。
範例:
ibmcloud sl block access-revoke 12345678 --virtual-id 87654321 此指令撤銷 ID 為 87654321 的虛擬伺服器對 ID 為 12345678 的磁碟區的存取權限。
ibmcloud sl block access-revoke 5555 --subnet-id 1111 此指令會將 ID 為 1111 的子網路從 ID 為 5555 的 Allowed Host 移除。 使用「access-list」來尋找這個 id。
ibmcloud sl block access-revoke IDENTIFIER [flags]
指令選項:
- --d,硬體-ID
- 要撤銷的某部硬體伺服器的 ID
- --p, ip 地址
- 要撤銷的 IP 位址
- --i, ip-address-id
- 要撤銷的某個 IP 位址的 ID
- --s,子網路-ID
- A 子網路 ID。 使用此選項,IDENTIFIER 應該是 access-list 指令中的「allowed_host_id」。
- --v 虛擬 ID
- 要撤銷的某部虛擬伺服器的 ID
ibmcloud sl 區塊災難復原-故障移轉
將無法存取的磁區失效接手至其可用的抄本磁區。
如果卷(具有複製功能)因災難事件而無法存取,此方法可用於立即 故障移轉至另一位置的可用複製。 此方法不允許透過 API 進行失效回復。 使用此方法後,若要失敗回到原始磁碟區,請開啟支援票單。 若要測試故障移轉,請改用「ibmcloud sl block replica-failover」。
範例:
ibmcloud sl block disaster-recovery-failover 12345678 87654321
This command performs failover operation for volume with ID 12345678 to replica volume with ID 87654321.
ibmcloud sl block disaster-recovery-failover IDENTIFIER REPLICA_ID
ibmcloud sl 區塊複製-轉換-狀態
取得給定區塊儲存體重複磁區的分割或移動已完成百分比狀態。
ibmcloud sl block duplicate-convert-status IDENTIFIER
ibmcloud sl 區塊物件清單
列出雲端區塊儲存體。
ibmcloud sl block object-list
ibmcloud sl block object-storage-detail
顯示雲端物件儲存體的詳細資料。
ibmcloud sl block object-storage-detail IDENTIFIER
ibmcloud sl block object-storage-permission
顯示雲端物件儲存體的許可權詳細資料。
ibmcloud sl block object-storage-permission IDENTIFIER
ibmcloud sl block replica-failback
從抄本進行區塊磁區失效回復
ibmcloud sl block replica-failback VOLUME_ID
範例:
ibmcloud sl block replica-failback 12345678 這個指令會對 ID 為 12345678 的磁區執行失效回復作業。
ibmcloud sl block replica-failback IDENTIFIER
ibmcloud sl block replica-failover
將區塊磁區失效接手至給定的抄本磁區
範例:
ibmcloud sl block replica-failover 12345678 87654321 此指令將 ID 為 12345678 的磁碟區執行故障移轉作業至 ID 為 87654321 的複製磁碟區。
ibmcloud sl block replica-failover IDENTIFIER REPLICA_ID
ibmcloud sl block replica-locations
列出給定磁區的適合抄寫資料中心
範例:
ibmcloud sl block replica-locations 12345678 這個指令會列出 ID 為 12345678 之區塊磁區的適當抄寫資料中心。
ibmcloud sl block replica-locations IDENTIFIER
ibmcloud sl block replica-order
訂購區塊儲存空間抄本磁區
範例:
ibmcloud sl block replica-order 12345678 -s DAILY -d dal09 --tier 4 --os-type LINUX 此指令為 ID 為 12345678 的磁碟區訂製複製品,該磁碟區執行 DAILY 複製,位於 dal09,層級為 4,作業系統類型為 Linux。
ibmcloud sl block replica-order IDENTIFIER [flags]
指令選項:
- --d 資料中心
- 抄本資料中心的簡稱。 例如,dal09 [要求]
- --f 力
- 強制執行作業,而不進行確認
- --i、iops
- 效能儲存空間 IOPs,此值為 100 的倍數,介於 100 與 6000 之間,如果未指定 IOPS 值,將會使用原始磁區的 IOPS 值
- --o、OS 型
- [訂購]副本的主要磁碟區的作業系統類型 (例如:LINUX):HYPER_V,LINUX,VMWARE,WINDOWS_2008,windows_gpt,windows,xen
- --s,快照排程
- 要用於抄寫的 Snapshot 排程。 選項有:每小時、每日、每週所[需的]時間
- --t 層級
- 主卷的耐久性儲存層級(每 GB IOPS),副本是為其訂購[的],可選,選項如下:0.25,2,4,10,if 未指定層級,將使用原始卷的層級
ibmcloud sl block replica-partners
列出區塊磁區的現有抄本磁區
範例:
ibmcloud sl block replica-partners 12345678 這個指令會列出 ID 為 12345678 之區塊磁區的現有抄本磁區。
ibmcloud sl block replica-partners IDENTIFIER
ibmcloud sl block snapshot-cancel
取消給定磁區的現有 Snapshot 空間
範例:
ibmcloud sl block snapshot-cancel 12345678 --immediate -f此指令立即取消 ID 為 12345678 的快照,而不要求確認。
ibmcloud sl block snapshot-cancel IDENTIFIER [flags]
指令選項:
- --f 力
- 強制執行作業,而不進行確認
- --immediate
- 立即取消 Snapshot 空間,而不是在計費週年日取消
- --reason
- 選用的取消理由
ibmcloud sl block snapshot-create
在給定的磁區上建立 Snapshot
ibmcloud sl block snapshot-create VOLUME_ID [OPTIONS]
範例:
ibmcloud sl block snapshot-create 12345678 --note snapshotforibmcloud 此指令為 ID 為 12345678 的磁碟區建立快照,附加註解為 snapshotforibmcloud。
ibmcloud sl block snapshot-create IDENTIFIER [flags]
指令選項:
- --n 注意
- 要設定於新 Snapshot 的附註
ibmcloud sl block snapshot-delete
在給定的磁區上刪除 Snapshot
ibmcloud sl block snapshot-delete IDENTIFIER
ibmcloud sl block snapshot-disable
依給定磁區的指定排程停用 Snapshot
ibmcloud sl block snapshot-disable VOLUME_ID [OPTIONS]
範例:
ibmcloud sl block snapshot-disable 12345678 -s DAILY 此指令停用 ID 為 12345678 的磁碟區的每日快照。
ibmcloud sl block snapshot-disable IDENTIFIER [flags]
指令選項:
- --s,時間表類型
- [需要]快照排程,選項有每小時、每天、每週
ibmcloud sl block snapshot-enable
依指定的排程為給定的磁區啟用 Snapshot
有關這些選項的更多詳細信息,請參閱https://sldn.softlayer.com/reference/services/SoftLayer_Network_Storage/enableSnapshots/。 範例:
ibmcloud sl block snapshot-enable 12345678 -s WEEKLY -c 5 -m 0 --hour 2 -d 0 此指令啟用 ID 為 12345678 的磁碟區的快照,每週日 2:00 拍攝快照,最多保留 5 張快照。
ibmcloud sl block snapshot-enable IDENTIFIER [flags]
指令選項:
- --d,週日
- 應該在星期幾擷取 Snapshot,0 到 6 之間的整數。 0 表示 Sunday,1 表示 Monday,2 表示 Tuesday,3 表示 Wendesday,4 表示 Thursday,5 表示 Friday,6 表示星期六
- --r 小時
- 應該在幾點擷取 Snapshot,選項為 0 到 23 之間的整數
- --m 分鐘
- 應該在幾分擷取 Snapshot,選項為 0 到 59 之間的整數
- --c,保留數
- 要保留的快照數量
- --s,時間表類型
- 快照計劃,選項有:INTERVAL、HOURLY、DAILY、WEEKLY
ibmcloud sl block snapshot-get-notification-status
取得給定磁區的 Snapshot 空間使用情形臨界值警告旗標設定。
ibmcloud sl block snapshot-get-notification-status IDENTIFIER
ibmcloud sl block snapshot-list
列出區塊儲存空間 Snapshot
範例:
ibmcloud sl block snapshot-list 12345678 --sortby id 此指令會列出 ID 為 12345678 的磁碟區所有快照,並依 ID 排序。
ibmcloud sl block snapshot-list IDENTIFIER [flags]
指令選項:
- --sortby
- 要排序的直欄。 選項包含:id、name、created、size_bytes
ibmcloud sl block snapshot-order
訂購用於區塊儲存磁區的 Snapshot 空間
請參閱https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-getting-started以了解調整選項。 ibmcloud sl block volume-options' 來取得可用的選項。
範例:
ibmcloud sl block snapshot-order 12345678 -s 1000 -t 4 此指令為 ID 為 12345678 的磁碟區訂購快照空間,大小為 1000GB,層級為每 GB 4 IOPS。
ibmcloud sl block snapshot-order IDENTIFIER [flags]
指令選項:
- --f 力
- 強制執行作業,而不進行確認
- --i、iops
- 效能儲存空間 IOPs,此值為 100 的倍數,介於 100 與 6000 之間
- --s 尺寸
- 要建立的快照空間大小 (GB)
- --t 層級
- 訂購空間的區塊卷的耐久性儲存層級 (IOPS per GB) 為[選項],選項如下:0.25,2,4,10
- --u 升級
- 標示旗標,以指出訂單為升級
ibmcloud sl block snapshot-restore
使用給定的 Snapshot 還原區塊磁區
範例:
ibmcloud sl block snapshot-restore 12345678 87654321 這個指令會從 ID 為 87654321 的 Snapshot 還原 ID 為 12345678 的磁區。
ibmcloud sl block snapshot-restore IDENTIFIER SNAPSHOT_ID
ibmcloud sl block snapshot-schedule-list
列出給定磁區的 Snapshot 排程
ibmcloud sl block snapshot-schedule-list IDENTIFIER
ibmcloud sl 區塊快照設定通知
啟用/停用給定磁區的 Snapshot 空間使用情形臨界值警告。
ibmcloud sl block snapshot-set-notification IDENTIFIER [flags]
指令選項:
- --disable
- 停用 Snapshot 通知。
- --enable
- 啟用 Snapshot 通知。
ibmcloud sl block subnets-assign
將區塊儲存空間子網路指派給給定的主機 ID。
access_id 是透過以下方式取得的 host_id:sl block access-list volume_id SoftLayer_Account::iscsiisolationdisabled必須為 False 才能使用此指令 ibmcloud sl blocknets-assign ACCESS_ID[選項]
範例:
--subnet-id--subnet-id--subnet-id
ibmcloud sl block subnets-assign IDENTIFIER [flags]
指令選項:
- --subnet-id
- 要指派的子網路 ID;例如:--subnet-id 1234
ibmcloud sl block subnets-list
列出給定主機 ID 的區塊儲存空間指派的子網路。
access_id 是由下列取得的 host_id: sl block access-list volume_id ibmcloud sl block subnets-list ACCESS_ID [OPTIONS]
範例:
ibmcloud sl block subnets-list 12345678 ACCESS_ID 是由 ibmcloud sl block access-list volume_id 取得的 host_id
ibmcloud sl block subnets-list IDENTIFIER
ibmcloud sl block subnets-remove
移除給定主機 ID 的區塊儲存空間子網路。
access_id 是透過以下方式取得的 host_id:sl block access-list volume_id SoftLayer_Account::iscsiisolationdisabled必須為 False 才能使用此指令 ibmcloud sl blocknets-remove ACCESS_ID [OPTIONS]
範例:
--subnet-id--subnet-id--subnet-id
ibmcloud sl block subnets-remove IDENTIFIER [flags]
指令選項:
- --subnet-id
- 要移除的子網路 ID
ibmcloud sl block volume-cancel
取消現有的區塊儲存磁區
ibmcloud sl block volume-cancel VOLUME_ID [OPTIONS]
範例:
ibmcloud sl block volume-cancel 12345678 --immediate -f此指令立即取消 ID 為 12345678 的捲,而不要求確認。
ibmcloud sl block volume-cancel IDENTIFIER [flags]
指令選項:
- --f 力
- 強制執行作業,而不進行確認
- --immediate
- 立即取消區塊儲存磁區,而不是在計費週年日取消
- --reason
- 選用的取消理由
ibmcloud sl block volume-convert
將相依重複磁區轉換為獨立磁區。
ibmcloud sl block volume-convert IDENTIFIER
ibmcloud sl block volume-count
列出每個資料中心的區塊儲存磁區數目
ibmcloud sl block volume-count [flags]
指令選項:
- --d 資料中心
- 依資料中心簡稱過濾
- --s,排序依據
- 直欄排序方式
ibmcloud sl block volume-detail
顯示指定磁區的詳細資料
ibmcloud sl block volume-detail IDENTIFIER
ibmcloud sl block volume-duplicate
複製現有磁區,以訂購區塊磁區
ibmcloud sl block volume-duplicate VOLUME_ID [OPTIONS]
範例:
ibmcloud sl block volume-duplicate 12345678 這個指令會顯示透過複製 ID 為 12345678 的磁區來訂購新磁區。
ibmcloud sl block volume-duplicate IDENTIFIER [flags]
指令選項:
- --billing
- 計費費率的選用參數(預設為每月) 選項:每小時或每月
- --d,依賴重複
- 此複製是否為原始磁碟區的依附複製 [:假]
- --i,複製-iops
- 效能儲存空間 IOPS,以 100 的倍數為 100 到 6000 之間,如果未指定 IOPS 值,將會使用原始磁區的 IOPS 值需求: [如果原始磁區的 IOPS/GB 小於 0.3,則副本的 IOPS/GB 也必須小於 0.3。 如果原始卷的 IOPS/GB 大於或等於 0.3,複製卷的 IOPS/GB 也必須大於或等於 0.3。]
- --s,重複大小
- 重複區塊磁區的大小 (GB),如果未指定大小,則會使用原始磁區的大小「潛在大小」: [20、40、80、100、250、500、1000、2000、4000、8000、12000] 最小值: [原始磁區的大小]
- --n 複製快照大小
- 要為副本訂購的 Snapshot 空間大小,如果未指定 Snapshot 空間大小,則會針對此參數使用原始磁區的 Snapshot 空間大小輸入
0,以訂購沒有 Snapshot 空間的重複磁區。 - --t,複製層
- Endurance Storage Tier(耐久性儲存層),如果未指定層級,則使用原始磁碟區的層級 需求:[如果原始磁碟區的 IOPS/GB 為 0.25,複製磁碟區的 IOPS/GB 也必須為 0.25。 如果原始卷的 IOPS/GB 大於 0.25,複製卷的 IOPS/GB 也必須大於 0.25。] 選項:0.25、2、4、10
- --f 力
- 強制執行作業,而不進行確認
- --o, origin-snapshot-id
- 要用於複製的原始磁區 Snapshot 的 ID
ibmcloud sl 區塊容量限制
列出此帳戶的每個資料中心的儲存空間限制。
ibmcloud sl block volume-limits [OPTIONS]
範例:
ibmcloud sl block volume-limits
This command lists the storage limits per datacenter for this account.
ibmcloud sl block volume-limits
ibmcloud sl block volume-list
列出區塊儲存空間
ibmcloud sl block volume-list [OPTIONS]
範例:
ibmcloud sl block volume-list -d dal09 -t 耐久性 --sortby capacity_gb 此指令會列出目前帳戶中位於 dal09 的所有耐久卷,並依容量排序。
ibmcloud sl block volume-list [flags]
指令選項:
- --column
- 要顯示的直欄。 選項為:id、username、datacenter、storage_type、capacity_gb、bytes_used、IOPS、ip_addr、lunId、created_by、active_transactions、rep_partner_count、notes。 這個選項可以多次指定
- --d 資料中心
- 依資料中心簡稱過濾
- --n,註釋
- 依附註過濾
- --o,訂單
- 依購買區塊儲存空間的訂單 ID 過濾
- --sortby
- 直欄排序方式,預設值為:id,選項包含:id、username、datacenter、storage_type、capacity_gb、bytes_used、ip_addr、lunId、active_transactions、created_by
- --t 儲存類型
- 依儲存磁區的類型過濾,選項包含:performance、endurance
- --u 使用者名稱
- 依磁區使用者名稱過濾
ibmcloud sl block volume-modify
修改現有的區塊儲存磁區
可在此找到有效的大小和 iops 選項: https://cloud.ibm.com/docs/BlockStorage/index.html#provisioning-considerations https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-orderingBlockStorage&interface=cli
範例:
ibmcloud sl block volume-modify 12345678 --new-size 1000 --new-iops 4000
This command modify a volume 12345678 with size is 1000GB, IOPS is 4000.
ibmcloud sl block volume-modify 12345678 --new-size 500 --new-tier 4
This command modify a volume 12345678 with size is 500GB, tier level is 4 IOPS per GB.
ibmcloud sl block volume-modify IDENTIFIER [flags]
指令選項:
- --f 力
- 強制執行作業,而不進行確認
- --i, new-iops
- 效能儲存 IOPS,介於 100 和 6000 之間,以 100 的倍數表示,[僅適用於效能磁碟區] 如果未指定 IOPS 值,則將使用磁碟區的原始 IOPS 值。
- --c,新尺寸
- 區塊磁區的新大小(以 GB 為單位)。 如果未給出大小,則使用卷的原始大小。 潛在尺寸:[20、40、80、100、250、500、1000、2000、4000、8000、12000] 最小值:[卷的原始大小]
- --t,新階層
- 耐久性儲存層級 (IOPS per GB) [僅適用於耐久性磁碟區] 如果未指定層級,則將使用磁碟區的原始層級。 層級:[0.25, 2, 4, 10]
ibmcloud sl block volume-options
列出排序區塊或檔案儲存容量的所有選項
列出排序區塊或檔案儲存容量的所有選項
另請參閱: https://cloud.ibm.com/docs/BlockStorage/index.html#provisioning-considerations https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-orderingBlockStorage&interface=cli
ibmcloud sl block volume-options [flags]
指令選項:
- --prices
- 顯示儲存體、Snapshot 及 iops 範圍表格中的價格。
ibmcloud sl block volume-order
訂購區塊儲存磁區
範例:
ibmcloud sl block volume-order --storage-type performance --size 1000 --iops 4000 --os-type LINUX -d。dal09 此指令命令一個效能卷,大小為 1000GB,IOPS 為 4000,作業系統類型為 LINUX,位於 dal09。ibmcloud sl block volume-order --storage-type endurance --size 500 --tier 4 --os-type XEN -d dal09 --snapshot-size 500 此指令訂購耐久卷,大小為 500GB,層級為每 GB 4 IOPS,作業系統類型為 XEN,位於 dal09,附加快照空間大小為 500GB。
ibmcloud sl block volume-order [flags]
指令選項:
- --b 帳單
- 計費費率的選用性參數(預設為 monthly),選項包含:hourly、monthly
- --d 資料中心
- [必須填寫]資料中心簡稱
- --f 力
- 強制執行作業,而不進行確認
- --i、iops
- 效能[儲存類效能所需的]儲存 IOP 在 100 到 6000 之間,以 100 的倍數計算
- --o、OS 型
- [需要]作業系統,選項有 HYPER_V,LINUX,VMWARE,WINDOWS_2008,windows_gpt,windows,xen
- --s 尺寸
- [所需的]儲存容量大小 (GB)
- --n 快照大小
- 隨耐久性區塊儲存空間訂購 Snapshot 空間的選用參數;指定要訂購的 Snapshot 空間大小(以 GB 為單位)
- --t 儲存類型
- [所需的]儲存容量類型,選項為:效能、耐久性
- --e 層級
- 耐久性 儲存[類型耐久性所需的]儲存層級 (IOP 每 GB),選項為:0.25,2,4,10
ibmcloud sl block volume-refresh
以來自母項的 Snapshot 重新整理重複磁區。
使用來自其母項的 Snapshot 來重新整理重複磁區。ibmcloud sl block volume-refresh VOLUME_ID SNAPSHOT_ID
範例:
ibmcloud sl block volume-refresh VOLUME_ID SNAPSHOT_ID
Refresh a duplicate VOLUME_ID with a snapshot from its parent SNAPSHOT_ID.
ibmcloud sl block volume-refresh IDENTIFIER SNAPSHOT_ID [flags]
指令選項:
- --f,強制刷新
- 強制磁區重新整理,將取消任何進行中的交易。
ibmcloud sl block volume-set-lun-id
在現有的區塊儲存磁區上設定 LUN ID
在現有區塊儲存空間磁區 ibmcloud sl block volume-set-lun-id VOLUME_ID LUN_ID 上設定 LUN ID
The LUN ID only takes effect during the Host Authorization process. It is
recommended (but not necessary) to de-authorize all hosts before using
this method. See "block access-revoke".
VOLUME_ID - the volume ID on which to set the LUN ID
LUN_ID - recommended range is an integer between 0 and 255. Advanced users
can use an integer between 0 and 4095
ibmcloud sl block volume-set-lun-id IDENTIFIER LUN_ID
ibmcloud sl block volume-set-note
設定現有區塊儲存磁區的附註。
設定現有區塊儲存空間磁區的附註。ibmcloud sl block volume-set-note [OPTIONS] VOLUME_ID
範例:
ibmcloud sl block volume-set-note 12345678 --note '這是我的註解'
ibmcloud sl block volume-set-note IDENTIFIER [flags]
指令選項:
- --n 注意
- [需要]與儲存卷相關的公開說明