UpdateLogstore

Description

Request syntax

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
}

The value of the Host parameter consists of a project name and an endpoint. You must specify a project name for the Host parameter.

Request elements

• Request headers

  The UpdateLogstore operation does not have operation-specific request headers. For information about the common request headers of Log Service API operations, see Common request headers.

• Parameters

  Parameter	Type	Required	Example	Description
  logstoreName	String	Yes	test-logstore	The name of the Logstore.
  ttl	Integer	Yes	1	The data retention period. Unit: days. Valid values: 1 to 3650. If you set the value to 3650, the data is permanently stored.
  enable_tracking	Boolean	No	false	Specifies whether to enable the WebTracking feature. If you set the value to true, the WebTracking feature is enabled. If you set the value to false, the WebTracking feature is disabled.
  shardCount	Integer	Yes	2	The number of shards. Note You cannot call the UpdateLogstore operation to modify this parameter. However, you can call the SplitShard or MergeShards operation to modify this parameter.
  autoSplit	Boolean	No	true	Specifies whether to enable automatic sharding. If you set the value to true, automatic sharding is enabled. If you set the value to false, automatic sharding is disabled.
  maxSplitShard	Integer	No	64	The maximum number of shards for automatic sharding. Valid values: 1 to 64. Note This parameter must be specified if the autoSplit parameter is set to true.
  appendMeta	Boolean	No	false	Specifies whether to record public IP addresses. If you set the value to true, public IP addresses are recorded. If you set the value to false, public IP addresses are not recorded.

Response parameters

• Response headers

  The UpdateLogstore operation does not have operation-specific response headers. For information about the common response headers of Log Service API operations, see Common response headers.

• Response elements

  If the HTTP status code 200 is returned, the request is successful.

Examples

• Sample requests

  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
  }

• Sample success responses

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

Error codes

For a list of error codes, see Common error codes.