Querying the Autoscaling Policy of Storage Space¶

Function¶

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

This API supports the following types of instances:

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

**Table 1** Path parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID, which can be obtained by calling the API described in Querying Instances and Details. If there are no instances available, call the API described in Creating an Instance to create one.

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

Status code: 200

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

**Table 4** AutoEnlargePolicy¶
Parameter	Type	Description
threshold	Integer	Threshold for triggering autoscaling.
step	Integer	Percentage increase (step%). When autoscaling is triggered, the database system automatically scales up the current storage space of your instance by step%. If the increased storage space is not a multiple of 10 GB, the system rounds it up to the nearest multiple of 10 GB. The default minimum increment is 100 GB.
size	Integer	Storage limit in GB that autoscaling can increase storage space to.

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.

last updated: 2024-12-10 15:07 UTC - commit: cf50b08f82e58871085516460cdd259d578714fa