Updating the Recycle Bin Policy

This API is used to update the recycle bin policy.

For details, see Calling APIs.

PUT /v2/{project_id}/recycle

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
retention_days	No	Integer	Definition Retention days. Constraints N/A Range 1–7 Default Value N/A
default_use_recycle	No	Boolean	Definition Whether to use the recycle bin. Constraints N/A Range true: Yes false: No Default Value N/A

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
retention_days	Integer	Definition Retention days. Range 1–7
default_use_recycle	Boolean	Definition Whether to use the recycle bin. Range true: Yes false: No
recycle_instances	Array of InstanceRecycleInfo objects	Definition Recycled instance list.

**Table 4** InstanceRecycleInfo
Parameter	Type	Description
instance_id	String	Definition Instance ID. Range N/A
status	String	Definition Instance status. Range For details, see Instance Status.
name	String	Definition Instance name. Range N/A
engine	String	Definition Message engine. Range rocketmq: RocketMQ message engine. reliability: RocketMQ message engine alias.
in_recycle_time	String	Definition Recycle time. Range N/A
save_time	Integer	Definition Retention period. Range 1–7
auto_delete_time	String	Definition Automatic deletion time. Range N/A
cost_per_hour	Double	Definition Hourly fee. Range N/A
error_message	String	Definition Error message. Range N/A
product_id	String	Definition Product ID. Range N/A

PUT https://{endpoint}/v2/{project_id}/recycle

{
  "retention_days" : 2,
  "default_use_recycle" : true
}

Status code: 200

Recycle bin instance list queried.

{
  "retention_days" : 2,
  "default_use_recycle" : true,
  "recycle_instances" : null
}

Status Code	Description
200	Recycle bin instance list queried.

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel