全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
日志服务

ListLogstore

更新时间:2018-04-04 17:28:23

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

请求语法

  1. GET /logstores HTTP/1.1
  2. Authorization: <AuthorizationString>
  3. Date: <GMT Date>
  4. Host: <Project Endpoint>
  5. x-log-apiversion: 0.6.0
  6. x-log-signaturemethod: hmac-sha1

请求参数

参数名称 类型 是否必须 描述
offset(optional) integer 返回记录的起始位置,默认值为 1。
size(optional) integer 每页返回最大条目,默认 500(最大值)。
logstoreName string 用于请求的 Logstore 名称(支持部分匹配)。

请求头

无特有请求头。关于 Log Service API 的公共请求头,请参考 公共请求头

响应头

无特有响应头。关于 Log Service API 的公共响应头,请参考 公共响应头

响应元素

ListLogStores 请求成功,其响应 Body 会包括指定 Project 下的所有 Logstore 名称列表,具体格式如下:

名称 类型 描述
count 整型 返回的 Logstore 数目。
total 整型 Logstore 总数。
logstores 字符串数组 返回的 Logstore 名称列表。

错误码

除了返回 Log Service API 的 通用错误码,还可能返回如下特有错误码:

HTTP状态码 ErrorCode ErrorMessage
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

示例

请求示例:
  1. GET /logstores HTTP/1.1
  2. Header:
  3. {
  4. x-log-apiversion=0.6.0,
  5. Authorization=LOG 94to3z418yupi6ikawqqd370:we34Siz/SBVyVGMGmMDnvp0xSPo=,
  6. Host=ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com,
  7. Date=Wed, 11 Nov 2015 08:09:39 GMT,
  8. Content-Length=0,
  9. x-log-signaturemethod=hmac-sha1,
  10. User-Agent=sls-java-sdk-v-0.6.0,
  11. Content-Type=application/json
  12. }
响应示例:
  1. HTTP/1.1 200 OK
  2. Header:
  3. {
  4. Date=Wed, 11 Nov 2015 08:09:39 GMT,
  5. Content-Length=52,
  6. x-log-requestid=5642F7C399248C8D7B01342F,
  7. Connection=close,
  8. Content-Type=application/json,
  9. Server=nginx/1.6.1
  10. }
  11. Body:
  12. {
  13. "count":1,
  14. "logstores":["test-logstore"],
  15. "total":1
  16. }
本文导读目录