百度日志服务BLS

    CreateFastQuery

    描述

    创建快速查询的实例名称必须遵循以下准则:

    • 每个账户每个区域快速查询名称不能相同
    • 快速查询名称长度不能超过128个字符
    • 快速查询名称包含的字符仅限于:a-z, A-Z, 0-9, '_', '-', '.'

    请求

    • 请求语法
    POST /v1/fastquery HTTP/1.1
    Host: <Endpoint>
    Authorization: <Authorization String>
    Content-Type: application/json; charset=utf-8
     
    {
      "fastQueryName": <fastQueryName>,
      "logStoreName": <logStoreName>,
      "logStreamName": <logStreamName>,
      "query": <query>,
      "description": <description>
    }
    • 请求头域

    除公共请求头域外,无其它特殊头域。

    • 请求参数
    参数名称 类型 是否必须 参数位置 描述
    fastQueryName String Yes RequestBody 快速查询名称
    query String Yes RequestBody 快速查询语句
    description String No RequestBody 信息描述
    logStoreName String Yes RequestBody 日志集名称
    logStreamName String No RequestBody 日志流名称

    响应

    • 响应头域

    除公共响应头域外,无其它特殊头域。

    • 响应参数

    错误码

    除了通用的错误码,还可能出现如下错误码:

    错误码 错误消息 描述 HTTP状态码
    FastQueryAlreadyExist FastQuery [fastQueryName] already exists FastQuery 已存在 409

    注:错误消息中 [fastQueryName] 部分会用具体的名称来替换

    示例

    • 请求示例
    POST /v1/fastquery HTTP/1.1
    Host: bls-log.bj.baidubce.com
    Authorization:bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
    Content-Type: application/json; charset=utf-8
     
    {
      "fastQueryName": "demo",
      "logStoreName": "test",
      "logStreamName": "my-stream1"
      "query": "select sum(bytes_in) where @timestamp > 1573104162010",
      "description": "sum bytes_in"
    }
    • 响应示例
    HTTP/1.1 201
    Content-Type: application/json; charset=utf-8
    X-Bce-Request-Id: 2eeba101-4cc7-4cfe-b5ac-a3be8d060e33
    Date: Fri, 10 Apr 2020 04:42:37 GMT
    上一篇
    LogRecord 相关接口
    下一篇
    DescribeFastQuery