
# 查询存储池列表 - ListStoragePoolsV2
#### 功能介绍
查询存储池列表。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IES/doc?api=ListStoragePoolsV2)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cloudpond/ies_05_0800.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                           | 访问级别 | 资源类型（\*为必须） | 条件键                   | 别名                   | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | ies:edgeSite:listStoragePools | List | edgeSite \* | g:EnterpriseProjectId | ies:storagePool:list | -      |
     
  
 
#### URI
GET /v2/{domain_id}/storage-pools
表1路径参数 
| 参数        | 是否必选 | 参数类型   | 描述           |
|:---|:---|:---|:---|
| domain_id | 是    | String | path中租户的账号ID |
   
表2Query参数 
| 参数                | 是否必选 | 参数类型             | 描述               |
|:---|:---|:---|:---|
| edge_site_id      | 否    | String           | 边缘小站ID           |
| delivery_order_id | 否    | String           | 交易单ID            |
| limit             | 否    | Integer          | 每页的数量            |
| marker            | 否    | String           | 分页标识             |
| status            | 否    | Array of strings | 根据存储池状态查询，支持多值查询 |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数            | 参数类型                                                                          | 描述    |
|:---|:---|:---|
| storage_pools | Array of [StoragePoolV2] objects | 存储池列表 |
| page_info     | [PageInfo] object                     | 分页信息  |
   
 表5StoragePoolV2 
| 参数             | 参数类型                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| id             | String                                                              | 存储池ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| name           | String                                                              | 存储池名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| edge_site_id   | String                                                              | 边缘小站ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| storage_type   | String                                                              | 存储类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| status         | String                                                              | 存储池状态。 - CREATING：创建中   - AVAILABLE：可用   - EXPANDING：扩容中   - PENDING_PAYMENT：待支付   - FROZEN：已冻结    |
| assigned_size  | Integer                                                             | 存储池大小。 当前已购买的存储容量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| product_info   | [ProductInfo] object     | 商品归属产品属性信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| capacity       | Integer                                                             | 总容量                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| market_options | [MarketOptions] object | 计费信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| created_at     | String                                                              | 创建时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| updated_at     | String                                                              | 更新时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| parent_id      | String                                                              | 扩容场景预生成存储池关联的存储池ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表6ProductInfo 
| 参数                 | 参数类型   | 描述    |
|:---|:---|:---|
| cloud_service_type | String | 云服务类型 |
| resource_type      | String | 资源类型  |
| resource_spec_code | String | 资源编码  |
   
 表7MarketOptions 
| 参数              | 参数类型                                                                  | 描述                                                                                                                                                                                                                                     |
|:---|:---|:---|
| charge_mode     | String                                                                | 计费模式。 - prepaid：包周期    |
| prepaid_options | [PrepaidOptions] object | 包周期计费信息                                                                                                                                                                                                                                |
| strategies      | Array of [Strategy] objects   | 销售策略列表                                                                                                                                                                                                                                 |
   
 表8PrepaidOptions 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| order_id   | String | 订单ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| product_id | String | 产品ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| pay_mode   | String | 包周期付款类型 - FULL: 全预付   - HALF：半预付   - PAID_BY_YEAR：按年付费   - ZERO_PAID_BY_YEAR：零预付-按年   - ZERO_PAID_BY_MONTH：零预付-按月    |
   
 表9Strategy 
| 参数     | 参数类型   | 描述                                                                                                                                                                                                                                        |
|:---|:---|:---|
| status | String | 运维状态说明： - FREEZE - 已冻结    |
| scene  | String | 资源运营状态场景： ARREAR：欠费场景； POLICE：公安场景。 ILLEGAL：违规场景。 VERIFY：客户未实名认证冻结场景。             |
| effect | String | 资源运营功能： DELETABLE：可删除 UNDELETABLE：不可删除                                                                                                                        |
   
 表10PageInfo 
| 参数            | 参数类型    | 描述     |
|:---|:---|:---|
| next_marker   | String  | 下一页标识。 |
| current_count | Integer | 当前页数量。 |
   
#### 请求示例
查询存储池列表
```
GET https://{ies_endpoint}/v2/{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,
    "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"
      }
    }
  } ],
  "page_info" : {
    "current_count" : 1
  }
}
```
#### 状态码
| 状态码 | 描述                   |
|:---|:---|
| 200 | successful operation |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cloudpond/ErrorCode.html)。
