Logstore 属性を更新します。 現在、 Time To Live (TTL) 属性とシャード属性のみ更新可能です。

リクエスト構文

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
}