本节主要介绍创建存储池命令。 ./stor storagepool add { n name } POOLNAME [ faultdomain FAULTDOMAIN ] [ [qosname QOSNAME ] [ iops IOPS ] [ readiops READIOPS ] [ writeiops WRITEIOPS ] [ bps BPS ] [ readbps READBPS ] [ writebps WRITEBPS ] [ iopsburst IOPSBURST ] [ readiopsburst READIOPSBURST ] [ writeiopsburst WRITEIOPSBURST ] [ bpsburst BPSBURST ] [ readbpsburst READBPSBURST ] [ writebpsburst WRITEBPSBURST ] [ iopsburstsecs IOPSBURSTSECS ] [ readiopsburstsecs READIOPSBURSTSECS ] [ writeiopsburstsecs WRITEIOPSBURSTSECS ] [ bpsburstsecs BPSBURSTSECS ] [ readbpsburstsecs READBPSBURSTSECS ] [ writebpsburstsecs WRITEBPSBURSTSECS] ] 此命令用来创建存储池。 说明 HBlock集群中最多可以创建32768个存储池。 参数 参数 描述 n POOLNAME 或 name POOLNAME 指定存储池名称。 取值：字符串形式，长度范围是1~16，只能由字母、数字、短横线（）、下划线（）组成，字母区分大小写，且仅支持以字母和数字开头。 faultdomain FAULTDOMAIN 指定存储池的故障域级别。 取值： path：数据目录级别。 server：服务器级别。 rack：机架级别。 room：机房级别。 默认值为server。 qosname QOSNAME 指定QoS策略名称。 注意 创建存储池时，如果指定QoS策略名称不存在，那么同时创建QoS策略，新创建的QoS策略的回收策略默认为Delete。 取值：字符串形式，长度范围1~64，只能由字母、数字和短横线()组成，区分大小写，且仅支持以字母或数字开头。 注意 如果没有指定QOSNAME ，但是设置了IOPS/Bps中的任何一个参数，则根据IOPS/Bps自动创建一个QoS策略，系统为策略名赋值：poolpoolnameqostimestamp。 如果指定了QOSNAME 以及IOPS/Bps中的任何一个参数，则QOSNAME不能与已存在的QoS策略重名。 如果指定了QOSNAME ，没有设置IOPS/Bps中的任何一个参数，则QOSNAME需要为已存在的QoS策略名称。 iops IOPS 每秒能够进行读写操作次数的最大值。 取值：整数形式，取值为[1, 999999999]，默认值为1。1表示不限制。 readiops READIOPS 每秒能够进行读操作次数的最大值。 取值：整数形式，取值为[1, 999999999]，默认值为1。1表示不限制。 writeiops WRITEIOPS 每秒能够进行写操作次数的最大值。 取值：整数形式，取值为[1, 999999999]，默认值为1。1表示不限制。 bps BPS 每秒可传输数据量的最大值。 取值：整数形式，数字后面可以输入单位简写B/b、K/k、M/m、G/g、T/t，分别代表B/s、KiB/s、MiB/s、GiB/s、TiB/s。默认单位是B/s，默认值为1，表示不限制。 如果单位是B/s，取值为[1, 4096000000000]。 如果单位是KiB/s，取值为[1, 4000000000]。 如果单位是MiB/s，取值为[1, 3906250]。 如果单位是GiB/s，取值为[1, 3814]。 如果单位是TiB/s，取值为[1, 3]。 readbps READBPS 读带宽上限。 取值：整数形式，数字后面可以输入单位简写B/b、K/k、M/m、G/g、T/t，分别代表B/s、KiB/s、MiB/s、GiB/s、TiB/s。默认单位是B/s，默认值为1，表示不限制。 如果单位是B/s，取值为[1, 4096000000000]。 如果单位是KiB/s，取值为[1, 4000000000]。 如果单位是MiB/s，取值为[1, 3906250]。 如果单位是GiB/s，取值为[1, 3814]。 如果单位是TiB/s，取值为[1, 3]。 writebps WRITEBPS 写带宽上限。 取值：整数形式，数字后面可以输入单位简写B/b、K/k、M/m、G/g、T/t，分别代表B/s、KiB/s、MiB/s、GiB/s、TiB/s。默认单位是B/s，默认值为1，表示不限制。 如果单位是B/s，取值为[1, 4096000000000]。 如果单位是KiB/s，取值为[1, 4000000000]。 如果单位是MiB/s，取值为[1, 3906250]。 如果单位是GiB/s，取值为[1, 3814]。 如果单位是TiB/s，取值为[1, 3]。 iopsburst IOPSBURST 使用Burst功能时，每秒能够进行读写操作次数的最大值。 取值：整数形式。只有当iops IOPS 大于等于1时，此项设置为1或(IOPS, 999999999]内的正整数方可生效。默认值为1，表示不限制。 readiopsburst READIOPSBURST 使用Burst功能时，每秒能够进行读操作次数的最大值。 取值：整数形式。只有当readiops READIOPS 大于等于1时，此项设置为1或(READIOPS, 999999999]内的正整数方可生效。默认值为1，表示不限制。 writeiopsburst WRITEIOPSBURST 使用Burst功能时，每秒能够进行写操作次数的最大值。 取值：整数形式。只有当writeiops WRITEIOPS 大于等于1时，此项设置为1或(WRITEIOPS 999999999]内的正整数方可生效。默认值为1，表示不限制。 bpsburst BPSBURST 使用Burst功能时，每秒可传输的数据量最大值。 取值：整数形式，数字后面可以输入单位简写B/b、K/k、M/m、G/g、T/t，分别代表B/s、KiB/s、MiB/s、GiB/s、TiB/s。默认单位是B/s，默认值为1，表示不限制。只有当bps BPS大于等于1时，在单位相同的情况下，此项设置为下列取值范围方可生效： 如果单位是B/s，取值为1或(BPS, 4096000000000]内的正整数。 如果单位是KiB/s，取值为1或(BPS, 4000000000]内的正整数。 如果单位是MiB/s，取值为1或(BPS, 3906250]内的正整数。 如果单位是GiB/s，取值为1或(BPS, 3814]内的正整数。 如果单位是TiB/s，取值为1或(BPS, 3]内的正整数。 readbpsburst READBPSBURST 使用Burst功能时，读带宽上限。 取值：整数形式，数字后面可以输入单位简写B/b、K/k、M/m、G/g、T/t，分别代表B/s、KiB/s、MiB/s、GiB/s、TiB/s。默认单位是B/s，默认值为1，表示不限制。只有当readbps READBPS大于等于1时，在单位相同的情况下，此项设置为下列取值范围方可生效： 如果单位是B/s，取值为1或(READBPS, 4096000000000]内的正整数。 如果单位是KiB/s，取值为1或(READBPS, 4000000000]内的正整数。 如果单位是MiB/s，取值为1或(READBPS, 3906250]内的正整数。 如果单位是GiB/s，取值为1或(READBPS, 3814]内的正整数。 如果单位是TiB/s，取值为1或(READBPS, 3]内的正整数。 writebpsburst WRITEBPSBURST 使用Burst功能时，写带宽上限。 取值：整数形式，数字后面可以输入单位简写B/b、K/k、M/m、G/g、T/t，分别代表B/s、KiB/s、MiB/s、GiB/s、TiB/s。默认单位是B/s，默认值为1，表示不限制。只有当writebps WRITEBPS大于等于1时，在单位相同的情况下，此项设置为下列取值范围方可生效： 如果单位是B/s，取值为1或(WRITEBPS, 4096000000000]内的正整数。 如果单位是KiB/s，取值为1或(WRITEBPS, 4000000000]内的正整数。 如果单位是MiB/s，取值为1或(WRITEBPS, 3906250]内的正整数。 如果单位是GiB/s，取值为1或(WRITEBPS, 3814]内的正整数。 如果单位是TiB/s，取值为1或(WRITEBPS, 3]内的正整数。 iopsburstsecs IOPSBURSTSECS 使用Burst功能时，按照Burst上限的能力进行读写操作所能持续的时间。 注意 只有在IOPS Burst功能启用时，此配置才生效。 取值：整数形式，取值为[1, 999999999]，默认值为1，单位是秒。 readiopsburstsecs READIOPSBURSTSECS 使用Burst功能时，按照Burst上限的能力进行读操作所能持续的时间。 注意 只有在Read IOPS Burst功能启用时，此配置才生效。 取值：整数形式，取值为[1, 999999999]，默认值为1，单位是秒。 writeiopsburstsecs WRITEIOPSBURSTSECS 使用Burst功能时，按照Burst上限的能力进行写操作所能持续的时间。 注意 只有在Write IOPS Burst功能启用时，此配置才生效。 取值：整数形式，取值为[1, 999999999]，默认值为1，单位是秒。 bpsburstsecs BPSBURSTSECS 使用Burst功能时，按照Burst上限的流量能力所能持续的时间。 注意 只有在BPS Burst功能启用时，此配置才生效。 取值：整数形式，取值为[1, 999999999]，默认值为1，单位是秒。 readbpsburstsecs READBPSBURSTSECS 使用Burst功能时，按照Burst上限的读流量能力所能持续的时间。 注意 只有在Read BPS Burst功能启用时，此配置才生效。 取值：整数形式，取值为[1, 999999999]，默认值为1，单位是秒。 writebpsburstsecs WRITEBPSBURSTSECS 使用Burst功能时，按照Burst上限的写流量能力所能持续的时间。 注意 只有在Write BPS Burst功能启用时，此配置才生效。 取值：整数形式，取值为[1, 999999999]，默认值为1，单位是秒。

示例 移除服务器ID为hblock4的服务器。 plaintext [root@hblockserver CTYUNHBlockPlus3.10.0x64] ./stor server rm n hblock4 The software will be deleted on the specified server. Are you sure to remove this server? [Yes/No] y Processing... Start removing server hblock4. You can list server to check whether it is completed. You can reconnect the following iSCSI LUN(s): 1.iSCSI LUN name:lun04a iSCSI target: iqn.201208.cn.ctyunapi.oos:target04.7(192.168.0.209:3260,ColdStandby) iSCSI target: iqn.201208.cn.ctyunapi.oos:target04.8(192.168.0.72:3260,Active) 说明 卷关联的iSCSI target处于ColdStandby状态，表示iSCSI target正在从被删除的服务器上迁移到集群其他服务器上，迁移过程，该iSCSI target处于ColdStandby状态。迁移完成后，iSCSI target将变为Active或者Standby状态。

请求示例 查询存储池pool1。 plaintext GET /rest/v1/system/storagepool/pool1 HTTP/1.1 Date: Wed, 31 Dec 2025 09:26:21 GMT ContentType: application/json; charsetutf8 Authorization: HBlock userName:signature Host: 192.168.0.64:1443 响应示例 plaintext HTTP/1.1 200 OK xhblockrequestid: c68b4918d8814c908c6a5e10c25c163d Connection: keepalive ContentLength: 2385 Date: Wed, 31 Dec 2025 09:26:21 GMT ContentType: application/json;charsetutf8 Server: HBlock { "data": { "name": "pool1", "id": 0, "isBasePool": true, "status": "Normal", "faultDomain": "server", "totalCapacity": 299111325696, "usedCapacity": 4151316480, "usedCapacityQuota": 3298676875, "capacityQuota": 299111325696, "createTime": 1766021671041, "luns": { "lunNamesForCachePool": [], "lunNamesForPool": [ "lun04c", "lun01aC1", "lun03a", "lun040012", "lun04a", "luncloud", "lun01a", "lun01b" ], "status": { "number": 8, "cacheNumber": 1, "storageNumber": 3, "localNumber": 4, "cacheCapacity": 515396075520, "storageCapacity": 784905273344, "localCapacity": 505732399104 } }, "topology": [ { "name": "hblock1", "fullname": "default:hblock1", "type": "server", "healthStatus": "Healthy", "clusterAddress": "192.168.0.65", "publicAddress": "192.168.0.65", "allDiskPaths": { "usedCapacity": 1815838720, "totalCapacity": 99703775232 }, "serverStatus": "Connected", "serverId": "hblock1", "childNodes": [ { "name": "/mnt/stor01", "fullname": "default:hblock1:/mnt/stor01", "type": "path", "usedCapacity": 1815838720, "totalCapacity": 99703775232, "usedCapacityQuota": 1100965008, "capacityQuota": 99703775232, "managementStatus": "Added", "healthStatus": "Healthy", "healthDetail": [], "serverId": "hblock1" } ] }, { "name": "hblock2", "fullname": "default:hblock2", "type": "server", "healthStatus": "Healthy", "clusterAddress": "192.168.0.64", "publicAddress": "192.168.0.64", "allDiskPaths": { "usedCapacity": 1134886912, "totalCapacity": 99703775232 }, "serverStatus": "Connected", "serverId": "hblock2", "childNodes": [ { "name": "/mnt/stor02", "fullname": "default:hblock2:/mnt/stor02", "type": "path", "usedCapacity": 1134886912, "totalCapacity": 99703775232, "usedCapacityQuota": 1100928144, "capacityQuota": 99703775232, "managementStatus": "Added", "healthStatus": "Healthy", "healthDetail": [], "serverId": "hblock2" } ] }, { "name": "hblock3", "fullname": "default:hblock3", "type": "server", "healthStatus": "Healthy", "clusterAddress": "192.168.0.67", "publicAddress": "192.168.0.67", "allDiskPaths": { "usedCapacity": 1200590848, "totalCapacity": 99703775232 }, "serverStatus": "Connected", "serverId": "hblock3", "childNodes": [ { "name": "/mnt/stor01", "fullname": "default:hblock3:/mnt/stor01", "type": "path", "usedCapacity": 1200590848, "totalCapacity": 99703775232, "usedCapacityQuota": 1096783723, "capacityQuota": 99703775232, "managementStatus": "Added", "healthStatus": "Healthy", "healthDetail": [], "serverId": "hblock3" } ] } ], "qosPolicy": { "qosName": "QoS1" }, "qosPolicyforLUN": { "qosName": "QoS1" }, "dataHealth": { "normal": 100, "lowRedundancy": 0, "error": 0 } } }

本节主要介绍存储池的错误码。 HTTP status 错误码 错误信息 描述 400 CanNotAddNodeToPool The node nodeName has no available paths added to storage pool poolname. 该节点没有可用的path节点添加到存储池。 400 CanNotDeleteBasePool The storage pool with name poolNamecan not be deleted. It is a base pool. 无法删除基础存储池。 400 CanNotDeleteNode The node nodeNamecan not be deleted. Please remove its child nodes and try again. 该节点不能移除，需要先移除它的子节点后才能移除该节点。 400 CanNotDeleteRootNode The type of node nodeNameis root, it cannot be deleted. 不能删除根节点。 400 CanNotMoveNode The node nodeNamecan not be moved. Please make sure the node type is not lower than the fault domain level of storage pool which its leaf node belongs to. 节点不满足重新映射条件，请修改后重试。 400 DuplicatedNode The node with name nodeNameis not unique in the topology. 节点名称在集群中不唯一。 400 ExceedThreshold The number of operation cannot exceed value. 超出了系统允许的最大个数，无法执行该操作。 400 InvalidEnumValue Value value at 'node type' failed to satisfy constraint: Argument must satisfy enum value set: [value1, value2...] 节点类型错误，不符合枚举值。 400 InvalidFile Failed to parse file filename. 文件格式不正确。 400 InvalidNodeName Value value at 'node name' failed to satisfy constraint: Argument must contain only letters, digits, dots (.), underscores () or hyphens (), and does not exceed 63 characters, must begin with a letter or digit. 节点名称不正确。长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 400 InvalidNodeType Value valueat 'node type' failed to satisfy constraint: the first node type must be root. 节点类型的包含关系错误，第一个节点必须是root。 400 InvalidNodeType Value valueat 'node type' failed to satisfy constraint: childNodes of room are limited to [rack, server], childNodes of rack to [server], childNodes of server to [path] only. 节点类型的包含关系错误。room的节点仅限于rack、server，机架的子节点是server，server的子节点是path。 400 InvalidPathStatus The path path status is 'status', the request is invalid. 数据目录状态不正确，无法执行操作。 400 InvalidPoolName Value valueat 'pool name' failed to satisfy constraint: Argument must contain only letters, digits, underscores () or hyphens (), and does not exceed 16 characters, must begin with a letter or digit. 存储池名称不正确。 400 InvalidTopology Failed to parse topology. 拓扑格式不符合要求。 400 InvalidTopologyContent The content of the topology is not compliant. 拓扑文件内容解析错误。 400 InsufficientPath The base storage pool must have at least one disk path. 基础存储池至少要有一个数据目录。 400 LUNCorruptedRisk There is a LUN with redundancy mode, which has the minimum requirement for the number of fault domains. LUN: lunName1 [, lunName2....] Removing the node may cause data loss. You can use force remove. When using this option, there may be a risk of data loss. 节点移除后会造成卷数据损毁：lunName1[, lunName2....]。移除节点可能会引起数据丢失。只能使用强制移除。请注意，强制移除，会产生数据丢失风险，请谨慎操作。 400 LUNExists There are LUNs in this storage pool Please delete all LUNs and try again. 存储池关联的卷不存在。 400 MissingRequiredAncestorNode The node nodeName has no ancestor node with type nodetype. 没有对应的父节点类型。 400 MissingRequiredDescendantNode The node nodeName has no descendant node with type nodetype. 没有对应的子节点类型。 400 NodeAlreadyExists The node with name nodeNamehas already exists in the topology. 节点名称已经在拓扑图中存在。 400 NodeNotAllowed The type of node nodeNameis type, the request is invalid. 节点名称和节点类型不匹配。 400 NoSuchFile The file with name filenamedoes not exist. 文件不存在。 400 NoSuchNode The node with name nodeNamedoes not exist. 节点不存在。 400 NoSuchStoragePool The storage pool with name poolNamedoes not exist. 存储池不存在。 400 NodeTypeNotMatch Node type does not match. Please check parent node type. 节点类型不匹配，请检查父节点。 400 PathConflict Can not use path pathNamebecause it belongs to another storage pool. 不能添加该节点，因为该节点已经属于其他存储池。 400 PermissionDenied Failed to actionbecause user has no permission. 用户的权限不足，无法执行操作。 400 PoolAlreadyExists The storage pool with name poolNamealready exists. 存储池名字已经存在。 400 RemoveFaultDomainRisk Can not remove multiple fault domains at the same time. You can use force remove. When using this option, there may be a risk of data loss. 无法同时移除的多个故障域。 400 RemoveNodeRisk The node nodeNameor its child nodes are being used by a storage pool. Removing the node may cause data loss. You can use force remove. When using this option, there may be a risk of data loss. 移除节点可能会引起数据丢失。只能使用强制移除。请注意，强制移除，会产生数据丢失风险，请谨慎操作。 400 SamePool Cannot use the same storage pool poolName. 不能使用名字相同的存储池。 400 StandaloneModeNotAllowed 'operation' is not supported by standalone mode of HBlock. 单机版本HBlock不支持该操作。 400 SystemCrashRisk The node nodenamecan not be removed because there is only one available fault domain left in the base storage pool, or the node is related to multiple fault domains in the base pool, removing node may result in a system crash. 无法移除节点，存在以下情况之一，移除节点可能引发系统崩溃：基础存储池仅剩一个可用故障域时，无法移除故障域内的任何节点；节点涉及基础存储池的多个故障域。 409 InvalidPoolStatus The status of storage pool poolNameis 'status', the request is invalid. 存储池当前的状态不正确，请求无效。

请求示例 查询整个拓扑。 plaintext GET /rest/v1/system/topology HTTP/1.1 Date: Fri, 2 Aug 2024 10:10:18 GMT ContentType: application/json; charsetutf8 Authorization: HBlock userName:signature Host: 192.168.0.110:1443 响应示例 plaintext HTTP/1.1 200 OK xhblockrequestid: ea0f7997eeeb415087c269c61681e4bc Connection: keepalive ContentLength: 4234 Date: Fri, 2 Aug 2024 10: 10: 18 GMT ContentType: application/json;charsetutf8 Server: HBlock { "data": { "name": "default", "fullname": "default", "id": "e69eb32c931143fd9b9e01af53bf32c1", "type": "root", "childNodes": [ { "name": "rack1", "fullname": "default:rack1", "id": "568156af0c154984ac5fea877db752e5", "type": "rack", "description": "rack1", "childNodes": [ { "name": "server4", "fullname": "default:rack1:server4", "id": "2257dc92fafe4e9190002c127ae13f68", "serverId": "hblock4", "type": "server", "clusterAddress": "192.168.0.117", "publicAddress": "192.168.0.117", "allDiskPaths": { "usedCapacity": 29337317376, "totalCapacity": 131883315200 }, "serverStatus": "Connected", "childNodes": [ { "name": "/mnt/storage02", "fullname": "default:rack1:server4:/mnt/storage02", "id": "fddcbc2b808f4ed0b9f41fa61914011c", "serverId": "hblock4", "type": "path", "totalCapacity": 56028450816, "usedCapacity": 57221120, "capacityQuota": 1, "usedCapacityQuota": 69632, "storagePool": "pool2", "healthStatus": "Healthy", "healthDetail": [] }, { "name": "/mnt/storage03", "fullname": "default:rack1:server4:/mnt/storage03", "id": "cec39c978b67414aadc74e9275d091f7", "serverId": "hblock4", "type": "path", "totalCapacity": 3927900160, "usedCapacity": 16855040, "capacityQuota": 1 }, { "name": "/mnt/storage04", "fullname": "default:rack1:server4:/mnt/storage04", "id": "22eb96ffea924e22b1f01ed42f2409aa", "serverId": "hblock4", "type": "path", "totalCapacity": 35963482112, "usedCapacity": 14631620608, "capacityQuota": 1, "usedCapacityQuota": 69632, "storagePool": "pool2", "healthStatus": "Healthy", "healthDetail": [] }, { "name": "/mnt/storage05", "fullname": "default:rack1:server4:/mnt/storage05", "id": "d7e3dd03e1274e3eb61973fcfd4956fd", "serverId": "hblock4", "type": "path", "totalCapacity": 35963482112, "usedCapacity": 14631620608, "capacityQuota": 1, "usedCapacityQuota": 69632, "storagePool": "pool2", "healthStatus": "Healthy", "healthDetail": [] } ] } ] }, { "name": "room1", "fullname": "default:room1", "id": "00457811af8e4f39ba6cf856cdc173f8", "type": "room", "childNodes": [ { "name": "rack2", "fullname": "default:room1:rack2", "id": "3f591741a38744d28ae836c4ba546bd2", "type": "rack", "childNodes": [ { "name": "server1", "fullname": "default:room1:rack2:server1", "id": "36a55e6147e543f09d73357a86d3ff53", "serverId": "hblock1", "type": "server", "clusterAddress": "192.168.0.192", "publicAddress": "192.168.0.192", "allDiskPaths": { "usedCapacity": 18890235904, "totalCapacity": 136132825088 }, "serverStatus": "Connected", "childNodes": [ { "name": "/mnt/stor", "fullname": "default:room1:rack2:server1:/mnt/stor", "id": "d14f3938a6de495087bce461d743284a", "serverId": "hblock1", "type": "path", "totalCapacity": 100169342976, "usedCapacity": 11510775808, "capacityQuota": 1, "usedCapacityQuota": 172032, "storagePool": "default", "healthStatus": "Healthy", "healthDetail": [] }, { "name": "/mnt/storage01", "fullname": "default:room1:rack2:server1:/mnt/storage01", "id": "9999d96e1032404c85de4c76f8100e12", "serverId": "hblock1", "type": "path", "totalCapacity": 35963482112, "usedCapacity": 7379460096, "capacityQuota": 1, "usedCapacityQuota": 106496, "storagePool": "default", "healthStatus": "Healthy", "healthDetail": [] } ] } ] }, { "name": "server2", "fullname": "default:room1:server2", "id": "444dd9a488db4df5995988d7b82edad8", "serverId": "hblock2", "type": "server", "clusterAddress": "192.168.0.110", "publicAddress": "192.168.0.110", "allDiskPaths": { "usedCapacity": 8582782976, "totalCapacity": 100169342976 }, "serverStatus": "Connected", "childNodes": [ { "name": "/mnt/stor", "fullname": "default:room1:server2:/mnt/stor", "id": "1451c75b2e6f4cbe82ab962019247f35", "serverId": "hblock2", "type": "path", "totalCapacity": 100169342976, "usedCapacity": 8582782976, "capacityQuota": 1, "usedCapacityQuota": 229376, "storagePool": "default", "healthStatus": "Healthy", "healthDetail": [] } ] }, { "name": "server3", "fullname": "default:room1:server3", "id": "f89a94bc2cc34ac9b5dc13d227b40cf4", "serverId": "hblock3", "type": "server", "clusterAddress": "192.168.0.102", "publicAddress": "192.168.0.102", "allDiskPaths": { "usedCapacity": 11067289600, "totalCapacity": 100169342976 }, "serverStatus": "Connected", "childNodes": [ { "name": "/mnt/stor", "fullname": "default:room1:server3:/mnt/stor", "id": "effad1429e3443f48390ccb5c211f60f", "serverId": "hblock3", "type": "path", "totalCapacity": 100169342976, "usedCapacity": 11067289600, "capacityQuota": 1, "usedCapacityQuota": 229376, "storagePool": "default", "healthStatus": "Healthy", "healthDetail": [] } ] } ] } ] } }

名称 类型 描述 name String 拓扑节点或者子节点名称。 fullname String 拓扑节点或者子节点的全路径名称。 type String 拓扑节点或者子节点的类型： room：机房。 rack：机架。 server：服务器。 path：数据目录。 description String 拓扑节点或子节点的描述信息。 如果未添加描述信息，或者节点类型是path，不返回此项。 healthStatus String 故障域状态： Healthy：健康状态，可正常读写。 Warning：警告状态，可读。 Error：错误状态，无法访问。 childNodes Array of childNodes 拓扑图中子节点， childNode 和 topology 基本一致，类型不同，包含的内容不同，详见本表其他字段。 如果 topology 或者 childNode 的类型是 server clusterAddress String 拓扑图集群网络IP。 如果 topology 或者 childNode 的类型是 server publicAddress String 拓扑图业务网络IP。 如果 topology 或者 childNode 的类型是 server allDiskPaths.usedCapacity Long 拓扑图中所有数据目录的已用容量。 如果 topology 或者 childNode 的类型是 server allDiskPaths.totalCapacity Long 拓扑图中所有数据目录的总容量。 如果 topology 或者 childNode 的类型是 server serverStatus String 拓扑图的服务器状态： Connected：已连接。 Disconnected：未连接。 Removing：移除中。 如果 topology 或者 childNode 的类型是 server serverId String 拓扑图的服务器ID。 如果 topology 或者 childNode 的类型是 server childNodes Array of childNodes 拓扑图中子节点， childNode 和 topology 基本一致，类型不同，包含的内容不同，详见本表其他字段。 如果 topology 或者 childNode 的类型是 path usedCapacity Long HBlock数据目录对应分区的已用容量，单位是bytes。 如果 topology 或者 childNode 的类型是 path totalCapacity Long HBlock数据目录对应分区的总容量，单位是bytes。 如果 topology 或者 childNode 的类型是 path usedCapacityQuota Long 数据目录已用容量配额，单位是bytes。 如果 topology 或者 childNode 的类型是 path capacityQuota Long 数据目录容量配额，单位是bytes。 如果 topology 或者 childNode 的类型是 path managementStatus String 数据目录的管理状态： Added：已添加。 Removing：正在移除。 如果 topology 或者 childNode 的类型是 path healthStatus String 数据目录健康状态： Healthy：数据目录处于健康状态，可正常读写，且数据目录所在磁盘使用率未超过阈值（系统默认值为95%）。 Warning：数据目录处于警告状态，可读，但存在以下情况的任意一种：慢盘；数据目录所在磁盘使用率超过阈值（系统默认值为95%）；磁盘剩余空间不足1GiB；HBlock对这个目录停写；数据目录配额使用率超过阈值（系统默认值为95%）；数据目录配额为0。 Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。 如果 topology 或者 childNode 的类型是 path healthDetail Array of string 数据目录健康状态详情： 如果健康状态为Healthy，此字段为空。 如果健康状态为Warning或Error，显示警告或错误的详细信息。 如果 topology 或者 childNode 的类型是 path serverId String 数据目录所属的服务器ID。

./stor storagepool ls n pool2 Storage Pool Name: default Pool Status: Normal Fault Domain: path Base Pool: true Total Capacity: 278.57 GiB Used Capacity: 23.98 GiB Created Time: 20260112 17:34:40 LUN: LUN for CachePool: lun05a LUN for Pool: lun02,lun02a,lun03a,lun01a,lun01b,lun01aC1 status: 7 total, 1.33 TiB (cache mode:1 total, 210 GiB; storage mode:1 total, 310 GiB; local mode:5 total, 841 GiB) Data Health: 100% normal, 0% low redundancy, 0% error Topology: Node Name: default:room1:rack1:hblock2:/mnt/stor01 Node Type: path Status: Healthy Disk Path(s): ++++++++ No. Path Used Capacity Total Capacity Used Capacity Quota Capacity Quota Health Status Health Detail ++++++++ 1. default:room1:rack1:hblock2:/mnt/stor01 8.4 GiB 92.86 GiB 1000.26 MiB 90 GiB Healthy ++++++++ Node Name: default:room1:hblock3:/mnt/stor01 Node Type: path Status: Healthy Disk Path(s): ++++++++ No. Path Used Capacity Total Capacity Used Capacity Quota Capacity Quota Health Status Health Detail ++++++++ 1. default:room1:hblock3:/mnt/stor01 7.82 GiB 92.86 GiB 984.27 MiB 90 GiB Healthy ++++++++ Node Name: default:hblock1:/mnt/stor02 Node Type: path Status: Healthy Disk Path(s): ++++++++ No. Path Used Capacity Total Capacity Used Capacity Quota Capacity Quota Health Status Health Detail ++++++++ 1. default:hblock1:/mnt/stor02 7.76 GiB 92.86 GiB 1004.29 MiB 90 GiB Healthy ++++++++ 查询指定存储池信息的描述 项目 描述 Storage Pool Name 存储池名称。 Pool Status 存储池状态： Normal：正常。 Deleting：删除中。 Fault Domain 存储池故障域级别： path：数据目录级别。 server：服务器级别。 rack：机架级别。 room：机房级别。 Base Pool 是否是基础存储池： true：是基础存储池。 false：不是基础存储池。 Total Capacity 存储池总容量。 Used Capacity 存储池已用容量。 Created Time 存储池创建时间。 Description 存储池描述信息。 LUN 卷相关信息，包含LUN for CachePool、LUN for Pool、status。 LUN LUN for CachePool 缓存存储池卷列表。 LUN LUN for Pool 存储池卷列表。 LUN status 卷的状态信息，包括卷的总数、总容量，以及各类型卷的个数及容量。 Data Health 存储池的数据健康度，包括：正常数据的比例（normal）、降级数据的比例（low redundancy）、错误数据的比例（error）。如果存在降级状态的数据，会给出数据重建进度（low redundancy reconstruction progress）。 Topology 存储池拓扑图，包括：Node Name、Node Type、Status、Disk Path(s)、Removing Details。 Topology Node Name 节点名称。 Topology Node Type 节点类型： path：数据目录。 server：服务器。 rack：机架。 room：机房。 Topology Status 节点健康状态： Healthy：节点处于健康状态，可正常读写。 Warning：节点处于警告状态，可读。 Error：节点处于错误状态，无法访问。 Topology Disk Path(s) 数据目录信息： No.：编号。 Path：数据目录。 Used Capacity：HBlock数据目录对应分区的已用容量。 Total Capacity：HBlock数据目录对应分区的总容量。 Used Capacity Quota：已用数据目录容量配额。 Capacity Quota：数据目录容量配额，当HBlock的使用空间一旦达到配额，就立刻阻止数据写入，不允许再使用超出配额的空间。 Health Status：数据目录的健康状态： Healthy：数据目录处于健康状态，可正常读写，且数据目录所在磁盘使用率未超过阈值（系统默认值为95%）。 Warning：数据目录处于警告状态，可读，但存在以下情况的任意一种：慢盘；数据目录所在磁盘使用率超过阈值（系统默认值为95%）；磁盘剩余空间不足1GiB；HBlock对这个目录停写；数据目录配额使用率超过阈值（系统默认值为95%）；数据目录配额为0。 Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。 Health Detail：数据目录健康状态详情。 如果健康状态为Healthy，此列为空。 如果健康状态为Warning或Error，显示警告或错误的详细信息。 Topology Removing Details 被移除节点的详细信息： No.：编号。 Path：节点的具体数据目录。 Stage：移除节点所处的阶段： Reconfiguration：重置中。 CheckingData：检查数据。 Executing：执行移除节点。 Details：详细数据： FaultDomains：故障域详情，包括：healthy（健康个数），warning（告警个数），error（错误个数）。 Data：safe（安全数据百分比），await reconstruction（需要重建的数据百分比），await more faultdomains（需要额外故障域才能够重建的数据百分比），singlecopy（单副本数据百分比），corrupted（已经损坏的数据百分比）。

量子安全介质说明 量子安全介质是提前充注量子密钥的安全介质，有两种形态： 量子软模块：以SDK形式在天翼云电脑客户端集成，客户端启动后自动加载。软模块仅用于量子会话密钥保护，不作为用户身份辅助认证。 量子安全盾：使用预充注量子密钥的硬件设备（如量子Ukey）进行量子密钥保护。量子安全盾与用户身份绑定，既用于量子会话密钥保护，又作为双因子认证安全介质。 量子软模块和量子安全盾的区别? 量子安全盾与用户身份绑定，量子安全盾首次试用需要激活后使用。云电脑使用过程中，量子安全盾拔出，自动识别并退出用户登录。 客户如何获取量子安全盾？ 量子安全盾需额外购买，如需采购，请联系客户经理。

管控配置 1. 添加管控配置：点击“添加”可添加新的管控规则。可根据URL分类库和时间组维度对URL进行管控。 2. 分配桌面、查看已分配桌面、编辑策略、管控策略操作与审计配置操作方式一致。 注意事项 1. 上网行为管理采用中间人解密技术，用来解密ssl加密流量，因此，防火墙所在vpc下的AI云电脑需要安装根证书用来解决浏览器告警问题。安装证书的三种方式： 在防火墙控制台开启上网行为，系统将给已绑定防火墙带宽下的AI云电脑安装证书。 手工点击“一键安装证书”，系统将给已绑定防火墙带宽下vpc下的AI云电脑安装证书，例如新增AI云电脑后可点击该按钮。 系统每天在夜间定时给已绑定防火墙带宽下的AI云电脑安装证书。 2. 上网行为默认是开启状态，默认未配置任何策略，即不审计任何流量。 3. 每台AI云电脑可分配一个行为审计策略和一个行为管理策略。 4. 当只审计指定的url时，只支持审计一个url类别，不支持多个url类别。 5. 报告上网审计网站访问记录，包括了AI云电脑里的应用程序产生http（s）协议流量的记录。 6. 报告上网审计，审计记录不是实时产生的，是在连接断开后才产生的，一般是2分钟左右，对长连接，会久一些才产生记录。 7. 下发证书后，如果浏览器报证书问题，重启一下浏览器。

状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 remark 是 String 备注。租户备注，长度上限 50 个字符；传入空字符串时，备注会被设置为空。

枚举参数 无 请求示例 请求url 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "agentCallBackCode":0, "mirrorCheckRemark":"success", "schedule":100, "mirrorCheckResult":[{ "name":"系统盘检测", "mustCheck":true, "result":1, "reason":"", "msg":"", "solution":"" },{ "name":"数据盘检测", "mustCheck":false, "result":1, "reason":"", "msg":"", "solution":"" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj

错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

参数 是否必填 参数类型 说明 示例 下级对象 userBindingEnabled 是 Boolean 用户绑定手机号邮箱。可限制管理台创建的用户在客户端绑定手机号、邮箱的操作；true 表示开启，false 表示关闭。

接口功能介绍 设置邮箱必选v3 接口约束 无 URI POST /v3/commonSetting/setEmailRequired 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 emailRequired 是 Boolean 邮箱必选。可限制账号激活或绑定时是否勾选通知邮箱作为账号邮箱；true 表示开启，false 表示关闭。 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "emailRequired":true } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 联系人姓名。不能为空字符串，字符数限制[1,20]。 phoneNumber 否 String 联系人手机号。手机号和邮箱至少填写一个；填写时不能为空字符串，且格式必须正确。 email 否 String 联系人邮箱。字符数限制[1,50]；手机号和邮箱至少填写一个；填写时不能为空字符串，且格式必须正确。

Q：SDK 中输入的 desktopCode 是指什么？ A：desktopCode 是指桌面编码，用于唯一标识您的云电脑桌面实例。请注意，desktopCode 与桌面 ID 是两个不同的概念，请勿混淆，务必确认填写的是正确的桌面编码。 Q：如果我的云电脑桌面处于离线状态，是否仍然可以正常使用？ A：很抱歉，桌面处于离线状态时将无法正常接收和执行指令。请您先通过云电脑客户端或官网控制台将桌面开机并确认其处于在线运行状态后，再进行相关操作。 Q：通过 SDK 发送指令后，桌面没有任何响应，应如何排查？ A：建议您按以下步骤逐一排查： 1. 确认 SDK 指令格式是否正确，参数是否完整； 2. 检查接口返回的消息体中，是否包含成功标志（successtrue）； 3. 若上述检查均无异常，请进入目标桌面，打开「应用市场」，找到并重新安装以下两个插件：clinkagent 和 AiClientTool，安装完成后再重新发送指令。 如问题仍未解决，请联系我们的技术支持团队，并提供相关日志信息以便进一步协助排查。

本节介绍翼加密客户端申请文件脱密的流程。 脱密申请步骤： 选择需要脱密的文件 选择脱密方式 脱密申请提交、流转及结果反馈 下载邮件内的脱密文件（ 脱密邮件） 用户可以根据需要，在自己的加密AI云电脑，针对加密文件发起脱密申请。脱密申请一次最多15个文件，上传的单个文件最大支持200M，大于200M文件会被自动剔除。 备注：如果需要脱密大于200M的文件，请联系管理员使用“管理员脱密工具”进行脱密。 脱密申请步骤： 选择需要脱密的文件 选择文件发起脱密申请的方式有3种： 批量选择需要脱密外发的加密文件，点击鼠标右键，在右键菜单中点击“使用翼加密申请文件脱密”。 双击桌面的“翼加密”客户端快捷方式，打开客户端首页，在首页点击“新脱密申请”按钮进行文件脱密申请。 在脱密申请页，点击“选取文件”选择需要申请脱密的文件。 在脱密申请页，也可以直接将文件拖入选中。

本节介绍翼打印支持的操作系统和性能指标。 支持的操作系统 服务桌面 WinServer2016，Win10 用户桌面 Windows：WinServer2008/2016/2019/2022、Win10 Linux：Uosv20、麒麟v10 性能指标 性能项目 性能指标 服务桌面规格 WinServer2016/Win10，4C8G，200G，优先SSD 服务器架构 X86（intel、海光) 打印响应时长(数据仅供参考，实际时长与打印机型号、文件大小、文件页数、文件内容、打印方式相关） 大文件打印（50MB） 30秒左右 打印响应时长(数据仅供参考，实际时长与打印机型号、文件大小、文件页数、文件内容、打印方式相关） 小文件打印（24KB） 10秒左右 支持网络协议(网络打印机场景) TCP 支持打印机协议 RAW 使用限制 当云电脑或终端与打印机不在同一局域网时，无法使用翼打印功能。

场景一：文档编辑 1. 和传统PC一样，可以在AI云电脑内正常使用文档编辑器，进行文档编辑。 2. 在编辑过程中可以使用AI云电脑内的键盘功能，更便捷的进行编辑输入。 场景二：邮件接收和发送 可以在AI云电脑内通过浏览器或安装邮箱客户端实现邮件的查收和发送。

使用须知 · 删除共享镜像前，需预先解除该镜像的全部共享关系。 · 镜像删除后，不能再使用该镜像创建实例，已使用该镜像创建的实例仍可正常使用，并会继续产生费用。 操作步骤 1. 登录天翼云控制台。 2. 在左侧导航栏，选择镜像服务。 3. 在页面左侧顶部，选择目标资源所在的地域。 4. 点击私有镜像页签，选中要导出的镜像，在右侧的下拉菜单中选择删除。 使用私有镜像 当您成功创建私有镜像后，镜像状态将显示为“正常”。此时，您可以使用该镜像创建实例、将其共享给其他天翼云账号使用，或导出到OSS存储空间（OSS Bucket）。若不再需要该镜像，您可以将其删除。

本节介绍如何获取云智助手 Token。 您可通过以下步骤获取API调用所需的三项凭证（API Key、基础URL、模型ID），用于接入第三方智能体。 获取云智助手的API凭证 如需配置并使用云智助手的Token额度，请先从“云智助手”应用中复制以下三项API凭证关键信息： API Key（访问密钥） 基础URL（接口地址） 模型ID（模型标识） 操作步骤 1.进入桌面并打开“云智助手”应用，使用您的账号正常登录； 2.在左侧菜单栏中，点击 “我的Token”，在页面中找到API Key字段，点击右侧的复制图标，获取“API Key”； 3.在“我的Token”页面中点击“API接入”，可以查看并复制“基础URL “和”模型ID“两项信息； 4.此时您已成功获取以下三项信息，请妥善保管： API Key 基础URL 模型ID 获取上述凭证后，您可前往 ZCode、WorkBuddy、AutoClaw 等支持第三方API Key的智能体中进行配置，并使用云智助手的Token额度。

本节介绍AutoClaw如何配置第三方API Key的操作说明。 前置准备 您已获取目标API服务商的API Key、基础URL和模型ID（如云智助手 Token的API凭证，详见“如何获取云智助手 Token”）。 操作步骤 1.打开桌面“AutoClaw”应用，在主界面选择 “设置”； 2.在左侧菜单栏中，进入 “模型与PAI”页面，点击“添加自定义模型”； 4.填写API配置信息； 在弹出的“添加供应商”窗口中，按以下字段填入您准备好的凭证： 模型ID：粘贴您要使用的模型ID API Key：粘贴您的访问密钥 Base URL：粘贴您的API基础地址 5.确认信息无误后，可点击 “连通测试” ，测试配置是否可用； 6.测试成功后，点击 “添加” 按钮，系统将保存该配置； 7.配置完成后，返回AutoClaw主界面。您将在模型选择区域看到已添加的服务商名称，表示配置成功，即可正常使用该API进行代码生成、对话等操作。

本节介绍ZCode如何配置第三方API Key的操作说明。 前置准备 您已获取目标API服务商的 API Key、基础URL 和 模型ID（如云智助手 Token的API凭证，详见“如何获取云智助手 Token”）。 操作步骤 1.打开桌面“ZCode”应用，在启动界面选择 “使用API Key”； 2.进入登录页面后，选择“跳过登录”，直接进入主界面； 3.在主界面左侧导航栏中，依次点击 “设置 ” → “模型设置 ”，然后点击 “添加供应商” 按钮； 4.填写API配置信息； 在弹出的“添加供应商”窗口中，按以下字段填入您准备好的凭证： Base URL：粘贴您的API基础地址 API Key：粘贴您的访问密钥 模型信息：粘贴您要使用的模型ID 注意 API格式：必须选择 “Chat Completions” 类型（标准对话接口格式）。 5.确认信息无误后，点击 “添加供应商” 按钮，系统将保存该配置； 6.配置完成后，返回ZCode主界面。您将在供应商列表或模型选择区域看到已添加的服务商名称，表示配置成功，即可正常使用该API进行代码生成、对话等操作。

本节介绍天翼云电脑电教室的常见问题。 开通的教师、学生AI云电脑遇到无法连接，无法使用广播优化，无法批量控制终端等问题，应该如何定位解决？ 1.检查教师、学生AI云电脑在同一个VPC，已开启网络互通，已开启组播功能； 2.检查教师、学生本地终端使用有线连接，且在同一个局域网； 3.检查教师本地终端不存在多网卡，禁用多余网卡； 4.检查教师、学生本地终端已关闭防火墙。 广播优化出现花屏、卡顿、部分学生无法接收到画面等现象，应该如何定位解决？ 检查本地是否使用有线网络正确连接，换用更稳定的交换机或者路由器。 翼电教系统的售前咨询、激活、使用相关问题，如何联系极域厂商？ 请联系甄选商城中翼电教系统的客服热线。 如何获取翼电教系统的安装包，以及公有云电教室方案的插件？ 可联系极域厂商提供翼电教系统的安装包，或直接下载安装包（访问码：4hfp） AI云电脑电教室方案的插件，可前往下载电教室插件（访问码：eh3x）

参数 参数类型 说明 示例 下级对象 totalPrice String 总价格 finalPrice String 最终价格 cycleCount String 周期数 serviceTag String 产品类别 orderItemPrices Array of Objects 价格子项。 orderItemPrices

本节介绍智算容器续费、到期与欠费。 到期前续费 手动续订：对于包年/包月订购的云容器引擎，用户在资源到期前进行续费操作，可以延长原有资源到期时间，避免资源到期后冻结或超过保留期后被系统回收。详细操作请参考费用中心续订管理手动续订。 自动续订：自动续订仅针对采用包月、包年计费模式的资源，详细操作请参考费用中心续订管理自动续订。 到期处理 到期后，云容器引擎进入保留期，您将不能正常访问及使用天翼云云容器引擎。 若您在到期后15天内续费，续费成功后系统将从原到期时间开始计算新的服务有效期并计算费用； 若到期15天后您仍未续费，云容器引擎将被删除 欠费原因 在按需计费的模式下帐号的余额不足。 欠费停服说明 欠费后云容器引擎会自动停止。 如果您在15天内充值补足欠款，服务会自动启用。 当欠费超过15天，将视为您主动放弃该服务，云容器引擎将会被销毁，销毁后数据不可恢复。因此请您及时关注账户余额并及时续费以保证您的服务不受到影响。 查看欠费账单 欠费后，可以查看欠费详情或者消费账单，具体请参见文档费用中心账单管理查看消费账单。