Help Center/ Elastic Cloud Server/ API Reference/ APIs/ Disk Management/ Querying the Number of Disks That Can Be Added to a Yearly/Monthly ECS
Updated on 2025-09-19 GMT+08:00

Querying the Number of Disks That Can Be Added to a Yearly/Monthly ECS

Function

This API is used to query the number of disks that can be added to a yearly/monthly ECS.

URI

GET /v1/{project_id}/cloudservers/{server_id}/appendvolumequota

Table 1 describes the parameters in the URI.

Table 1 Path parameters

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

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

server_id

Yes

Specifies the VM ID.

Request

None.

Response

Table 2 describes the response parameters.

Table 2 Response parameters

Parameter

Type

Description

free_scsi

Integer

Specifies the number of SCSI disks that can be attached.

count

Integer

Specifies the quantity.

free_blk

Integer

Specifies the number of block disks that can be attached.

Example Request

Query the number of disks that can be added to a yearly/monthly ECS.

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/appendvolumequota

Example Response

{
    "free_scsi": 1,
    "count": 1,
    "free_blk": 1
}

Error Codes

See Error Codes.