V2

删除数据库

将数据库移入回收站，并返回软删除结果。

DELETE /v2/databases/:database_id

删除数据库

适用场景

当你要把数据库移入回收站，而不是永久删除时使用这个接口。它适合保留恢复空间和记录回收链路。

接口信息

项目	内容
方法	`DELETE`
路径	`/v2/databases/:database_id`
请求体	无
返回	`database` 删除结果
Scope	`databases.write`

权限要求

需要 databases.write。

请求参数

参数	类型	必填	说明
`database_id`	string	是	数据库 ID。

响应结果

{
  "object": "database",
  "id": "66666666-6666-4666-8666-666666666666",
  "in_trash": true
}

行为说明或限制

这是软删除，不会物理删除数据。
数据库下的记录也会一并进入回收站。
如果数据库已经在回收站中，重复删除仍会返回成功结果。

错误提示

401 unauthorized：token 无效或已过期。
403 forbidden：缺少 databases.write 或无权访问该数据库。
404 not_found：数据库不存在。
400 validation_error：目标对象不是数据库。

相关文档

前置阅读

获取数据库

下一步

更新数据库

相关参考

错误码