调用ListLogstores接口列出指定Project下的所有Logstore的名称。

请求语法

GET /logstores HTTP/1.1
Authorization: <AuthorizationString> 
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

请求参数

  • 请求头

    ListLogstore接口无特有请求头。关于Log Service API的公共请求头,请参见公共请求头

  • 参数列表
    参数名称 类型 是否必须 示例值 描述
    offset int 返回记录的起始位置,从0开始。
    size int 每页返回最大条目,默认值为最大值500。
    ProjectName string test-project 用于请求的Project名称(支持部分匹配)。

返回数据

  • 响应头

    ListLogstore接口无特有响应头。关于Log Service API的公共响应头,请参见公共响应头

  • 响应元素
    HTTP状态码返回200则请求成功,其响应Body会包括指定Project下的所有Logstore名称列表,具体如下:
    名称 类型 示例值 描述
    count int 1 当前页返回的Logstore数目。
    total int 1 Logstore总数。
    logstores array test-logstore 返回的Logstore名称列表。

示例

  • 请求示例
    GET /logstores HTTP/1.1
    Header: 
    {
    x-log-apiversion=0.6.0, 
    Authorization=LOG <yourAccessKeyId>:<yourSignature>, 
    Host=ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com, 
    Date=Wed, 11 Nov 2015 08:09:39 GMT, 
    Content-Length=0, 
    x-log-signaturemethod=hmac-sha1, 
    User-Agent=sls-java-sdk-v-0.6.0, 
    Content-Type=application/json
    }
  • 正常返回示例
    HTTP/1.1 200 OK
    Header: 
    {
    Date=Wed, 11 Nov 2015 08:09:39 GMT, 
    Content-Length=52, 
    x-log-requestid=5642F7C399248C8D7B01342F, 
    Connection=close, 
    Content-Type=application/json, 
    Server=nginx/1.6.1
    }
    Body:
    {
    "count":1,
    "logstores":["test-logstore"],
    "total":1
    }

错误码

HTTP状态码 错误码 错误信息 描述
404 ProjectNotExist Project {ProjectName} does not exist. 项目不存在。
500 InternalServerError Specified Server Error Message. 内部服务调用错误。
400 ParameterInvalid Invalid parameter size, (0.6.0]. 无效参数。
400 InvalidLogStoreQuery logstore Query is invalid. 无效日志库查询。

更多错误码,请参见通用错误码