UpdateLogstore

接口说明

请求语法

PUT /logstores/logstoreName HTTP/1.1
Content-Length: 0
x-log-bodyrawsize: 0
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
Host: ProjectName.Endpoint
Date: GMT Date
Authorization : LOG yourAccessKeyId:yourSignature 
x-log-date: Wed, 11 Nov 2015 08:28:19 GMT
{
    "logstoreName": logstoreName,
    "ttl": ttl,
    "enable_tracking": false,
    "shardCount": shardCount,
    "autoSplit": true,
    "maxSplitShard": 64,
    "appendMeta": false
}

其中，Host由Project名称和日志服务Endpoint构成，您需要在Host中指定Project。

请求参数

• 请求头

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

• 参数列表

  参数名称	数据类型	是否必填	示例值	描述
  logstoreName	String	是	test-logstore	日志库名称。
  ttl	Integer	是	1	数据的保存时间，单位为天。取值范围为1~3650。如果配置为3650，表示永久保存。
  enable_tracking	Boolean	否	false	是否开启WebTracking。 true：开启WebTracking。 false：不开启WebTracking。
  shardCount	Integer	是	2	Shard分区个数。 说明 该接口不支持更新分区个数。 只能通过SplitShard或MergeShards接口修改分区个数。
  autoSplit	Boolean	否	true	是否自动分裂Shard。 true：自动分裂Shard。 false：不自动分裂Shard。
  maxSplitShard	Integer	否	64	自动分裂时最大的Shard个数 ，最小值是1，最大值是64。 说明 当autoSplit为true时必须指定。
  appendMeta	Boolean	否	false	是否开启记录外网IP地址。 true：开启记录外网IP地址。 false：不开启记录外围IP地址。

返回数据

• 响应头

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

• 响应元素

  返回HTTP状态码200，则表示请求成功。

示例

• 请求示例

  PUT /logstores/test-logstore HTTP/1.1
  Header:
  {
  'x-log-bodyrawsize': '0',
  'Content-Type': 'application/json',
  'Content-Length': '143',
  'Content-MD5': '118D09033B9A4DCBA93A8A496EA095CF',
  'x-log-apiversion': '0.6.0', 
  'x-log-signaturemethod': 'hmac-sha1',
  'Host': 'ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com',
  'Date': 'Wed, 11 Nov 2015 08:28:19 GMT', 
  'Authorization': 'LOG yourAccessKeyId:yourSignature', 
  'x-log-date': 'Wed, 11 Nov 2015 08:28:19 GMT'
  }
  Body : 
  {
      "logstoreName": "test-logstore",
      "ttl": 1,
      "enable_tracking": false,
      "shardCount": 2,
      "autoSplit": true,
      "maxSplitShard": 64
      "appendMeta": false
  }

• 正常返回示例

  HTTP/1.1 200 OK
  Header:
  {
  'Server': 'Tengine',
  'Content-Length': '0', 
  'Connection': 'close', 
  'Access-Control-Allow-Origin': '*', 
  'Date': 'Wed, 11 Nov 2015 08:28:20 GMT', 
  'x-log-requestid': '5FC4490F5D13436DA713CBEE'
  }

错误码

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