Listing Storage Pools

Function

This API is used to list storage pools.

This API supports fine-grained permissions for enterprise projects. For details, see ies:storagePool:list.

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 /v1/{domain_id}/storage-pools

**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
limit	No	Integer	Page size.
marker	No	String	Pagination identifier.
sort_key	No	Array of strings	Sorting field.
sort_dir	No	Array of strings	Sorting order. The options are as follows: desc: descending order asc: ascending order
edge_site_id	No	String	Edge site ID

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_pools	Array of StoragePool objects	Storage pool list
page_info	PageInfo object	Pagination information.

**Table 5** StoragePool
Parameter	Type	Description
id	String	Storage pool ID.
name	String	Storage pool name
edge_site_id	String	Edge site ID
storage_type	String	Storage type. SAS: High I/O SSD: Ultra-high I/O SAS_SD: High I/O (software-defined) SSD_SD: Ultra-high I/O (software-defined) SAS_ARM: High I/O (Kunpeng) SSD_ARM: Ultra-high I/O (Kunpeng) VS_SMALL_CAP: Edge object storage (small-capacity) VS_MEDIUM_CAP: Edge object storage (medium-capacity) VS_LARGE_CAP: Edge object storage (large-capacity) CBR_STANDARD_SMALL_CAP: Cloud Backup and Recovery (basic edition) (small-capacity) CBR_STANDARD_MEDIUM_CAP: Cloud Backup and Recovery (basic edition) (medium-capacity) CBR_STANDARD_LARGE_CAP: Cloud Backup and Recovery (basic edition) (large-capacity) CBR_PROFESSIONAL_SMALL_CAP: Cloud Backup and Recovery (professional edition) (small-capacity) CBR_PROFESSIONAL_MEDIUM_CAP: Cloud Backup and Recovery (professional edition) (medium-capacity) CBR_PROFESSIONAL_LARGE_CAP: Cloud Backup and Recovery (professional edition) (large-capacity)
status	String	Storage pool statuses: CREATING: creating AVAILABLE: available EXPANDING: being expanded PENDING_PAYMENT: Pending payment FROZEN: frozen
assigned_size	Integer	Storage pool size Purchased storage capacity
resource_spec_code	String	Resource specifications code
product_info	ProductInfo object	Attribute information about the product to which the offering belongs.
capacity	Integer	Total capacity
market_options	MarketOptions object	Billing
created_at	String	Time when the storage pool was created
updated_at	String	Time when the storage pool was updated
effected_at	String	Time when the storage pool took effect

**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** MarketOptions
Parameter	Type	Description
charge_mode	String	Billing mode. prepaid: yearly/monthly
prepaid_options	PrepaidOptions object	Yearly/Monthly billing.
strategies	Array of Strategy objects	The list of sales policies.

**Table 8** PrepaidOptions
Parameter	Type	Description
order_id	String	Order ID
product_id	String	Product ID
pay_mode	String	Yearly/Monthly payment. FULL: full upfront HALF: half upfront PAID_BY_YEAR: Yearly ZERO_PAID_BY_YEAR: zero upfront, yearly

**Table 9** Strategy
Parameter	Type	Description
status	String	O&M status: FREEZE: frozen
scene	String	Resource operations status: ARREAR: The account is in arrears. POLICE: public security. ILLEGAL: violation scenario. VERIFY: The resource is frozen because the user fails to pass the real-name authentication.
effect	String	Resource operations: DELETABLE: deletable UNDELETABLE: unable to delete

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

Example Requests

Listing storage pools

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

Example Responses

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