使用 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-authorize

授權主機存取給定的磁區。

範例

ibmcloud sl block access-authorize 12345678 --virtual-id 87654321 此指令授權 ID 為 87654321 的虛擬伺服器存取 ID 為 12345678 的磁碟區。

ibmcloud sl block access-authorize 5555 --subnet-id 1111 此指令將 ID 為 1111 的子網路加入 ID 為 5555 的 Allowed Host。 使用「access-list」來尋找這個 id。 SoftLayer_Account::iscsiIsolationDisabled 必須為 False,此指令才能執行任何動作。

ibmcloud sl block access-authorize 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 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 注意
[需要]與儲存卷相關的公開說明