文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 备份与恢复/ 设置回收策略
更新时间：2025-10-17 GMT+08:00
查看PDF
分享

设置回收策略

功能介绍

设置已删除实例保留天数，修改保留天数后删除的实例按照新的天数来保留，修改之前已在回收站的实例保留天数不变。

接口约束

设置已删除实例保留天数，可设置范围1~7天。

URI

PUT /v3/{project_id}/instances/recycle-policy

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

用户在某一region下的project ID。获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

通过调用IAM服务获取用户Token接口获取。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

recycle_policy

是

object

参数解释：

回收策略。详情请参考表4。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 RecyclePolicy

参数

是否必选

参数类型

描述

retention_period_in_days

否

Integer

参数解释：

策略保持时长，单位为天。

约束限制：

不涉及。

取值范围：

1~7。

默认取值：

7。

响应参数

状态码：200

无响应参数。

请求示例

  • URI样例 
    PUT https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/recycle-policy
  • 设置回收站实例保留天数为3天 
    {
  "recycle_policy": {
    "retention_period_in_days": 3
  }
}

响应示例

无。

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 备份与恢复

相关文档