List LogStore
Updated at：2025-11-03
Description
Retrieve the list of logstores accessible to the current user.
Request
- Request syntax
Text
1GET /v1/logstore HTTP/1.1
2Host: <Endpoint>
3Authorization: <Authorization String>- Request headers
No additional headers are required beyond the standard request headers.
- Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| project | String | No | Query | Specify the keywords for project filtering |
| namePattern | String | No | Query | Specify the keywords for logstore filtering |
| billingShortId | String | No | Query | Specify the abbreviated resource ID for logstore filtering |
| order | String | No | Query | Sort rule, desc: descending; asc: ascending; default: desc |
| orderBy | String | No | Query | Sorting field, defaulting to creation time |
| pageNo | Int | No | Query | Start page, default: 1 |
| pageSize | Int | No | Query | Data volume shown on each page, default: 10 |
Response
- Response headers
No additional headers are required beyond the standard response headers.
- Response parameters
| Parameter name | Types | Description |
|---|---|---|
| order | String | Sort rule, desc: descending; asc: ascending |
| orderBy | String | Sorting field |
| pageNo | Int | Start page |
| pageSize | Int | Data volume shown on each page |
| totalCount | Int | Total entries |
| result | List<LogStore> | Logstore list |
The element structure of each logstore in the result array in the above table is as follows:
| Field name | Types | Description |
|---|---|---|
| creationDateTime | DateTime | Logstore creation datetime |
| lastModifiedTime | DateTime | Last modification datetime |
| project | String | Project name |
| billingResource | BillingResource | Logstore resources |
| logStoreName | String | Logstore name |
| retention | Int | Storage time |
| tags | List<Tag> | Tag list |
The element structure of each tag in tags array in the above table is as follows:
| Field name | Types | Description |
|---|---|---|
| tagKey | String | Tag key |
| tagValue | String | Tag value |
The element structure of BillingResource in the above table is as follows:
| Field name | Types | Description |
|---|---|---|
| id | String | Resource ID |
| shortId | String | Abbreviated resource ID |
Error code
No special error codes are returned beyond standard error codes.
Example
- Request example
Text
1GET /v1/logstore?project=default&namePattern=demo&order=asc&orderBy=creationDateTime&pageNo=1&pageSize=10 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- Response example
Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3
4{
5 "order": "asc",
6 "orderBy": "creationDateTime",
7 "pageNo": 1,
8 "pageSize": 10,
9 "result": [
10 {
11 "creationDateTime": "2019-09-10T15:30:20Z",
12 "lastModifiedTime": "2019-09-10T15:30:20Z",
13 "project": "default",
14 "logStoreName": "demo1",
15 "retention": 7,
16 "billingResource": {
17 "id": "billingResourceId1",
18 "shortId": "billingShortId1"
19 },
20 "tags": [
21 {
22 "tagKey": "tagKey",
23 "tagValue": "tagValue"
24 }
25 ]
26 },
27 {
28 "creationDateTime": "2019-09-10T15:35:20Z",
29 "lastModifiedTime": "2019-09-10T15:35:20Z",
30 "project": "default",
31 "logStoreName": "demo2",
32 "retention": 15,
33 "billingResource": {
34 "id": "billingResourceId2",
35 "shortId": "billingShortId2"
36 },
37 "tags": [
38 {
39 "tagKey": "tagKey",
40 "tagValue": "tagValue"
41 }
42 ]
43 }
44 ],
45 "totalCount": 2
46}