修改日志集UpdateLogStore
更新时间：2026-06-23
- 更新指定的日志集，目前支持更改与日志集关联的存储期限。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1PUT /v{version}/logstore/{logStoreName}?project={project} HTTP/1.1
2Host: xxx.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "retention": <retention>,
7 "shardCount": <shardCount>,
8 "maxShardCount": <maxShardCount>,
9 "disableShardAutoSplit": <disableShardAutoSplit>,
10 "indexEnabled": <indexEnabled>,
11 "hotRetention": <hotRetention>,
12 "tags": list<Tag>
13}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| project | String | 否 | Query参数 | 日志组名称，默认default |
| logStoreName | String | 是 | URL参数 | 日志集名称 |
| retention | Int | 是 | RequestBody参数 | 日志集的租期，最大3650天，表示永久保存。单位：天数 |
| tags | List<Tag> | 否 | RequestBody参数 | 待创建的标签列表，具体参数格式参见下述 |
| shardCount | Int | 否 | RequestBody参数 | 日志集初始shard数量，默认为1，最大值为50 |
| maxShardCount | Int | 否 | RequestBody参数 | 最大分片数量 |
| disableShardAutoSplit | Boolean | 否 | RequestBody参数 | 是否禁止自动分裂 |
| indexEnabled | Boolean | 否 | RequestBody参数 | 是否开启索引 |
| hotRetention | Int | 否 | RequestBody参数 | 热存时长 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 请求码，成功为OK，错误为具体的错误码 |
请求示例
Plain Text
1PUT /v1/logstore/demo?project=default 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}响应示例
Plain Text
1HTTP/1.1 200 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}评价此篇文章