更新时间:2025-08-21 GMT+08:00
分享

查询存储池列表

功能介绍

查询存储池列表。

  • 该接口支持企业项目细粒度权限的校验,具体细粒度请参见 ies:storagePool:list

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{domain_id}/storage-pools

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

String

path中租户的账号ID

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

每页的数量

marker

String

分页标识

sort_key

Array of strings

排序字段

sort_dir

Array of strings

排序方式,取值范围:

  • desc:降序

  • asc:升序

edge_site_id

String

边缘小站ID

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

storage_pools

Array of StoragePool objects

存储池列表

page_info

PageInfo object

分页信息

表5 StoragePool

参数

参数类型

描述

id

String

存储池ID

name

String

存储池名称

edge_site_id

String

边缘小站ID

storage_type

String

存储类型。

  • SAS:高IO

  • SSD:超高IO

  • SAS_SD:高IO(软件定义型专用)

  • SSD_SD:超高IO(软件定义型专用)

  • SAS_ARM:高IO(鲲鹏)

  • SSD_ARM:超高IO(鲲鹏)

  • VS_SMALL_CAP:边缘对象存储-小容量型

  • VS_MEDIUM_CAP:边缘对象存储-中容量型

  • VS_LARGE_CAP:边缘对象存储-大容量型

status

String

存储池状态。

  • CREATING:创建中

  • AVAILABLE:可用

  • EXPANDING:扩容中

  • PENDING_PAYMENT:待支付

  • FROZEN:已冻结

assigned_size

Integer

存储池大小。

当前购买的存储容量。

resource_spec_code

String

资源规格编码

product_info

ProductInfo object

商品归属产品属性信息

capacity

Integer

总容量

market_options

MarketOptions object

计费信息

created_at

DateTime

创建时间

updated_at

DateTime

更新时间

effected_at

DateTime

生效时间

表6 ProductInfo

参数

参数类型

描述

cloud_service_type

String

云服务类型

resource_type

String

资源类型

resource_spec_code

String

资源编码

表7 MarketOptions

参数

参数类型

描述

charge_mode

String

计费模式。

  • prepaid:包周期

prepaid_options

PrepaidOptions object

包周期计费信息

strategies

Array of Strategy objects

销售策略列表

表8 PrepaidOptions

参数

参数类型

描述

order_id

String

订单ID

product_id

String

产品ID

pay_mode

String

包周期付款类型

  • FULL: 全预付

  • HALF:半预付

  • PAID_BY_YEAR:按年付费

  • ZERO_PAID_BY_YEAR:零预付-按年

表9 Strategy

参数

参数类型

描述

status

String

运维状态说明:

  • FREEZE - 已冻结

scene

String

资源运营状态场景:

ARREAR:欠费场景;

POLICE:公安场景。

ILLEGAL:违规场景。

VERIFY:客户未实名认证冻结场景。

effect

String

资源运营功能:

DELETABLE:可删除

UNDELETABLE:不可删除

表10 PageInfo

参数

参数类型

描述

next_marker

String

下一页标识。

current_count

Integer

当前页数量。

请求示例

查询存储池列表

GET https://{ies_endpoint}/v1/{domain_id}/storage-pools

响应示例

状态码:200

successful operation

{
  "storage_pools" : [ {
    "id" : "d70a8f73-edef-4b71-beb3-7dbc22f0365e",
    "name" : "SAS-ojoiv",
    "edge_site_id" : "a4a36874-c41b-4295-9fd5-6823864fd564",
    "storage_type" : "SAS",
    "status" : "AVAILABLE",
    "assigned_size" : 36,
    "resource_spec_code" : "ies.blockstorage.gear1",
    "product_info" : {
      "cloud_service_type" : "hws.service.type.ies",
      "resource_type" : "hws.resource.type.iesvolume",
      "resource_spec_code" : "ies.blockstorage.gear1"
    },
    "capacity" : 144,
    "market_options" : {
      "charge_mode" : "prepaid",
      "prepaid_options" : {
        "order_id" : "CS2201181056V3SK6",
        "product_id" : "OFFI644832402269233154",
        "pay_mode" : "FULL"
      }
    },
    "created_at" : "2022-01-18T02:56:02.76091Z",
    "updated_at" : "2022-01-18T02:59:56.5601Z",
    "effected_at" : "2022-01-19T02:59:25Z"
  } ],
  "page_info" : {
    "current_count" : 1
  }
}

状态码

状态码

描述

200

successful operation

错误码

请参见错误码

相关文档