Help Center> Dedicated Distributed Storage Service> API Reference> API Description> Obtaining Details of a DSS Storage Pool
View PDF

Obtaining Details of a DSS Storage Pool

Function

This API is used to obtain the details of a specified DSS storage pool.

URI

GET /v1/{project_id}/pools/{dss_id}

Table 1 describes the parameters.
Table 1 Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

For details about how to obtain the project ID, see Obtaining a Project ID.

dss_id

Yes

String

Specifies the storage pool ID.

Request

Request parameters

Table 2 describes the request parameter.
Table 2 Request parameter

Parameter

Mandatory

Type

Description

usage

No

Boolean

Specifies whether the storage pool capacity information is returned. The value can be true or false. Value true indicates to return the capacity information. The default value is false.

Example request

GET https://{endpoint}/v1/{project_id}/pools/{dss_id}?usage=true

Response

Response parameters

Table 3 describes the response parameters.
Table 3 Response parameters

Parameter

Type

Description

name

String

Specifies the storage pool name.

id

String

Specifies the storage pool ID.

project_id

String

Specifies the ID of the project that the pool belongs.

capacity

Integer

Specifies the requested storage pool capacity, in GB.

type

String

Specifies the storage pool type. The value can be SAS or SSD.

  • SAS: high I/O storage pool
  • SSD: ultra-high I/O storage pool

status

String

Specifies the storage pool status. For details, see DSS Storage Pool Status.

availability_zone

String

Specifies the AZ where the storage pool resides.

created_at

String

Specifies the time when the storage pool was created.

Time format: UTC YYYY-MM-DDTHH:MM:SS

total_capacity_gb

Integer

Specifies the total capacity of the storage pool, in GB. (This parameter is not returned if the storage pool status is deploying.)

used_capacity_gb

Integer

Specifies the used capacity of the storage pool, in GB. (This parameter is not returned if the storage pool status is deploying.)

provisioned_capacity_gb

Integer

Specifies the allocated capacity of the storage pool, in GB. (This parameter is not returned if the storage pool status is deploying.)

max_over_subscription_ratio

Float

Specifies the overcommitment ratio of the storage pool. (This parameter is not returned if the storage pool status is deploying.)
  • Example response 
    {
   "name" : "dedicatedStorage01",
   "id" : "c950ee97-587c-4f24-8a74-3367e3da570f",
   "project_id" : "63d910f2705a487ebe4e1c274748d9e1",
   "capacity" : 100,
   "type" : "SATA",
   "availability_zone" : "AZ1",
   "status" : "available",
   "created_at" : "2014-12-18T15:57:56.299000",
   "total_capacity_gb": 1000,
   "used_capacity_gb": 300,
   "provisioned_capacity_gb":700,
   "max_over_subscription_ratio": 1.0
}
  • Error response 
    {
  "error": {
    "message": "invalid dss id!",
    "code": "DSS.1001"
  }
}

Returned Values

Error Codes

See Error Codes.

Parent topic: API Description