创建日志集CreateLogStore
更新时间：2026-06-23
-
创建日志集，命名日志集时，需要遵循以下准则：
- 每个账户每个区域的日志集名称不能重复
- 日志集名称长度不能超过 128 个字符
- 日志集名称包含的字符仅限于： a-z, A-Z, 0-9, '_', '-', '.'
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/logstore?clientToken={clientToken} HTTP/1.1
2Host: xxx.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "project": <project>,
7 "logStoreName": <LogStoreName>,
8 "retention": <Retention>,
9 "tags": List<Tag>,
10 "index": <Index>
11 "shardCount" : 1,
12}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| project | String | 否 | RequestBody参数 | 日志组名称，默认default |
| logStoreName | String | 是 | RequestBody参数 | 日志集名称 |
| retention | Int | 是 | RequestBody参数 | 日志集的租期，最大3650天，表示永久保存。单位：天数 |
| tags | List<Tag> | 否 | RequestBody参数 | 待创建的标签列表，具体参数格式参见下述 |
| index | Index | 否 | RequestBody参数 | 日志集索引 |
| shardCount | Int | 否 | RequestBody参数 | 日志集初始shard数量，默认为1，最大值为50 |
| maxShardCount | Int | 否 | RequestBody参数 | 最大分片数量 |
| disableShardAutoSplit | Boolean | 否 | RequestBody参数 | 是否禁止自动分裂 |
| indexEnabled | Boolean | 否 | RequestBody参数 | 是否开启索引 |
| hotRetention | Int | 否 | RequestBody参数 | 热存时长 |
| EnableHotRetention | Boolean | 否 | RequestBody参数 | 是否开启热存 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 请求码，成功为OK，错误为具体的错误码 |
请求示例
Plain Text
1POST /v1/logstore HTTP/1.1
2HOST bls-log.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "project": "default",
7 "logStoreName": "demo",
8 "retention": 10,
9 "shardCount": 2,
10 "maxShardCount": 50,
11 "disableShardAutoSplit": true,
12 "indexEnabled": true,
13 "hotRetention": 7,
14 "tags": [
15 {
16 "tagKey": "tagKey",
17 "tagValue": "tagValue"
18 }
19 ]
20 "index": {
21 "fulltext": true,
22 "caseSensitive" : true,
23 "includeChinese" : true,
24 "separators" : "@&?",
25 "fields": {
26 "age": {
27 "type": "long",
28 "caseSensitive" : true,
29 "includeChinese" : true,
30 "separators" : "@&?",
31 "dynamicMapping" : false
32 },
33 "salary": {
34 "type": "float",
35 "caseSensitive" : true,
36 "includeChinese" : false,
37 "separators" : "@&?|#()='\",;:<>[]{}/ \n\t\r\\",
38 "dynamicMapping" : false
39 }
40 }
41 }
42}响应示例
Plain Text
1HTTP/1.1 201 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6
7{
8 "success": true
9 "code": "OK"
10}评价此篇文章