调用CreateConfig接口创建日志采集配置。

接口说明

创建过程中遇到配置已经存在、格式错误、必要参数遗失或者quota超过限制等错误,则会创建失败。

请求语法

POST /configs HTTP/1.1
Authorization: <AuthorizationString> 
Content-Type:application/json
Content-Length:<Content Length>
Content-MD5<:<Content MD5>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
{
    "configName": "testcategory1",
    "inputType": "file",
    "inputDetail": {
        "logType": "common_reg_log",
        "logPath": "/var/log/httpd/",
        "filePattern": "access*.log",
        "localStorage": true,
        "timeFormat": "%Y/%m/%d %H:%M:%S",
        "logBeginRegex": ".*",
        "regex": "(\w+)(\s+)",
        "key" :["key1", "key2"],
        "filterKey":["key1"],
        "filterRegex":["regex1"],
        "fileEncoding":"utf8",
        "topicFormat": "none"
    },
    "outputType": "LogService",
    "outputDetail": 
    {
        "logstoreName": "perfcounter"
    }
}

请求参数

  • 请求头

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

  • 请求参数

    关于请求参数和各种模式的Logtail配置样例,请参见Logtail配置

返回数据

  • 响应头

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

  • 响应元素

    HTTP状态码返回200。

示例

  • 请求示例
    POST /configs HTTP/1.1
    Header :
    {
        'Content-Length': 737, 
        'Host': 'ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com', 
        'x-log-bodyrawsize': 737, 
        'Content-MD5': 'FBA01ECF7255BE143379BC70C56BBF68', 
        'x-log-signaturemethod': 'hmac-sha1', 
        'Date': 'Mon, 09 Nov 2015 07:45:30 GMT', 
        'x-log-apiversion': '0.6.0', 
        'User-Agent': 'log-python-sdk-v-0.6.0', 
        'Content-Type': 'application/json', 
        'Authorization': 'LOG <yourAccessKeyId>:<yourSignature>'
    }
    Body:
    {
        "configName": "sample-logtail-config",
        "inputType": "file",
        "inputDetail": {
            "logType": "common_reg_log", 
            "logPath": "/var/log/httpd/",
            "filePattern": "access*.log",
            "localStorage": true, 
            "timeFormat": "%d/%b/%Y:%H:%M:%S", 
            "logBeginRegex": "\\d+\\.\\d+\\.\\d+\\.\\d+ - .*", 
            "regex": "([\\d\\.]+) \\S+ \\S+ \\[(\\S+) \\S+\\] \"(\\w+) ([^\"]*)\" ([\\d\\.]+) (\\d+) (\\d+) (\\d+|-) \"([^\"]*)\" \"([^\"]*)\".*", 
            "key": ["ip", "time", "method", "url", "request_time", "request_length", "status", "length", "ref_url", "browser"], 
            "filterKey": [], 
            "filterRegex": [],
            "topicFormat": "none", 
            "fileEncoding": "utf8"
        }, 
        "outputType": "LogService", 
        "outputDetail": 
        {
            "logstoreName": "sls-test-logstore"
        }
    }
  • 正常返回示例
    HTTP/1.1 200 OK
    Header
    {
        'date': 'Mon, 09 Nov 2015 07:45:30 GMT',
        'connection': 'close',
        'x-log-requestid': '56404F1A99248CA26C002180',
        'content-length': '0',
        'server': 'nginx/1.6.1'
    }

错误码

HTTP状态码 错误码 错误信息 描述
400 ConfigAlreadyExist config {Configname} already exists. 日志配置已存在。
400 InvalidParameter invalid config resource json. 无效参数。
500 InternalServerError internal server error. 内部服务调用错误。

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