文档首页/ 云日志服务 LTS/ API参考/ API说明/ 日志转储/ 创建日志转储(旧版)
更新时间:2024-12-20 GMT+08:00

创建日志转储(旧版)

功能介绍

该接口用于将指定的一个或多个日志流的日志转储到OBS服务。

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/log-dump/obs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID

最小长度:32

最大长度:32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM服务获取的用户Token,获取方式请参见:获取用户Token

最小长度:1000

最大长度:2000

Content-Type

String

该字段填为:application/json;charset=UTF-8。

最小长度:30

最大长度:30

表3 请求Body参数

参数

是否必选

参数类型

描述

log_group_id

String

日志组id。

最小长度:36

最大长度:36

log_stream_ids

Array of strings

日志流id列表, 可以指定一个或多个日志流进行obs周期性转储

obs_bucket_name

String

obs 桶名称。

最小长度:3

最大长度:63

type

String

周期性转储, 必须填 cycle。

最小长度:5

最大长度:5

storage_format

String

转储格式 RAW/JSON, 默认为 RAW。

最小长度:3

最大长度:4

switch_on

Boolean

是否开启转储 true/false, 默认为 true

prefix_name

String

转储至OBS桶中的日志文件前缀。

最小长度:0

最大长度:64

dir_prefix_name

String

自定义文件夹路径。

最小长度:0

最大长度:64

period

Integer

转储周期的长度

period_unit

String

转储周期的单位。> period与period_unit拼接后必须在该列表中["2min","5min","30min","1hour","3hour","6hour","12hour"]

最小长度:3

最大长度:4

响应参数

状态码: 201

表4 响应Body参数

参数

参数类型

描述

log_dump_obs_id

String

转储id。

缺省值:None

最小长度:36

最大长度:36

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

调用失败响应信息描述。

状态码: 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

调用失败响应信息描述。

状态码: 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

调用失败响应信息描述。

请求示例

创建日志转储

POST https://{endpoint}/v2/{project_id}/log-dump/obs

{
  "log_group_id" : "d9dba9f3-xxxx-48bd-xxxx-xxxxa24a8053",
  "log_stream_ids" : [ "45e7f609-xxxx-4cd3-835b-xxxx4a124718" ],
  "obs_bucket_name" : "lts-test",
  "type" : "cycle",
  "storage_format" : "RAW",
  "switch_on" : "true",
  "prefix_name" : "fileprefixname",
  "dir_prefix_name" : "dirprefixname",
  "period" : 5,
  "period_unit" : "min"
}

响应示例

状态码: 200

请求响应成功。

  • 当前日志组不存在。

    {
      "error_code" : "LTS.0201",
      "error_msg" : "The log group does not existed"
    }
  • 当前日志流不存在。

    {
      "error_code" : "LTS.0208",
      "error_msg" : "Log stream id does not exist: 632b9bdc-5afd-4666-a5de-2579f8b80314-"
    }
  • 当前OBS桶不存在。

    {
      "error_code" : "LTS.0416",
      "error_msg" : "obs bucket does not exist: zhuanchu"
    }
  • 转储时日志流ID已经被关联。

    {
      "error_code" : "LTS.0207",
      "error_msg" : "Log stream id is associated by transfer: 632b9bdc-5afd-4666-a5de-2579f8b80314"
    }
  • 转储类型没有在列表中。

    {
      "error_code" : "LTS.1901",
      "error_msg" : "type is not in the list [cycle]"
    }
  • 转储格式没有在列表中。

    {
      "error_code" : "LTS.1901",
      "error_msg" : "storage_format is not in the list [RAW, JSON]"
    }
  • 转储周期没有在列表中。

    {
      "error_code" : "LTS.1901",
      "error_msg" : "period+period_unit is not in the list [2min, 5min, 30min, 1hour, 3hour, 6hour, 12hour]"
    }
  • 转储单位没有在列表中。

    {
      "error_code" : "LTS.1901",
      "error_msg" : "period_unit is not in the list [min, hour]"
    }
  • 转储日志文件前缀无效,请确认是否按要求提供。

    {
      "error_code" : "LTS.1902",
      "error_msg" : "prefix_name is invalid, please verify if it's provided as required"
    }
  • 自定义转储路径名前缀无效,请确认是否按要求提供。

    {
      "error_code" : "LTS.1902",
      "error_msg" : "dir_prefix_name is invalid, please verify if it's provided as required"
    }

状态码: 201

请求响应成功。

{
  "log_dump_obs_id" : "45fdc36b-xxxx-4567-xxxx-559xxxxdf968"
}

状态码: 400

BadRequest。非法请求。 建议根据error_msg直接修改该请求,不要重试该请求。

BadRequest。非法请求。建议根据error_msg直接修改该请求,不要重试该请求。
{     
  "error_code": "LTS.0007",     
  "error_msg": "The request body format must be json" 
}

状态码: 403

Forbidden。请求被拒绝访问。返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

{
  "error_code" : "LTS.0001",
  "error_msg" : "Invalid projectId"
}

状态码: 500

InternalServerError。

表明服务端能被请求访问到,但是服务内部出错。

InternalServerError。表明服务端能被请求访问到,但是服务内部出错。
{    
  "error_code": "LTS.0010",    
  "error_msg": "Internal Server Error"}

状态码

状态码

描述

200

请求响应成功。

201

请求响应成功。

400

BadRequest。非法请求。 建议根据error_msg直接修改该请求,不要重试该请求。

403

Forbidden。请求被拒绝访问。返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

500

InternalServerError。

表明服务端能被请求访问到,但是服务内部出错。

错误码

请参见错误码