跳到主要内容

更新记录

本页记录本节接口的变更,最新的变更在最前面。更新调用这些接口的 Agent、skill 或脚本时,请先查看本页。

每条记录以日期为标题,可能包含以下几类:

类别含义
新增新的接口或新的可选字段。现有调用不受影响。
变更行为、字段或限制有变化。
弃用接口或字段仍可使用,但之后会移除。记录中会说明替代方案。
移除接口或字段已不可用。

可能导致现有调用失败的变更会标注 不兼容变更,并给出迁移步骤。

2026-11-12​

首次发布。API token 可调用 14 个类别共 79 个接口:

类别接口数
Query API5
查询结果3
查询历史5
计算集群5
组织与监控2
Catalog7
SQL Task2
账户3
组织2
账单4
工单7
任务流9
数据源12
数据集成任务13

每个接口的方法、路径、类型和权限级别见接口索引。

以下约定适用于所有接口,之后如有变更也会记录在本页:

  • token 通过 X-DATABENDCLOUD-TOKEN 请求头发送。同时携带 Authorization 请求头或 cookie 的请求会被拒绝。详见鉴权。
  • 请求有两种风格:v1 接口的组织 ID 在路径中;v2 接口使用 POST,组织 ID 放在 JSON 请求体的 orgSlug 字段。详见请求约定。
  • token 的 IP 白名单对所有接口生效。
  • 不在本节列表中的接口返回 HTTP 403。

本次发布中,以下控制台功能未对 API token 开放:审计日志搜索、工单附件、任务流的变更操作。详见 API Token 不能调用的接口。

欢迎体验 Databend Cloud

基于 Rust + 对象存储构建的新一代多模态数仓,一个平台即可进行 BI、向量、全文检索及地理空间分析。

支持标准 SQL,自动弹性伸缩,助您快速构建现代化数据平台。

注册即领 ¥200 代金券。

注册体验