数据集删除_V2

通过数据集 ID 删除指定数据集。V2 与原数据集删除接口共用删除处理逻辑；V2 支持 OAuth2 应用授权和集成 Token，并通过 X-Public-User-Id 指定操作用户。

鉴权与操作用户

选择一种鉴权方式；两种方式均须传入 X-Public-User-Id：

方式	凭证	要求
OAuth2 应用授权	`Authorization: Bearer <access_token>`	应用获得 `legacy-public-api:full-access` scope，凭证和应用有效，并满足许可、IP 白名单等授权要求。
集成 Token	`X-Public-Token: <集成Token>`	使用统一账户集成 Token，并满足该 Token 的校验要求。

X-Public-User-Id 传 Token 所属租户内的用户 loginId（登录账号），不是内部 uId；用户必须存在且启用，并具有数据集操作功能权限及目标数据集的管理权限。应用授权不会替代用户的资源权限校验。

OAuth2 获取 Token

使用已创建应用凭证的 client_id 和 client_secret，通过 HTTP Basic 认证申请 Token，授权类型为 client_credentials。TOKEN_ENDPOINT 使用应用凭证返回的 tokenEndpoint；默认对外地址为 https://<BI域名>/backend/oauth2/token，以目标环境配置为准。

读取响应中的 access_token，有效期以 expires_in 为准。这里需要 OAuth2 应用访问令牌，不是登录会话 Token 或个人访问 Token（PAT）。

OAuth2 删除示例

BI_BASE_URL 为 BI 服务对外 API 地址前缀；例如网关统一使用 /backend 时填写 https://<BI域名>/backend。

集成 Token 删除示例

请求参数

dsId：必填，待删除数据集的 ID，放在 URL 路径中。

无需请求体，也无需 Query 参数；不支持 force 参数。

删除规则

操作用户必须存在、启用，并具有数据集操作功能权限及目标数据集的管理权限。

删除前检查资源依赖。例如数据集被卡片（包括草稿卡片）、ETL、数据融合、SparkView 或层级树等资源使用时，接口可能返回依赖错误；需先解除相关依赖。

本接口删除数据集资源；如只需清空数据，请使用清空数据集数据接口。

返回结果

成功时返回：

{
  "result": "ok",
  "response": "DataSource deleted"
}

常见错误

情况	响应判断
操作用户不存在或停用、数据集不存在、无管理权限、存在阻止删除的依赖	通常 HTTP 200，`result=fail`，读取对象 `error` 中的业务错误码及消息。
集成 Token 缺失或无效	通常 HTTP 403，返回 `result/response/error` 包络。
OAuth2 Token 无效、过期或未通过认证	HTTP 401，`error` 为字符串，具体原因见 `message`。
OAuth2 scope 不足或应用授权校验失败	HTTP 403，`error` 为字符串，例如 `insufficient_scope`，具体原因见 `message`。
OAuth2 应用调用超过限制	HTTP 429，读取顶层 `error`、`message`、`status`。

OAuth2 鉴权错误与业务错误的结构不同，不能只检查 result 判断所有失败响应。

返回响应

🟢200业务处理结果

application/json

成功或业务失败；HTTP 200 时须继续检查 result。

Body

示例

删除成功数据集不存在

{
    "result": "ok",
    "response": "DataSource deleted"
}

🟠401OAuth2 认证失败

🟠403鉴权或授权失败

🟠429OAuth2 应用调用受限

鉴权与操作用户#

OAuth2 获取 Token#

OAuth2 删除示例#

集成 Token 删除示例#

请求参数#

删除规则#

返回结果#

常见错误#

请求参数

请求示例代码

返回响应

鉴权与操作用户

OAuth2 获取 Token

OAuth2 删除示例

集成 Token 删除示例

请求参数

删除规则

返回结果

常见错误