删除逻辑库V3

功能介绍

删除指定的逻辑库，释放该逻辑库的所有资源。。

接口约束

无。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

• URL格式

  DELETE /v3/{project_id}/instances/{instance_id}/databases/{database_name}?delete_dn_data={delete_dn_data}

• 参数说明

  表1 路径参数

  参数	是否必选	参数类型	描述
  project_id	是	String	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	String	DDM实例ID。
  database_name	是	String	逻辑库名称。

  表2 Query参数

  参数	是否必选	参数类型	描述
  delete_dn_data	是	Boolean	是否同时删除关联后端数据库实例上存储的数据。 取值为true：删除。 取值false：不删除。

请求消息

• 请求参数

  无。

• URI样例
  • 删除逻辑库(删除关联后端数据库实例上存储的数据)。

    DELETE https://{endpoint}/v3/{project_id}/instances/{instance_id}/databases/{database_name}?delete_dn_data=true

  • 删除逻辑库(保留关联后端数据库实例上存储的数据)。

    DELETE https://{endpoint}/v3/{project_id}/instances/{instance_id}/databases/{database_name}?delete_dn_data=false

响应消息

• 正常响应参数说明

  表3 响应Body参数

  参数	参数类型	描述
  job_id	String	删除逻辑库的任务ID。
  database_name	String	逻辑库名。

• 正常响应示例

  {
   "job_id": "eff1d289-xxxx-xxxx-8b9f-463ea07c000c"，
    "database_name": "test"
  }

状态码

• 正常

  202

• 异常

  请参见状态码。

错误码

请参见错误码。