调用UpdateLogstore接口更新Logstore的属性。

接口说明

目前只支持更新TTL和shard属性。

请求语法

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>
}

请求参数

  • 请求头

    UpdateLogstore接口无特有请求头。关于Log Service API的公共请求头,请参见公共请求头

  • 参数列表
    参数名称 类型 是否必须 示例值 描述
    logstoreName string test-logstore 日志库名称,同一Project中日志库名称为唯一值。
    ttl integer 1 日志数据生命周期(TTL),单位为天,最小值是1,最大值是3600。
    shardCount integer 2 查看Shard的个数。
    说明
    • 更新Logstore的属性,Shard的个数不变。
    • Shard个数的修改只能通过SplitShard或MergeShards完成。
    enable_tracking bool 是否开启WebTracking。
    autoSplit bool true 是否自动分裂Shard。
    maxSplitShard int 64 自动分裂时最大的Shard个数 ,最小值是1,最大值是64。
    说明 当autoSplit为true时必须指定。

返回数据

  • 响应头

    UpdateLogstore接口无特有响应头。关于Log Service API的公共响应头,请参见公共响应头

  • 响应元素

    HTTP 状态码返回 200。

示例

  • 请求示例
    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": "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
    }

错误码

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. 无效Shard个数,您只能通过SplitShard或MergeShards修改Shard个数。

更多错误码,请参见通用错误码