Updated on 2025-09-04 GMT+08:00

Modifying Recycling Policy

This API is used to modify the recycling policy for the recycle bin.

Parameter description

**Table 1** Parameters
Parameter	Mandatory	Description
project_id	Yes	Definition Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A

**Table 2** Parameters
Parameter	Mandatory	Type	Description
recycle_policy	Yes	Object	Definition Each element is associated with the recycle bin. For details on the element structure, see Table 3. Constraints N/A

**Table 3** recycle_policy elements
Parameter	Mandatory	Type	Description
retention_period_in_days	No	String	Definition Retention days of deleted instances. Constraints N/A Range The value is an integer ranging from 1 to 7. Default Value If this parameter is left blank, the retention period is 7 days by default.

Set the retention period of instances in the recycle bin to one day.

{
     "recycle_policy":{
                 "retention_period_in_days":"1"
               }
}

**Table 4** Parameters
Parameter	Type	Description
result	String	Definition Calling result. Range success: The API is successfully called.

For details, see Error Codes.