Help Center/ CloudPond/ API Reference/ API/ Storage Tiers/ Querying Storage Billing Tiers

Updated on 2025-12-08 GMT+08:00

View PDF

Querying Storage Billing Tiers

Function

This API returns only the supported storage billing tiers. You can specify the actual storage capacity.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

GET /v2/{domain_id}/storage-gears

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Account ID in the path.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
zone_code	No	String	Area code.
pay_mode	No	Array of strings	Billing mode.
period_num	No	Array of integers	Purchase duration.
limit	No	Integer	Page size.
marker	No	String	Pagination identifier.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
storage_gears	Array of StorageGearV2 objects	List of supported storage tiers.
page_info	PageInfo object	Pagination information.

**Table 5** StorageGearV2
Parameter	Type	Description
id	String	Storage tier ID.
gear	Integer	Storage tier, for example, 35 TB.
storage_type	String	Storage type. SAS: high I/O; SSD: ultra-high I/O
product_info	ProductInfo object	Attribute information about the product to which the offering belongs.
zone_code	String	Deployment area.
sale_cycles	Array of SaleCycle objects	Objects of the sales cycle.

**Table 6** ProductInfo
Parameter	Type	Description
cloud_service_type	String	Cloud service type.
resource_type	String	Resource type.
resource_spec_code	String	Resource code.

**Table 7** SaleCycle
Parameter	Type	Description
pay_mode	String	Yearly/Monthly payment. FULL: full upfront HALF: half upfront PAID_BY_YEAR: Yearly ZERO_PAID_BY_YEAR: zero upfront, yearly
period_type	String	Yearly/Monthly type. year
period_num	Integer	The number of sales cycles.

**Table 8** PageInfo
Parameter	Type	Description
next_marker	String	Next page marker.
current_count	Integer	Number of records on the current page.

Example Requests

Example request for querying storage billing tiers

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

Example Responses

Status code: 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
  }
}