List LogStore

Last Updated：2025-11-14

Description

Retrieve the list of logstores accessible to the current user.

Request

Request syntax

GET /v1/logstore HTTP/1.1
Host: <Endpoint>
Authorization: <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

GET /v1/logstore?project=default&namePattern=demo&order=asc&orderBy=creationDateTime&pageNo=1&pageSize=10 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

Response example

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

{
  "order": "asc",
  "orderBy": "creationDateTime",
  "pageNo": 1,
  "pageSize": 10,
  "result": [
    {
      "creationDateTime": "2019-09-10T15:30:20Z",
      "lastModifiedTime": "2019-09-10T15:30:20Z",
      "project": "default",
      "logStoreName": "demo1",
      "retention": 7,
      "billingResource": {
           "id": "billingResourceId1",
           "shortId": "billingShortId1"
      },
      "tags": [
        {
            "tagKey": "tagKey",
            "tagValue": "tagValue"
        }
      ]
    },
    {
      "creationDateTime": "2019-09-10T15:35:20Z",
      "lastModifiedTime": "2019-09-10T15:35:20Z",
      "project": "default",
      "logStoreName": "demo2",
      "retention": 15,
      "billingResource": {
           "id": "billingResourceId2",
           "shortId": "billingShortId2"
      },
      "tags": [
        {
            "tagKey": "tagKey",
            "tagValue": "tagValue"
        }
      ]
    }
  ],
  "totalCount": 2
}

Describe LogStore

LogRecord Related APIs

百度智能云

Log Service