例:
POST /logstores
リクエスト構文
POST /logstores HTTP/1.1
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
{
"logstoreName" : <logStoreName>,
"ttl": <ttl>,
"shardCount": <shardCount>,
"autoSplit": <autoSplit>,
"maxSplitShard": <maxSplitShard>
}
リクエストパラメーター
属性名 | データ型 | 必須/省略可能 | 説明 |
---|---|---|---|
logstoreName | string | 必須 | 同じプロジェクト内で一意の LogStore 名。 |
ttl | integer | 必須 | 1 日のデータ保持期間 (値は 1 ~ 3600) |
shardCount | Integer | 必須 | この Logstore 内のシャードの数 (1 ~ 100 の範囲) 。 |
enable_tracking | bool | 省略可能 | Web Tracking を有効にするかどうかを決定します。 |
autoSplit | bool | 省略可能 | シャードを自動分割するかどうかを決定します。 |
maxSplitShard | int | 省略可能 | 自動分割のシャードの最大数 (範囲:1 ~ 64 )。 autoSplit が true の場合は、このパラメーターを指定する必要があります。 |
リクエストヘッダー
CreateConfig API に特別のリクエストヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。
レスポンスヘッダー
CreateLogstore API に特別のレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。
レスポンス要素
返される HTTP ステータスコードは 200 です。
エラーコード
Log Service API の 一般的なエラー コード の他に、CreateLogstore API から以下の特別なエラーコードが返される場合があります。
HTTP ステータスコード | エラーコード | エラーメッセージ |
---|---|---|
400 | LogstoreAlreadyExist | logstore {logstoreName} already exists |
500 | InternalServerError | Specified Server Error Message |
400 | LogstoreInfoInvalid | logstore info is invalid |
400 | ProjectQuotaExceed | Project Quota Exceed |
詳細の説明
クォータが無効な場合、Logstore を作成できません。
例
リクエスト例
POST /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 07:35:00 GMT,
Content-Length=55,
x-log-signaturemethod=hmac-sha1,
Content-MD5=7EF43D0B8F4A807B95E775048C911C72,
User-Agent=sls-java-sdk-v-0.6.0,
Content-Type=application/json
}
Body :
{
"logstoreName": "test-logstore",
"ttl": 1,
"shardCount": 2,
"autoSplit": true,
"maxSplitShard": 64
}
レスポンス例:
HTTP/1.1 200 OK
Header:
{
Date=Wed, 11 Nov 2015 07:35:00 GMT,
Content-Length=0,
x-log-requestid=5642EFA499248C827B012B39,
Connection=close,
Server=nginx/1.6.1
}