Help Center/ GaussDB/ API Reference/ APIs (Recommended)/ Recycle Bin/ Querying the Recycling Policy
Updated on 2025-08-18 GMT+08:00
View PDF

Querying the Recycling Policy

Function

This API is used to query the recycling policy. Before calling this API:

URI

GET https://{Endpoint}/v3/{project_id}/recycle-policy

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Explanation:

Project ID of a tenant in a region.

For details about how to obtain the project ID, see Obtaining a Project ID.

Restrictions:

None

Value range:

The value can contain 32 characters. Only letters and digits are allowed.

Default value:

None

Request Parameters

None

Response Parameters

Table 2 Parameter description

Parameter

Type

Description

retention_period_in_days

String

Explanation:

Deleted instance retention period.

Value range:

1 to 7

Example Request

Querying the recycling policy

GET https://gaussdb-opengauss.eu-west-101.myhuaweicloud.eu/v3/0611f1bd8b00d5d32f17c017f15b599f/recycle-policy

Example Response

Recycling policy queried.

{
	"retention_period_in_days": "5"
}

Status Code

Error Code

For details, see Error Codes.

Parent topic: Recycle Bin