リクエスト構文
PUT /logstores/{logstoreName} 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 ~ 3600 です。 |
shardCount | Integer | 必須 | シャードの数を表示します。 Logstore 属性を更新しても、シャードの数は変更されません。 シャードの数は、SplisShard または MergeShard のみで変更できます。 |
enable_tracking | Bool | 省略可能 | Web Tracking の有効化を決定します。 |
autoSplit | Bool | 省略可能 | シャードを自動的に分割するかどうかを決定します。 |
maxSplitShard | Int | 省略可能 | 自動分割のシャードの最大数 (1 ~ 64 の範囲)。 autoSplit が true の場合、このパラメーターを指定しなければなりません。 |
UpdateLogstore API には特別なリクエストヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。
レスポンスヘッダーUpdateLogstore API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。
レスポンス要素返される HTTP ステータスコードは 200 です。
エラーコードLog Service API の 一般的なエラーコード の他に、 UpdateLogstore API から次の特別のエラーコードが返される場合があります。
HTTP ステータス コード | エラーコード | エラー メッセージ |
---|---|---|
404 | ProjectNotExist | Project {ProjectName} does not exist |
404 | LogStoreNotExist | logstore {logstoreName} does not exist |
400 | LogStoreAlreadyExist | logstore {logstoreName} already exists |
500 | InternalServerError | Specified Server Error Message |
400 | ParameterInvalid | invalid shard count,you can only modify shardCount by split& merge shard |
現在、シャード数は SplitShard を使用してのみ変更できます。
例
リクエスト例
PUT /logstores/test-logstore 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:28:19 GMT,
Content-Length=55,
x-log-signaturemethod=hmac-sha1,
Content-MD5=757C60FC41CC7D3F60B88E0D916D051E,
User-Agent=sls-java-sdk-v-0.6.0,
Content-Type=application/json
}
Body :
{
"logstoreName": "sls-test-logstore"
"ttl": 1,
"shardCount": 2,
"autoSplit": true,
"maxSplitShard": 64
}
レスポンス例:
HTTP/1.1 200 OK
Header:
{
Date=Wed, 11 Nov 2015 08:28:20 GMT,
Content-Length=0,
x-log-requestid=5642FC2399248C8F7B0145FD,
Connection=close,
Server=nginx/1.6.1
}