Setting the Recycle Bin Policy

API Description

This API is used to set the recycle bin policy for an instance.

URI

URI format
PUT https://{Endpoint}/v3/{project_id}/instances/recycle-policy

URI example

https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/recycle-policy

**Table 1** Request parameters
Name	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token obtained from IAM. For details, see Authentication.
project_id	Yes	String	Project ID of a tenant in a region. To obtain the project ID, see Obtaining a Project ID.

Requests

Parameter description

**Table 2** Request body parameters
Name	Mandatory	Type	Description
recycle_policy	Yes	Object	Instance recycling policy. For details, see Table 3.

**Table 3** RecyclePolicy
Name	Mandatory	Type	Description
enabled	Yes	Boolean	The recycling policy is enabled and cannot be disabled. true: The recycling policy is enabled.
retention_period_in_days	No	Integer	Policy retention duration (1 to 7 days). The value is a positive integer. If this parameter is left blank, the policy is retained for 7 days by default.

Example Request

Enabling the recycle bin policy and setting the retention period to three days

PUT https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/recycle-policy 
 
{ 
  "recycle_policy" : { 
    "enabled" : true, 
    "retention_period_in_days" : 3 
  } 
}