Update Index

Last Updated：2025-11-14

Description

Refresh the index of the specified logstore.

Request

Request syntax

PUT /v1/logstore/{logStoreName}/index?project={project} HTTP/1.1
Host: <Endpoint>
Authorization: <Authorization String>
Content-Type: application/json; charset=utf-8
{
  "fulltext": <Fulltext>,
  "fields": <Fields>,
  "caseSensitive" : <caseSensitive>,
  "includeChinese" : <includeChinese>,
  "separators" : <separators>
}

Request headers

The UpdateIndex API requires no special request header. For details on the common request headers of the BLS API, please refer to the standard headers documentation.

Request parameters

Parameter name	Types	Required or not	Parameter location	Description
project	String	No	Query	Project name, default
logStoreName	String	Yes	Path	Logstore name
fulltext	Boolean	No	RequestBody	Whether to enable the full-text index; true indicates “Enable”
fields	Object	No	RequestBody	Field name and type definition included in the field-level index
caseSensitive	Boolean	No	RequestBody	Whether to enable the case sensitive for full-text index; by default (false), disable the case sensitive
includeChinese	Boolean	No	RequestBody	Whether to include Chinese; by default (false), exclude Chinese
separators	String	No	RequestBody	Full-text tokenizer; if not filled, use the default tokenizer

Note: At least one of full-text index and field-level index must be enabled

Fields indicates a map object structure, key indicates a field name, and value indicates a logfield structure. The logfield structure is defined as follows:

Parameter name	Types	Required or not	Description
type	String	Yes	Field type, options: bool, long, text, float
caseSensitive	Boolean	No	Whether to enable the case sensitive for field; by default (false), disable the case sensitive
includeChinese	Boolean	No	Whether to include Chinese in field; by default (false), exclude Chinese
separators	String	No	Field tokenizer; if not filled, use the default tokenizer
dynamicMapping	Boolean	No	Whether to enable the json dynamic index; by default (false), it is disabled

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
IndexNotFound	LogStore index not found	LogStore index not exists	404

Example

Request example

PUT /v1/logstore/demo/index?project=default 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

{
  "fulltext": true,
  "caseSensitive" : true,
  "includeChinese" : true,
  "separators" : "@&?",
  "fields": {
    "age": {
      "type": "long",
      "caseSensitive" : true,
      "includeChinese" : true,
      "separators" : "@&?",
      "dynamicMapping" : false
    },
    "salary": {
      "type": "float",
      "caseSensitive" : true,
      "includeChinese" : false,
      "separators" : "@&?|#()='\",;:<>[]{}/ \n\t\r\\",
      "dynamicMapping" : false
    }
  }
}

Response example

HTTP/1.1 204
Content-Type: application/json; charset=utf-8

Create Index

Delete Index

百度智能云

Log Service