Modifying the Automatic Disk Storage Expansion Configuration

Function

This API is used to modify the automatic disk storage expansion configuration covering whether this feature is enabled, the threshold, increase, and upper limit.

Calling Method

For details, see Calling APIs.

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

PUT /v2/{project_id}/instances/{instance_id}/auto-volume-expand

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
instance_id	Yes	String	Definition: Instance ID. You can call the API for querying all instances to obtain the instance ID. The instance ID is in the response body. Constraints: N/A Range: N/A Default Value: N/A
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID. Constraints: N/A Range: N/A Default Value: N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
auto_volume_expand_enable	Yes	Boolean	Definition: Whether to enable automatic disk storage expansion. Constraints: N/A Range: true: Yes false: No Default Value: N/A
expand_threshold	No	Integer	Definition: Threshold for triggering automatic disk storage expansion. Constraints: N/A Range: 20%–80% Default Value: N/A
max_volume_size	No	Integer	Definition: Upper limit of automatic disk storage expansion. Constraints: The value must be divisible by 100. Greater than the current instance disk capacity and less than the Number of nodes × 30,000. Range: N/A Default Value: N/A
expand_increment	No	Integer	Definition: Proportion of each automatic disk storage expansion. Constraints: N/A Range: 10%–100% Default Value: N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
-	String	Definition: Modification result. Range: success

Example Requests

Modifying the automatic disk storage expansion configuration

PUT https://{endpoint}/v2/{project_id}/instances/{instance_id}/auto-volume-expand

{
  "auto_volume_expand_enable" : true,
  "expand_increment" : 10,
  "expand_threshold" : 80,
  "max_volume_size" : 400
}