LogStore Operations
Updated at：2025-11-03
Create logstores
To create and name logstores, the following guidelines shall be met:
- Logstore names must be unique per account and per region
- The logstore name shall not be longer than 128 characters.
- Only the following characters can permitted for logstore names:
a-z, A-Z, 0-9, “_”, “-”, “.” - The logstore retention period can be set to a maximum of 3,650 days, indicating permanent retention. Unit: days.
Use the following code to create a LogStore and specify its retention period.
Go
1createLogStoreRequest := CreateLogStoreRequest{
2 Project: "default",
3 LogStoreName: "test",
4 Retention: 1,
5}
6err := BLS_CLIENT.CreateLogStoreV2(createLogStoreRequest)
7if err != nil {
8 fmt.Println("Create logStore failed: ", err)
9} else {
10 fmt.Println("Create logStore success.")
11}If you need to bind a tag when creating a LogStore, use the following code to set it up.
Go
1tag := model.TagModel{
2 TagKey: "key",
3 TagValue: "value",
4}
5tags := []model.TagModel{tag}
6createLogStoreRequest := CreateLogStoreRequest{
7 Project: DefaultProject,
8 LogStoreName: "sdk-logstore-test",
9 Retention: 1,
10 Tags: tags
11}
12err := BLS_CLIENT.CreateLogStoreV2(createLogStoreRequest)
13if err != nil {
14 fmt.Println("Create logStore failed: ", err)
15} else {
16 fmt.Println("Create logStore success.")
17}Prompt:
- Detailed parameter configuration and restrictions may refer to BLS API document Create Logstore
Update the specified logstore
With following codes, update the specified logstore, and currently support updating the associated retention period.
Go
1updateLogStoreRequest := UpdateLogStoreRequest{
2 Project: "default",
3 LogStoreName: "test",
4 Retention: 2,
5}
6err = BLS_CLIENT.UpdateLogStoreV2(updateLogStoreRequest)
7if err != nil {
8 fmt.Println("Update logStore failed: ", err)
9} else {
10 fmt.Println("Update logStore success.")
11}Prompt:
- Detailed parameter configuration and restrictions may refer to BLS API document Update LogStore
Query the specified logstore
With following codes, get the specified logstore details.
Go
1describeLogStoreRequest := DescribeLogStoreRequest{
2 Project: "default",
3 LogStoreName: "test",
4}
5res, err := BLS_CLIENT.DescribeLogStoreV2(describeLogStoreRequest)
6if err != nil {
7 fmt.Println("Get logStore failed: ", err)
8} else {
9 fmt.Println("LogStore info: ", res)
10}Prompt:
- Detailed parameter configuration and restrictions may refer to BLS API document Describe Logstore
Get logstore list
With following codes, obtain the logstore list of the current user.
Go
1//Optional parameter list
2listLogStoreRequest := ListLogStoreRequest{
3 Project: "default"
4 NamePattern: "bls-log",
5 Order: "asc",
6 OrderBy: "creationDateTime",
7 PageNo: 1,
8 PageSize: 10}
9res, err := BLS_CLIENT.ListLogStoreV2(listLogStoreRequest)
10if err != nil {
11 fmt.Println("Get logStore list failed: ", err)
12} else {
13 fmt.Println("List logStore success: ", res)
14}Prompt:
- Detailed parameter configuration and restrictions may refer to BLS API document List Logstore
Bulk obtain logstore details
With following codes, bulk obtain the logstore details of the current user
Go
1//Optional parameter list
2batchRequest := bls.BatchLogStoreRequest{
3 LogStores: []bls.BaseLogStore{
4 {
5 Project: "default",
6 LogStoreName: "bls-test",
7 },
8 },
9 }
10 res, err := BLS_CLIENT.GetLogStoreByProjects(batchRequest)
11 if err != nil {
12 fmt.Println("Batch get logStore failed: ", err)
13 } else {
14 fmt.Println("Batch get logStore success: ", res)
15 }Prompt:
- Detailed parameter configuration and restrictions may refer to BLS API document Batch Get Logstore
Delete logstores
With following codes, delete the specified logstore and permanently erase all associated logstores that have been stored.
Go
1deleteLogStoreRequest := DeleteLogStoreRequest{
2 Project: "default",
3 LogStoreName: "test",
4}
5err = BLS_CLIENT.DeleteLogStoreV2(deleteLogStoreRequest)
6if err != nil {
7 fmt.Println("Delete logStore failed: ", err)
8} else {
9 fmt.Println("Delete logStore success.")
10}Prompt:
- Detailed parameter configuration and restrictions may refer to BLS API document Delete Logstore