IBM Cloud Docs
使用 Block Storage for Classic 服务 (ibmcloud sl block)

使用 Block Storage for Classic 服务 (ibmcloud sl block)

IBM Cloud® Block Storage for Classic 是独立于计算实例进行供应和管理的持久高性能 iSCSI 存储器。基于 iSCSI的 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 VOLUME_ID[OPTIONS]

示例

ibmcloud sl block access-authorize 12345678--virtual-id87654321 此命令授权 ID 为 87654321 的虚拟服务器访问 ID 为 12345678 的卷。

ibmcloud sl block access-authorize IDENTIFIER [flags]

命令选项

---d、硬件 ID
要授权的一个硬件服务器的标识。
---p,ip 地址
要授权的 IP 地址。
---i,ip 地址-id
要授权的一个 IP 地址的标识。
---v,虚拟 ID
要授权的一个虚拟服务器的标识。

ibmcloud sl block access-list

列出有权访问卷的主机。

ibmcloud sl block access-list VOLUME_ID[OPTIONS]

示例

ibmcloud sl block access-list 12345678--sortbyid 此命令列出授权访问 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--passwordPASSWORD

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 VOLUME_ID[OPTIONS]

示例

ibmcloud sl block access-revoke 12345678--virtual-id87654321 此命令撤销 ID 为 87654321 的虚拟服务器对 ID 为 12345678 的卷的访问权限。

ibmcloud sl block access-revoke IDENTIFIER [flags]

命令选项

---d、硬件 ID
要撤销的某个硬件服务器的标识
---p,ip 地址
要撤销的 IP 地址
---i,ip 地址-id
要撤销的某个 IP 地址的标识
---v,虚拟 ID
要撤销的某个虚拟服务器的标识

ibmcloud sl block 灾难恢复-故障转移

将无法访问的卷故障转移到其可用的副本卷。

如果卷(带复制)因灾难事件而无法访问,可使用此方法立即 故障切换到另一位置的可用副本。 此方法不允许通过 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 块重复-convert-status

获取给定块存储器重复卷的分割或移动完成百分比的状态。

ibmcloud sl block duplicate-convert-status IDENTIFIER

ibmcloud sl block object-列表

列示云块存储器。

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 副本-故障恢复 12345678 此命令对标识为 12345678 的卷执行故障恢复操作。

ibmcloud sl block replica-failback IDENTIFIER

ibmcloud sl block replica-failover

将块卷故障转移到给定副本卷

ibmcloud sl block replica-failover VOLUME_ID REPLICA_ID

示例

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 副本-locations 12345678 此命令列出标识为 12345678 的块卷的适当复制数据中心。

ibmcloud sl block replica-locations IDENTIFIER

ibmcloud sl block replica-order

订购块存储器副本卷

ibmcloud sl block replica-order VOLUME_ID[OPTIONS]

示例

ibmcloud sl block replica-order 12345678-sDAILYdal09 --tier4--os-typeLINUX 此命令为 ID 为 12345678 的卷订购副本,该卷执行 DAILY 复制,位于dal09,层级为 4,操作系统类型为Linux。

ibmcloud sl block replica-order IDENTIFIER [flags]

命令选项

--数据中心
该副本的数据中心的短名称。 例如,dal09 [要求]
---f,强制
强制执行操作而不确认
---i、iops
性能存储器 IOPs,介于 100 到 6000 之间且为 100 的倍数;如果未指定 IOPS 值,那么将使用原始卷的 IOPS 值
--O--o
订购副本的主卷的操作系统类型(如 LINUX),[可选项]有HYPER_V,LINUX,VMWARE,WINDOWS_2008、windows_gpt、windows、xen
---s,快照计划
用于复制的快照安排。 选项有每小时、每天、每周[所需]时间
---t,层
订购副本的主卷的耐用性存储层(每 GB IOPS),[可选项]有:25、2、4、10:0.0.25,2,4,10,if未指定级别,则使用原始卷的级别

ibmcloud sl block replica-partners

列出块卷的现有副本卷

ibmcloud sl block replica-partners VOLUME_ID[OPTIONS]

示例

ibmcloud sl block 副本-合作伙伴 12345678 此命令列出标识为 12345678 的块卷的现有复制卷。

ibmcloud sl block replica-partners IDENTIFIER

ibmcloud sl block snapshot-cancel

取消给定卷的现有快照空间

ibmcloud sl block snapshot-cancel SNAPSHOT_ID[选项]

示例

ibmcloud sl block snapshot-cancel 12345678--immediate -f 此命令将立即取消 ID 为 12345678 的快照,无需请求确认。

ibmcloud sl block snapshot-cancel IDENTIFIER [flags]

命令选项

---f,强制
强制执行操作而不确认
--immediate
立即取消快照空间,而不是在计费周年日取消
--reason
可选的取消原因

ibmcloud sl block snapshot-create

创建给定卷的快照

ibmcloud sl block snapshot-create VOLUME_ID[OPTIONS]

示例

ibmcloud sl block snapshot-create 12345678--notesnapshotforibmcloud 此命令为 ID 为 12345678 的卷创建快照,并添加注释 snapshotforibmcloud。

ibmcloud sl block snapshot-create IDENTIFIER [flags]

命令选项

---n,注释
要在新快照上设置的注释

ibmcloud sl block snapshot-delete

删除给定卷的快照

ibmcloud sl block snapshot-delete IDENTIFIER

ibmcloud sl block snapshot-disable

按指定安排禁用给定卷的快照

ibmcloud sl block snapshot-disable VOLUME_ID[选项]

示例

ibmcloud sl block snapshot-disable 12345678-sDAILY 此命令禁用 ID 为 12345678 的卷的每日快照。

ibmcloud sl block snapshot-disable IDENTIFIER [flags]

命令选项

---s,时间表类型
[需要]快照时间表,选项有每小时、每天、每周

ibmcloud sl block snapshot-enable

按指定安排启用给定卷的快照

有关这些选项的更多详情https://sldn.softlayer.com/reference/services/SoftLayer_Network_Storage/enableSnapshots/。 示例

ibmcloud sl block snapshot-enable 12345678-sWEEKLY-c5-m0--hour2-d0 此命令为 ID 为 12345678 的卷启用快照,每周日 2:00 拍摄快照,最多保留 5 个快照。

ibmcloud sl block snapshot-enable IDENTIFIER [flags]

命令选项

---d,星期
应生成快照的星期几,介于 0 到 6 之间的整数。 0 表示 Sunday,1 表示 Monday,2 表示 Tuesday,3 表示 Wendesday,4 表示 Thursday,5 表示 Friday,6 表示星期六
---r,小时
应该生成快照的时刻,值为整数 0 到 23
---m,分钟
应该生成快照的分钟,值为整数 0 到 59
---c,保留数
要保留的快照数量
---s,时间表类型
快照计划,选项包括间隔、每小时、每天、每周

ibmcloud sl block snapshot-get-notification-status

获取给定卷的快照空间使用阈值警告标志设置。

ibmcloud sl block snapshot-get-notification-status IDENTIFIER

ibmcloud sl block snapshot-list

列出块存储器快照

示例

ibmcloud sl block snapshot-list 12345678--sortbyid 此命令列出 ID 为 12345678 的卷的所有快照,并按 ID 排序。

ibmcloud sl block snapshot-list IDENTIFIER [flags]

命令选项

--sortby
要作为排序依据的列。 选项为:id、name、created 或 size_bytes

ibmcloud sl block snapshot-order

订购块存储器卷的快照空间

有关尺寸选择,https://cloud.ibm.com/docs/BlockStorage?topic=BlockStorage-getting-started。 ibmcloud sl block volume-options' 获取可用选项。

示例

ibmcloud sl block snapshot-order 12345678-s1000-t4 此命令为 ID 为 12345678 的卷订购快照空间,大小为1000GB,层级为每 GB 4 IOPS。

ibmcloud sl block snapshot-order IDENTIFIER [flags]

命令选项

---f,强制
强制执行操作而不确认
---i、iops
性能存储器 IOPs,介于 100 到 6000 之间且为 100 的倍数
---s,尺寸
要创建的快照空间大小(单位:GB
---t,层
订购空间的块卷的耐用性存储级别(每 GB IOPS),[可选项]有 0.0.25,2,4,10
---u,升级
用于指示订单为升级订单的标志

ibmcloud sl block snapshot-restore

使用给定快照复原块卷

示例

ibmcloud sl block snapshot-restore 12345678 87654321 此命令从标识为 87654321 的快照复原标识为 12345678 的卷。

ibmcloud sl block snapshot-restore IDENTIFIER SNAPSHOT_ID

ibmcloud sl block snapshot-schedule-list

列出给定卷的快照安排

ibmcloud sl block snapshot-schedule-list IDENTIFIER

ibmcloud sl block snapshot-set-notification

对给定卷启用/禁用快照空间使用阈值警告。

ibmcloud sl block snapshot-set-notification IDENTIFIER [flags]

命令选项

--disable
禁用快照通知。
--enable
启用快照通知。

ibmcloud sl block subnet-分配

将块存储器子网分配至给定主机标识。

access_id 是通过以下命令获得的 host_id:sl block access-list volume_idSoftLayer_Account::iscsiisolationdisabled必须为 False 才能使用此命令 ibmcloud sl block subnets-assign ACCESS_ID[选项]

示例

ibmcloud sl 块子网络-分配 111111--subnet-id222222 ibmcloud sl block subnets-assign 111111--subnet-id222222--subnet-id333333 ACCESS_ID 是通过以下方式获得的 host_id:ibmcloud sl block access-list volume_id

ibmcloud sl block subnets-assign IDENTIFIER [flags]

命令选项

--subnet-id
要分配的子网的标识;例如: -- subnet-id 1234

ibmcloud sl 块子网-列表

列出块存储器为给定主机标识分配的子网。

access_id 是通过以下方法获取的 host_id: sl block access-list volume_id ibmcloud sl block subnet-list ACCESS_ID [OPTIONS]

示例

ibmcloud sl block 子网-list 12345678 ACCESS_ID 是由 ibmcloud sl block access-list volume_id 获取的 host_id

ibmcloud sl block subnets-list IDENTIFIER

ibmcloud sl 块子网-除去

将块存储器子网从给定主机标识中除去。

access_id 是通过以下命令获得的 host_id:sl block access-list volume_idSoftLayer_Account::iscsiisolationdisabled必须为 False 才能使用此命令 ibmcloud sl block subnets-remove ACCESS_ID[选项]

示例

ibmcloud sl block subnets-remove 111111--subnet-id222222 ibmcloud sl block subnets-remove 111111--subnet-id222222--subnet-id333333 ACCESS_ID 是通过以下方式获得的主机 ID:ibmcloud sl block access-list volume_id

ibmcloud sl block subnets-remove IDENTIFIER [flags]

命令选项

--subnet-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-转换

将从属的重复卷转换为独立卷。

ibmcloud sl block volume-convert IDENTIFIER

ibmcloud sl block volume-count

列出每个数据中心的块存储卷数

ibmcloud sl block volume-count [flags]

命令选项

--数据中心
按数据中心短名称过滤
---s,sortby
要作为排序依据的列

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-重复 12345678 此命令通过复制标识为 12345678 的卷来显示新卷的顺序。

ibmcloud sl block volume-duplicate IDENTIFIER [flags]

命令选项

--billing
计费费率的可选参数(缺省为每月)选项:每小时或每月
---d,从属重复
该副本是否为原始加密卷的从属副本[:假]
---i,重复-iops
性能存储 IOPS,介于 100 到 6000 之间 (100 的倍数),如果未指定 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,重复快照大小
要为副本订购的快照空间大小,如果未指定快照空间大小,那么将使用源卷的快照空间大小 0 作为此参数的输入,以订购没有快照空间的副本卷。
---t,重复层
耐用存储层,如果未指定层,则使用原始卷的层 要求:[如果原始加密卷的 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
用于复制的源卷快照的标识

ibmcloud sl block volume-限制

列出此帐户的每个数据中心的存储限制。

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 -tendurance--sortbycapacity_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。 此选项可以多次指定
--数据中心
按数据中心短名称过滤
---n,注释
按注释过滤
---o,命令
按购买了块存储器的订单的标识过滤
--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

修改现有块存储卷

ibmcloud sl block volume-modify VOLUME_ID[OPTIONS]

示例

  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,新级
耐久性存储层(每 GB IOPS)[,仅适用于耐久性卷] 如果未指定层,将使用卷的原始层。

ibmcloud sl block volume-options

列出用于订购块存储器的所有选项

ibmcloud sl block volume-options

示例

ibmcloud sl block volume-options 此命令列出创建块存储卷的所有选项,包括存储类型、卷大小、操作系统类型、IOPS、层级、数据中心和快照大小。

ibmcloud sl block volume-options [flags]

命令选项

--prices
在存储器、快照和 iops 范围表中显示价格。

ibmcloud sl block volume-order

订购块存储器卷

ibmcloud sl block volume-order[OPTIONS]

示例

ibmcloud sl block volume-order--storage-typeperformance--size1000--iops4000--os-typeLINUX-d dal09 此命令命令一个性能卷,大小为1000GB,IOPS 为 4000,操作系统类型为 LINUX,位于dal09。 ibmcloud sl block volume-order--storage-typeendurance--size500--tier4--os-typeXEN-d dal09 --snapshot-size500 此命令命令一个耐久卷,大小为500GBGB,层级为每 GB 4 IOPS,操作系统类型为 XEN,位于dal09,附加快照空间大小为500GB。

ibmcloud sl block volume-order [flags]

命令选项

---b,计费
计费费率的可选参数(缺省值为 monthly),选项为:hourly、monthly
--数据中心
[需要]数据中心简称
---f,强制
强制执行操作而不确认
---i、iops
性能 存储[类性能所需的]存储 IOP(100 至 6000,以 100 的倍数表示
--O--o
[需要]操作系统,选项包括HYPER_V,LINUX,VMWARE,WINDOWS_2008、windows_gpt、windows、xen
---s,尺寸
[所需]存储容量(GB
---n,快照大小
用于订购快照空间以及耐久性块存储器的可选参数;指定要订购的快照空间的大小 (GB)
---t,存储类型
[所需的]存储容量类型,选项包括:性能、耐用性
---e,层
[存储类耐用性所需的耐用性]存储层(每 GB IOP),可选项有 0.0.25,2,4,10

ibmcloud sl block volume-刷新

使用其父卷的快照来刷新重复的卷。

使用来自其父代的快照刷新重复卷。ibmcloud sl block volume-刷新 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 标识

在现有块存储卷上设置 LUN 标识 ibmcloud sl block volume-set-lun-id VOLUME_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 [选项] VOLUME_ID

示例

ibmcloud sl block volume-set-note 12345678--note'这是我的笔记'

ibmcloud sl block volume-set-note IDENTIFIER [flags]

命令选项

---n,注释
[需要]与存储容量相关的公共说明