指定したプロジェクト内のすべての 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

リクエストパラメーター

パラメーター名 データ型 必須/省略可能 説明
offset(optional) Integer 省略可能 返されるレコードの開始位置 (デフォルトは 0)。
size(optional) integer 省略可能 各ページに返されるエントリの最大数です。 デフォルト値は 500 (最大値) です。
logstoreName string 必須 リクエストに使用される Logstore 名 (部分一致がサポートされています)。
リクエストヘッダー

ListLogstore API には特別なリクエストヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。

レスポンスヘッド

ListLogstore API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。

レスポンス要素
ListLogstore リクエストが成功すると、レスポンスボディには、指定したプロジェクト内のすべての Logstore の名前リストが含まれます。 以下は具体的な形式です。
名前 データ型 説明
count integer 返されるタスクの数
total integer Logstore の総数
logstores string array 返される Logstore の名前のリスト
エラーコード

Log Service API の 一般的なエラーコード の他に、 ListLogstore API から次の特別のエラーコードが返される場合があります。

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

例

リクエスト例： 
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
}