Create Fast Query CreateFastQuery

Updated at：2025-11-03

Description

To create the fast query name, the following guidelines must be met:

Fast query names must be unique per account and per region.
The fast query name shall not be longer than 128 characters
Only these characters are permitted for fast query name: a-z, A-Z, 0-9, '_', '-', '.'"

Request

Request syntax

Http

1POST /v1/fastquery HTTP/1.1
2Host: <Endpoint>
3Authorization: <Authorization String>
4Content-Type: application/json; charset=utf-8
5
6{
7  "fastQueryName": <fastQueryName>,
8  "project": <project>,
9  "logStoreName": <logStoreName>,
10  "logStreamName": <logStreamName>,
11  "query": <query>,
12  "description": <description>
13}

Request headers

No additional headers are required beyond the standard request headers.

Request parameters

Parameter name	Types	Required or not	Parameter location	Description
fastQueryName	String	Yes	RequestBody	Fast query name
query	String	Yes	RequestBody	Fast query statement
description	String	No	RequestBody	Information description
project	String	No	RequestBody	Project name, default
logStoreName	String	Yes	RequestBody	Logstore name
logStreamName	String	No	RequestBody	Logstream name

Response

Response headers

No additional headers are required beyond the standard response headers.

Response parameters

None

Error code

Apart from standard error codes, the following codes may be returned:

Error code	Error message	Description	HTTP status code
FastQueryAlreadyExist	FastQuery [fastQueryName] already exists	FastQuery already exists	409

Note: [fastQueryName] in error message may be replaced with a specific name.

Example

Request example

Text

1POST /v1/fastquery HTTP/1.1
2Host: bls-log.bj.baidubce.com
3Authorization:bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
4Content-Type: application/json; charset=utf-8
5
6{
7  "fastQueryName": "demo",
8  "project": "default",
9  "logStoreName": "test",
10  "logStreamName": "my-stream1"
11  "query": "select sum(bytes_in) where @timestamp > 1573104162010",
12  "description": "sum bytes_in"
13}

Response example