Updated on 2026-09-22 GMT+08:00

Querying the Autoscaling Policy of Storage Space

This API is used to query the autoscaling policy of storage space.

This API supports the following instance:

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

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
gaussdbfornosql:instance:getAutoExtendVolumePolicy	Read	instance *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	nosql:instance:list	-

GET /v3/{project_id}/instances/{instance_id}/disk-auto-expansion

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. Constraints N/A Range The value contains 32 characters. Only letters and digits are allowed. Default Value N/A
instance_id	Yes	String	Definition Instance ID. To obtain the value, call the Querying Instances and Details API. If no instance is available, call the Creating an Instance API to create one. Constraints N/A Range N/A Default Value N/A

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token You can obtain the token by calling the IAM API by following Obtaining a User Token Through Password Authentication. Constraints N/A Range N/A Default Value N/A

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
policy	Table 4 object	Definition Autoscaling policy for storage space. No information is returned if the autoscaling policy is disabled.

**Table 4** AutoEnlargePolicy
Parameter	Type	Description
threshold	Integer	Definition Threshold for triggering autoscaling, in percentage. Range The value of a GeminiDB Cassandra instance can be 80, 85, or 90. The value of a GeminiDB Redis instance can be 60, 65, 70, 75, 80, 85, or 90.
step	Integer	Definition Scale-up step size (%) The storage is automatically scaled up by a percentage you specify. The calculated value will be rounded up to a multiple of 10. At least 100 GB is added each time by default. NOTE: If there is insufficient balance in your account, storage space may fail to be scaled up for yearly/monthly instances. Range N/A
size	Integer	Definition Storage limit in GB that autoscaling can increase storage space to. Range N/A

URI example

GET https://{Endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/93e4b3eda14349b1b870f72829bc3b9bin06/disk-auto-expansion

Status code: 200

Success

{ 
  "policy" : { 
    "threshold" : 90, 
    "step" : 10, 
    "size" : 600 
  } 
}

For details, see Status Codes.

For details, see Error Codes.

Parent topic: Instances