文档首页/ CloudPond云服务/ API参考/ API/ 存储档位/ 查询存储计费档位 - ListStorageGears
更新时间：2025-10-28 GMT+08:00
查看PDF
分享

查询存储计费档位 - ListStorageGears

功能介绍

该接口仅返回支持的存储计费档位，实际可购买的存储容量单独定义。

URI

GET /v2/{domain_id}/storage-gears

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

path中租户的账号ID
表2 Query参数

参数

是否必选

参数类型

描述

zone_code

否

String

地区编码

pay_mode

否

Array of strings

付费模式

period_num

否

Array of integers

购买时长

limit

否

Integer

每页的数量

marker

否

String

分页标识

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

storage_gears

Array of StorageGearV2 objects

支持的存储档位列表

page_info

PageInfo object

分页信息
表5 StorageGearV2

参数

参数类型

描述

id

String

存储档位ID

gear

Integer

存储阶梯值, 如：35TB

storage_type

String

存储类型。SAS:高IO，SSD：超高IO

product_info

ProductInfo object

商品归属产品属性信息

zone_code

String

部署地区

sale_cycles

Array of SaleCycle objects

销售周期对象
表6 ProductInfo

参数

参数类型

描述

cloud_service_type

String

云服务类型

resource_type

String

资源类型

resource_spec_code

String

资源编码
表7 SaleCycle

参数

参数类型

描述

pay_mode

String

包周期付款类型

  • FULL: 全预付

  • HALF：半预付

  • PAID_BY_YEAR：按年付费

  • ZERO_PAID_BY_YEAR：零预付-按年

period_type

String

包周期类型

  • year：包年

period_num

Integer

周期数量
表8 PageInfo

参数

参数类型

描述

next_marker

String

下一页标识。

current_count

Integer

当前页数量。

请求示例

查询存储计费档位

GET https://{ies_endpoint}/v2/{domain_id}/storage-gears

响应示例

状态码：200

successful operation

{
  "storage_gears" : [ {
    "id" : "00000000-0000-000-0000-000000000000",
    "gear" : 35,
    "storage_type" : "SAS",
    "product_info" : {
      "cloud_service_type" : "hws.service.type.ies",
      "resource_type" : "hws.resource.type.iesvolume",
      "resource_spec_code" : "ies.blockstorage.gear1"
    },
    "zone_code" : "CN",
    "sale_cycles" : [ {
      "pay_mode" : "FULL",
      "period_type" : "year",
      "period_num" : 3
    } ]
  } ],
  "page_info" : {
    "current_count" : 1
  }
}

状态码

状态码

描述

200

successful operation

错误码

请参见错误码。

父主题： 存储档位