SLS 转 DQL¶

POST /api/v1/sls/convert

概述¶

将阿里云 SLS 查询语句转换为日志 DQL。该接口仅进行语法转换，不查询或修改工作空间数据。

参数名	类型	必选	说明
`DF-API-KEY`	string	是	API Key 标识。

Body 请求参数¶

参数名	类型	必选	说明
`query`	string	是	需要转换的阿里云 SLS 查询语句，不允许为空。
`indexes`	array	否	日志索引名称列表。省略或传入空数组时，生成的 DQL 不附加索引限制。

返回说明¶

转换结果位于响应的 content 中：

字段	类型	说明
`status`	string	转换状态，可能为 `exact`、`approximate` 或 `unsupported`。
`dql`	string	转换生成的日志 DQL；不支持当前语法时可能为空。
`diagnostics`	array	转换诊断信息，用于说明近似转换或不支持的语法。`exact` 且无诊断信息时返回空数组。

状态含义：

exact：生成的 DQL 与原 SLS 查询语句等价；
approximate：已生成近似 DQL，执行前应结合 diagnostics 确认语义差异；
unsupported：当前 SLS 语法不受支持，dql 可能为空。

转换结果固定使用日志命名空间 L。indexes 仅用于生成 DQL 文本，接口不会校验索引是否存在；后续执行转换结果时，仍由对应的数据查询接口进行权限和数据访问规则校验。

请求示例¶

curl 'https://openapi.guance.com/api/v1/sls/convert' \
  -H 'Content-Type: application/json' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-raw '{"query":"status:200","indexes":["default"]}'

响应示例¶

{
  "code": 200,
  "content": {
    "status": "exact",
    "dql": "L::re(`.*`):(*)",
    "diagnostics": []
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-XXXX"
}