百度日志服务BLS

    CreateLogStore

    描述

    创建日志集,命名日志组时,需遵循以下准则:

    • 每个账户每个区域日志集名称不能重复
    • 日志集名称长度不能超过 128 个字符
    • 日志集名称包含的字符仅限于: a-z, A-Z, 0-9, '_', '-', '.'

    请求

    • 请求语法
    POST /v1/logstore HTTP/1.1
    Host: <Endpoint>
    Authorization: <Authorization String>
    Content-Type: application/json; charset=utf-8
    
    {
      "logStoreName": <LogStoreName>,
      "retention": <Retention>
    }
    • 请求头域

    除公共请求头域外,无其它特殊头域。

    • 请求参数
    参数名称 类型 是否必须 参数位置 描述
    logStoreName String Yes RequestBody 日志集名称
    retention Int Yes RequestBody 日志集的租期,单位:天数

    注:retention 的最大值不超过30天

    响应

    • 响应头域

    除公共响应头域外,无其它特殊头域。

    • 响应参数

    错误码

    除了通用的错误码,还可能出现如下错误码:

    错误码 错误消息 描述 HTTP状态码
    ResourceOverflow The number of logStores reaches the limit LogStore 数目超出默认限制 403
    LogStoreAlreadyExist LogStore [logStoreName] already exists LogStore 已存在 409

    注:错误消息中 [logStoreName] 部分会用具体的名称来替换

    示例

    • 请求示例
    POST /v1/logstore HTTP/1.1
    Host: bls-log.bj.baidubce.com
    Authorization:bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
    Content-Type: application/json; charset=utf-8
     
    {
      "logStoreName": "demo",
      "retention": 10
    }
    • 响应示例
    HTTP/1.1 201
    Content-Type: application/json; charset=utf-8
    X-Bce-Request-Id: 2eeba101-4cc7-4cfe-b5ac-a3be8d060e33
    Date: Fri, 10 Apr 2020 04:42:37 GMT
    上一篇
    通用错误码
    下一篇
    UpdateLogStore