创建日志转储

功能介绍

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

URI

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

请求参数

响应参数

状态码为 201 时:

状态码为 400 时:

状态码为 403 时:

状态码为 500 时:

请求示例

POST https://{endpoint}/v2/{project_id}/log-dump/obs 
 
/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直接修改该请求，不要重试该请求。

  { 
    "error_code" : "LTS.0009", 
    "error_msg" : "Failed to validate the request body" 
  }

• 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。表明服务端能被请求访问到，但是服务内部出错。

  { 
    "error_code" : "LTS.0202", 
    "error_msg" : "Failed to query lts struct log" 
  }

状态码

错误码

请参见错误码。