功能介绍
该接口用于上报日志数据至云日志服务中。
URI
POST
Path参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| endpoint | sting | 访问地址，请查看访问地址（Endpoint） |
| logProject | sting | 日志项目ID |
| logUnit | string | 日志单元ID |
参数（Endpoint） 获取方式
各资源池地址请查看访问地址（Endpoint）。
参数（logProject、logUnit）获取方式
logProject、logUnit代表了日志上传的目标日志项目与目标日志单元。要获取这两个参数的前提是您已经成功开通了云日志服务，并创建了日志项目和日志单元，详情参考创建日志项目与日志单元。
创建完成后，您可在云日志服务控制台-日志管理-日志项目与日志单元列表中获取。
注意日志项目和日志单元编码所属区域要和访问地址endpoint相对应，例如日志项目和日志单元开通在华东1区域内，则也需要使用华东1的endpoint。
Header
| 参数名 | 说明 |
|---|---|
| token | 通过CTAPI获取的token值 |
| accesskey | 租户的ak。 |
| Content-Type | application/json SDK传以下参数，body的报文格式为pb： application/x-protobuf。 |
Body
| 参数名 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| log_items | Array[log_item] | 参考对象log_item 一个log_itme指一条日志 |
是 |
对象log_item
| 参数名 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| log_timestamp | long | 时间戳，纳秒（长度19位），一般是当前时间 | 是 |
| origin_msg | string | 原始日志内容 | 是 |
| content | Map<string, string> | 对日志进行分词后的内容，可用于索引 | 否 |
| labels | Map<string, string> | 自定义标签 | 否 |
Response
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回码取值范围 0：正常； -1：严重错误； |
0 |
| message | String | 状态描述 | SUCCESS |
| error | String | 参考错误编码列表 | LTS_8000 |
示例
curl --location --request POST 'https://lts-huadong1.cnsp-internal.ctyun.cn/v1/lts/api/29428/54272/putlogs' \
--header 'token: 04ad5e6d4ac03534e117cb49388458e382b350a7ad915e0b644be9d2c57db4cf981c47c60a6252259f330817b75438d9bb7087f6393c3815e015c2e6cb3f293cd5369843adda4c0f7b428063334d39b2d3f78306e78211224a33ddd3c22293b3766a67acf7af4ad7250c2c07c41c7517f2451a9babc0f4947da8d4600053bda5b78cc202ebccf39e63cd3158f46d7f2238ba843c7b6b79d3b7bf43d80aa57c23daa9c0048892a163bb6d59cde267095c5b047eacf78e1515532da0e0b9c9bb85bc571477d6d956d5ab334a4db81c836b0bd2c5097a6c2f0f256b10eef4ce769b2ca95472275aff608350f68978134ac9f23b4b3fdee9bf2c711cc59d9ee48ec8b1673e4a8c74888d98b67301b060a94a63d6bc96a94653458cfa133f8214c8ae1e5bd467b2199b6e2e57a0bd06d16acefa1902cb45204cfd69899dd40c8782559b458b7b56d1ca6b499e4630470c477' \
--header 'accesskey: e1301507eb4b42939b1c17480bdcbc8a' \
--header 'Content-Type: application/json' \
--data '{
"log_items":[
{
"log_timestamp": 1724061582000000000,
"origin_msg":"112312312312312sdfdsafasdfasdfasdf",
"content":
{
"testkey":"sadfasdfasdfasdfasdf",
"key": 1,
"key2": "1",
"key3": 1.1
}
,
"labels":{
"user_tag":"string"
}
}
]
}'
错误码
| statusCode | errorCode | message |
|---|---|---|
| -1 | LTS_8000 | 请求失败，请稍候重试，或提交工单反馈 |
| -1 | LTS_8001 | 内容不合法，无法解析 |
| -1 | LTS_8002 | 日志内容中有无效的日志时间戳 |
| -1 | LTS_8003 | 日志内容中有非UTF8字符 |
| -1 | LTS_8004 | 日志内容包含的日志必须小于[x] MB和[y]条 |
| -1 | LTS_8005 | 日志中时间范围不在[-7*24小时 + 15分钟]有效范围内 |
| -1 | LTS_8006 | 日志内容解压失败 |
| -1 | LTS_8007 | Token失效，请重新获取 |
| -1 | LTS_8008 | 云日志服务产品失效，请续费或重新开通 |
| -1 | LTS_8009 | 无云日志服务产品实例，请先开通云日志服务 |
| -1 | LTS_8010 | 日志项目不存在 |
| -1 | LTS_8011 | 日志单元不存在 |
