存储池
February 26, 2024About 12 min
存储池
SDK类名：/resource/StoragePool
扫描，获取存储机可用磁盘列表
SDK方法名：availablePoolMemberList
URL
/storage_pool/available_pool_member
Method
POST
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| config_addr | String | 备机地址:端口;127.0.0.1:8080 | |||
| pool_type | String | 存储类型，备机集群作为备机时为H3CX10000Storage | BlockStorage | ||
| storage_conf_ip | String | 【可选】存储管理地址ip，备机集群作为备机时必传 | |||
| os_user | String | 用户名 | |||
| os_pwd | String | 密码 | |||
| pool_uuid | String | 扩容操作对应存储池uuid | |||
| storage_conf_user | String | 存储用户名 | |||
| storage_conf_password | String | 存储密码 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| msg | String | ||||
| data | Object | ||||
| code | Number | 0 | |||
| message | String | [0] 操作成功。 | |||
| member_tree | Array | 设备目录树 | |||
| name | Array | 设备名 sda sdb .... | ["sda","sdb"] | ||
| size | Number | 设备大小 | 1024000 | ||
| type | String | 设备类型 | disk | ||
| available | Number | 设备是否可用 | 1 | ||
| child_member | Array | 下一级设备 | |||
| name | Array | 下一级设备名 | ["sda1","sda2"] | ||
| size | Number | 下一级设备大小 | 202404 | ||
| type | Array | 下一级设备类型 | ["partition","disk"] | ||
| available | Number | 下一级设备是否可用 | 0 | ||
| child_member | Array | 下一级设备 | |||
| dev_id | String | 磁盘唯一标识 | 0x6000c2919f27425a4bfaae08d5516f45 |
新建存储池
SDK方法名：createStoragePool
URL
/storage_pool
Method
POST
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_name | String | 是 | 存储池名称 | ||
| physical_name | String | 是 | 物理名称 | ||
| pool_type | String | 是 | 存储池类型：BlockStorage CephStorage feature/story3759分支： CephStorage 改为 H3CX10000Storage | ||
| node_uuid | String | 关联节点uuid（可以为空） | |||
| ip | String | 是 | 备机地址:端口： 127.0.0.1:8080 或 [fd15:4ba5:5a2b:1008:fb06:77d:9d5c:eee7]:26821 | ||
| data_addr | String | 是 | 数据地址 | ||
| disk_list | Array | 是 | 磁盘列表 | ||
| name | String | 是 | 磁盘名称 | ||
| size | String | 是 | 磁盘大小 | ||
| type | String | 是 | 磁盘类型 | ||
| description | String | 备注 | |||
| storage_conf_ip | String | 【可选】存储管理地址ip，CephStorage（H3CX10000Storage）类型必传 | |||
| compress | Number | 是否开启压缩： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 0 | ||
| dedup | Number | 是否开启去重： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 0 | ||
| fc_as_target | Number | 是否作为fc客户端： 0：否； 1：是 | 0 | ||
| wwpn_info | Array | HBA卡WWPN信息 | |||
| tape_uuid | String | 关联的磁带库uuid | |||
| bind_lic_list | Array | 【可选】CBR许可 移动云备份需要 | |||
| os_user | String | 是 | 用户名 | ||
| os_pwd | String | 是 | 密码 | ||
| monitor_settings | Object | 移动云备份增加监控告警 | |||
| warn_sw | Number | 告警监控，默认关闭 1-开启 0-关闭 | 0 | ||
| usage_threshold | Number | 磁盘存储池使用率阈值 默认80% | 80 | ||
| storage_conf_user | String | 【可选】存储用户名 H3CX10000Storage类型必传 | |||
| storage_conf_password | String | 【可选】存储密码 H3CX10000Storage类型必传 | |||
| dev_id | String | 磁盘唯一标识 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| data | Object | ||||
| code | Number | 请求状态码 | 0 | ||
| message | String | ||||
| uuid | String | 新建存储池的uuid | |||
| wwpn_del_fail_list | Array | HBA卡WWPN删除失败列表 | |||
| code | String | code为11116814，提供强制删除 | |||
| message | String | 提示信息 | |||
| wwpn | String | HBA卡WWPN信息 | |||
| wwpn_create_fail_list | Array | HBA卡WWPN创建失败列表 | |||
| wwpn | String | HBA卡WWPN信息 | |||
| code | String | 错误码 | |||
| message | String | 提示信息 | |||
| msg | String | 请求消息 |
修改存储池
SDK方法名：modifyStoragePool;
URL
/storage_pool/:uuid([A-F0-9-]+)
Method
PUT
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_name | String | 是 | 存储池名称 | ||
| physical_name | String | 是 | 物理名称 | ||
| pool_type | String | 是 | 存储池类型：BlockStorage CephStorage feature/story3759分支： CephStorage 改为 H3CX10000Storage | ||
| node_uuid | String | 关联节点uuid | |||
| ip | String | 是 | 备机地址:端口;127.0.0.1:8080 | ||
| data_addr | String | 是 | 数据地址 | ||
| disk_list | Array | 是 | 磁盘列表 | ||
| name | String | 是 | 磁盘名称 | ||
| size | String | 是 | 磁盘大小 | ||
| type | String | 是 | 磁盘类型 | ||
| random_str | String | 是 | 修改操作标识 | ||
| description | String | 备注 | |||
| compress | Number | 是否开启压缩： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 0 | ||
| dedup | Number | 是否开启去重： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 0 | ||
| fc_as_target | Number | 是否作为fc客户端： 0：否； 1：是 | 0 | ||
| wwpn_info | Array | HBA卡WWPN信息 | |||
| tape_uuid | String | 关联的磁带库uuid | |||
| os_user | String | 是 | 用户名 | ||
| os_pwd | String | 是 | 密码 | ||
| monitor_settings | Object | 移动云备份增加监控告警 | |||
| warn_sw | String | 告警监控，默认关闭 1-开启 0-关闭 | |||
| usage_threshold | String | 磁盘存储池使用率阈值 默认80% | |||
| storage_conf_user | String | 【可选】存储用户名 H3CX10000Storage类型必传 | |||
| storage_conf_password | String | 【可选】存储密码 H3CX10000Storage类型必传 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| data | Object | ||||
| code | Number | 请求状态码 | 0 | ||
| message | String | ||||
| uuid | String | 存储池uuid | |||
| wwpn_del_fail_list | Array | HBA卡WWPN删除失败列表 | |||
| code | String | code为11116814，提供强制删除 | |||
| message | String | 提示信息 | |||
| wwpn | String | HBA卡WWPN信息 | |||
| wwpn_create_fail_list | Array | HBA卡WWPN创建失败列表 | |||
| wwpn | String | HBA卡WWPN信息 | |||
| code | String | 错误码 | |||
| message | String | 提示信息 | |||
| msg | String |
查看列表
SDK方法名：storagePoolList;
URL
/storage_pool
Method
GET
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| page | String | 页数 | |||
| limit | String | 每页条数 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| data | Object | ||||
| info_list | Array | ||||
| pool_uuid | String | 存储池uuid | @uuid | ||
| physical_name | String | 物理名称 | |||
| pool_name | String | 存储池名称 | @name | ||
| pool_type | String | 存储池类型 | storage | ||
| ip | String | 存储地址 | |||
| disk_list | Array | 磁盘列表 | |||
| name | String | 磁盘名称 | |||
| size | String | 磁盘大小 | |||
| type | String | 磁盘类型 | |||
| random_str | String | 修改操作标识 | |||
| description | String | 备注 | |||
| can_op | Number | 能否操作 | 1 | ||
| is_biz_admin | Number | 是否有管理员权限 | 1 | ||
| fc_as_target | Number | 是否作为fc客户端： 0：否； 1：是 | |||
| wwpn_info | Array | HBA卡WWPN信息 | |||
| total | Number | 列表同属 | 10 | ||
| code | Number | 错误码 | 0 | ||
| message | String | 错误信息 | |||
| msg | String | ||||
| ret | Number | 200 |
获取单个
SDK方法名：describeStoragePool;
URL
/storage_pool/:uuid([A-F0-9-]+)
Method
GET
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| msg | String | ||||
| data | Object | ||||
| message | String | 错误信息 | |||
| code | Number | 错误码 | 0 | ||
| storage_pool | Object | 存储池信息 | |||
| pool_uuid | String | 存储池uuid | |||
| physical_name | String | 物理名称 | |||
| pool_name | String | 存储池名称 | |||
| pool_type | String | 存储池类型 | |||
| node_uuid | String | 关联节点uuid | |||
| ip | String | 存储地址 | |||
| data_addr | String | 数据地址 | |||
| disk_list | Array | 磁盘列表 | |||
| name | String | 磁盘名称 | |||
| size | String | 磁盘大小 | |||
| type | String | 磁盘类型 | |||
| random_str | String | 修改标识 | |||
| description | String | 备注 | |||
| compress | Number | 是否开启压缩： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 1 | ||
| dedup | Number | 是否开启去重： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 1 | ||
| fc_as_target | Number | 是否作为fc客户端： 0：否； 1：是 | 0 | ||
| wwpn_info | Array | HBA卡WWPN信息 | |||
| tape_uuid | String | 关联的磁带库uuid | |||
| dev_id | String | wwn-0x6000c2919f27425a4bfaae08d5516f45 |
删除
SDK方法名：deleteStoragePool;
URL
/storage_pool
Method
DELETE
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_uuids | Array | 是 | 存储池uuid | ||
| force | Number | 是 | 1 - 强制删除 0 - 非强制删除 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| msg | String | ||||
| ret | Number | 200 | |||
| data | Object | ||||
| message | String | ||||
| code | Number | 11110001 | |||
| success_list | Array | 成功列表 | |||
| code | String | 11110001 | |||
| message | String | 删除成功 | |||
| pool_name | String | 存储池名称 | test2 | ||
| pool_uuid | String | 存储池uuid | BC92C981-D637-AC10-7CB0-450504DF8A3C | ||
| fail_list | Array | 失败列表 | |||
| code | String | 11110001 | |||
| message | String | 离线 | |||
| pool_name | String | 存储池名称 | test1 | ||
| pool_uuid | String | 存储池uuid | AB92C981-D637-AC10-7CB0-450504DF8A3C |
获取状态
SDK方法名：listStoragePoolStatus;
URL
/storage_pool/status
Method
GET
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_uuids | Array | 是 | 存储池uuid数组 | ||
| force_refresh | String | 点击操作栏刷新按钮必传，下发1，表示从rpc获取；其他情况不传 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| msg | String | ||||
| data | Object | ||||
| code | Number | 0 | |||
| message | String | [0] 操作成功。 | |||
| status | Array | 状态列表 | |||
| pool_uuid | String | 存储池uuid | 1E984F7D-436C-c4cA-eA2D-C42FE3ADce6B | ||
| status | String | UNKNOW：未知， CLOSED：已关闭， OFFLINE：离线， REMOVED：已移除， CANT_OPEN：无法开启， FAULTED：设备故障， DEGRADED：降级运行， HEALTHY：正常运行， UNAVAIL：无效， ONLINE:在线， CREATEFAILE：创建失败， CREATING： 创建中 EXTENDING： 扩容中 | CREATEFAILE | ||
| size | Number | 存储池大小，单位byte | 4294967296 | ||
| alloc | Number | 存储池已使用大小，单位byte | |||
| free | Number | 存储池可用大小，单位byte | 4294967296 | ||
| compress | Boolean | 是否开了了压缩。 | false | ||
| compress_rate | String | 压缩率 | |||
| dedup | Boolean | 是否开了了去重。 | false | ||
| dedup_rate | String | 删重率 | |||
| extend_result | String | 空：不提示 EXTEND_FAILED：提示扩容失败 EXTEND_SUCCESS：提示扩容成功 |
获取 fc 目标端 hba卡信息
SDK方法名：listHbaInfo;
URL
/storage_pool/hba_info
Method
GET
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ip | String | 是 | 127.0.0.1:8080 | ||
| os_user | String | ||||
| os_pwd | String |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| msg | String | ||||
| data | Object | ||||
| code | Number | 0 | |||
| message | String | [0] 操作成功。 | |||
| hba_info | Array | hba卡信息 | |||
| manufacturer | String | 制造商 | |||
| serial_number | String | 序列号 | test1 | ||
| model | String | 型号 | |||
| model_desc | String | 型号描述 | |||
| vec_nodes | Array | hba节点信息 | |||
| node_wwn | String | 节点唯一标识符 | test2 | ||
| vec_ports | Array | hba端口信息 | |||
| node_wwn | String | 节点唯一标识符 | |||
| port_wwn | String | 端口唯一标识符 | test3 | ||
| port_type | String | 端口类型 | |||
| port_state | String | 端口状态 | |||
| port_speed | String | 端口速度 | |||
| is_as_target | String | 是否已创建目标端； 0：否；1：是 |
删除fc_target
SDK方法名：deleteFcTarget;
URL
/storage_pool/fc_target
Method
DELETE
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_uuid | String | 否 | 存储池uuid | ||
| wwpn | String | ||||
| force | Number | 否 | 强制删除; 0：否； 1：是; | 1 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| data | Object | ||||
| code | Number | 0 | |||
| message | String | ||||
| msg | String |
存储池 - 操作
SDK方法名：operateStoragePool;
URL
/storage_pool/operate
Method
POST
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_uuids | Array | 是 | 存储池uuid | ||
| operate | String | 是 | reset：重新创建； extend：扩容 renew_key：更新公钥 | ||
| add_disk_list | Array | 【可选】扩容必传，下发参数参考新建时disk_list，为选择的磁盘信息 | |||
| name | String | 名称 | /dev/sdb | ||
| size | Number | 大小 | 2000398934016 | ||
| type | String | 类型 | disk |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| data | Object | ||||
| code | Number | 0 | |||
| message | String | ||||
| msg | String |
获取节点存储池列表
SDK方法名：storagePoolLoadPools;
URL
/storage_pool/load_pools
Method
GET
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| node_uuid | String | 是 | 节点uuid |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| msg | String | ||||
| data | Object | ||||
| code | Number | 0 | |||
| message | String | ||||
| pool_list | Array | 存储池列表 | |||
| pool_name | String | 存储池名称 | pool_name | ||
| pool_type | String | 存储池类型 | BlockStorage | ||
| disk_list | Array | 磁盘 | |||
| name | String | 名称 | sdb | ||
| size | Number | 容量 | 64424509440 | ||
| type | String | 类型 | disk | ||
| compress | Number | 压缩 | 0 | ||
| dedup | Number | 删重 | 0 | ||
| pool_size | Number | 存储池容量 | 64424509440 | ||
| pool_free | Number | 存储池剩余容量 | 32424735820 |
批量导入存储池
SDK方法名：storagePoolBatchImport;
URL
/storage_pool/batch_import
Method
POST
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_list | Array | 存储池列表 | |||
| pool_name | String | 是 | 存储池名称 | ||
| physical_name | String | 是 | 物理名称 | ||
| pool_type | String | 是 | 存储池类型：BlockStorage CephStorage feature/story3759分支： CephStorage 改为 H3CX10000Storage | ||
| node_uuid | String | 是 | 关联节点uuid | ||
| ip | String | 是 | 节点，管理地址：管理端口 | ||
| disk_list | Array | 是 | 磁盘列表 | ||
| name | String | 是 | 磁盘名称 | ||
| size | String | 是 | 磁盘大小 | ||
| type | String | 是 | 磁盘类型 | ||
| description | String | 备注 | |||
| data_addr | String | 是 | 节点数据地址 | ||
| compress | Number | 是否开启压缩： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 0 | ||
| dedup | Number | 是 | 是否开启去重： 0：关；1：开。默认不勾选（存储类型为“BlockStorage”时显示，暂不支持修改） | 0 | |
| fc_as_target | Number | 是否作为fc客户端： 0：否； 1：是 | 0 | ||
| storage_conf_ip | String | 【可选】存储管理地址ip，CephStorage（H3CX10000Storage）类型必传 | |||
| wwpn_info | Array | HBA卡WWPN信息 | |||
| tape_uuid | String | 关联的磁带库uuid | |||
| os_user | String | 是 | 用户名 | ||
| os_pwd | String | 是 | 密码 |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| msg | String | ||||
| data | Object | ||||
| code | Number | 错误码 | 0 | ||
| message | String | 错误信息 | |||
| success_list | Array | 成功列表 | |||
| pool_name | String | 存储池名称 | |||
| fail_list | Array | 失败列表 | |||
| pool_name | String | 存储池名称 |
存储池 - 更新配置项
SDK方法名：storagePoolUpdateConfig;
URL
/storage_pool/update_config
Method
PUT
Request
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| pool_uuid | String | 是 | 存储池uuid |
Response
| 名称 | 类型 | 必选 | 简介 | Mock初始值 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 200 | |||
| msg | String | ||||
| data | Object | ||||
| code | Number | 错误码 | 0 | ||
| message | String | 错误信息 |