UpdateLogstore

接口说明

请求语法

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	否	true	是否开启WebTracking，默认为false。
  appendMeta	bool	否	true	是否开启记录外网IP地址，默认为false。
  autoSplit	bool	否	true	是否自动分裂Shard，默认为false。
  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
  }

错误码

更多错误码，请参见通用错误码。