使用 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-id87654321 此命令授权 ID 为 87654321 的虚拟服务器访问 ID 为 12345678 的卷。

ibmcloud sl block access-authorize 5555 --subnet-id 1111 此命令将 ID 为 1111 的子网添加到 ID 为 5555 的允许主机中。使用 "access-list "查找此 id。 SoftLayer_Account::iscsiIsolationDisabled 必须为 False，这条命令才能执行。

ibmcloud sl block access-authorize IDENTIFIER [flags]

命令选项：

--d 硬件标识: 要授权的一个硬件服务器的标识。
--p, IP 地址: 要授权的 IP 地址。
--i, ip-address-id: 要授权的一个 IP 地址的标识。
--s，子网-ID: A 子网 ID。使用该选项时，IDENTIFIER 应为 access-list 命令中的 "allowed_host_id"。
--v, virtual-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-id87654321 此命令撤销 ID 为 87654321 的虚拟服务器对 ID 为 12345678 的卷的访问权限。

ibmcloud sl block access-revoke 5555 --subnet-id 1111 此命令从允许主机（Allowed Host）（id 5555）中删除 id 为 1111 的子网。使用 "access-list "查找此 id。

ibmcloud sl block access-revoke IDENTIFIER [flags]

命令选项：

--d 硬件标识: 要撤销的某个硬件服务器的标识
--p, IP 地址: 要撤销的 IP 地址
--i, ip-address-id: 要撤销的某个 IP 地址的标识
--s，子网-ID: A 子网 ID。使用该选项时，IDENTIFIER 应为 access-list 命令中的 "allowed_host_id"。
--v, virtual-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 块对象存储详情

显示云对象存储器的详细信息。

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 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 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 到 6000 之间且为 100 的倍数；如果未指定 IOPS 值，那么将使用原始卷的 IOPS 值
--o 其他类型: 订购副本的主卷的操作系统类型（如 LINUX），[可选项]有 HYPER_V,LINUX,VMWARE,WINDOWS_2008,windows_gpt,windows,xen
--s，快照计划: 用于复制的快照安排。选项有每小时、每天、每周[所需]时间
--t 层级: 订购副本的主卷的耐用性存储层（每 GB IOPS），[可选项]有：0.25,2,4,10,if 未指定层，将使用原始卷的层

ibmcloud sl block replica-partners

列出块卷的现有副本卷

示例：

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

ibmcloud sl block replica-partners IDENTIFIER

ibmcloud sl block snapshot-cancel

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

示例：

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 --note snapshotforibmcloud 此命令为 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 -s WEEKLY -c 5 -m 0 --hour 2 -d 0 此命令为 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 --sortby id 此命令列出 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 -s 1000 -t 4 此命令为 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.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 块快照设置-通知

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

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]

命令选项：

--d 数据中心: 按数据中心短名称过滤
---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，介于 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 -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 命令: 按购买了块存储器的订单的标识过滤
--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 新级: 耐久性存储层（每 GB IOPS） [，仅适用于耐久性卷] 如果未指定层，将使用卷的原始层。 层级：[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: 在存储器、快照和 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 其他类型: [需要]操作系统，选项有 HYPER_V,LINUX,VMWARE,WINDOWS_2008,windows_gpt,windows,xen
--s 尺寸: [所需]存储容量（GB
--n，快照大小: 用于订购快照空间以及耐久性块存储器的可选参数；指定要订购的快照空间的大小 (GB)
--t，存储类型: [所需的]存储容量类型，选项包括：性能、耐用性
--e 级别: 耐久性存储[类型耐久性所需的]存储层（每 GB IOP），可选项有 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 注意: [需要]与存储容量相关的公共说明