CreateLogstore接口用于在Project下创建Logstore。

请求语法

CreateLogstore接口请求语法如下。
POST /logstores 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>
}

请求参数

  • 请求头

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

  • 请求参数
    属性名称 类型 是否必须 描述
    logstoreName string Logstore的名称,在Project下必须唯一。
    ttl integer 数据的保存时间,单位为天,范围1~3600。
    shardCount integer Shard个数,单位为个,范围为1~100。
    enable_tracking bool 是否开启WebTracking,默认为false。
    autoSplit bool 是否自动分裂shard,默认为false。
    maxSplitShard int 自动分裂时shard最大个数 ,范围为1~64,默认为64。当autoSplit为true时必须设置。

响应参数

  • 响应头

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

  • 响应元素

    HTTP状态码返回200。

错误码

除了返回Log Service API的通用错误码,还会返回该接口的特有错误码。

表 1. CreateLogstore特有错误码
HTTP状态码 ErrorCode ErrorMessage
400 LogstoreAlreadyExist logstore {logstoreName} already exists
500 InternalServerError Specified Server Error Message
400 LogstoreInfoInvalid logstore info is invalid
400 ProjectQuotaExceed Project Quota Exceed

示例

  • 请求示例
    POST /logstores 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 07:35:00 GMT, 
    Content-Length=55,
    x-log-signaturemethod=hmac-sha1, 
    Content-MD5=7EF43D0B8F4A807B95E775048C911C72, 
    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 07:35:00 GMT, 
    Content-Length=0, 
    x-log-requestid=5642EFA499248C827B012B39, 
    Connection=close, 
    Server=nginx/1.6.1
    }