上报日志接口参考
URI
POST /v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方式请参见：获取账号ID、项目ID、日志组ID、日志流ID。 缺省值：None 最小长度：32 最大长度：32 |
|
log_group_id |
是 |
String |
日志组ID，获取方式请参见：获取账号ID、项目ID、日志组ID、日志流ID。 缺省值：None 最小长度：36 最大长度：36 |
|
log_stream_id |
是 |
String |
日志流ID，获取方式请参见：获取账号ID、项目ID、日志组ID、日志流ID。 缺省值：None 最小长度：36 最大长度：36
说明：
每个logstream写入速率最大不能超过100MB/S，超过此规格可能会导致日志丢失。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
从IAM获取的用户Token，获取方式请参见：获取用户Token。 缺省值：None 最小长度：1000 最大长度：2000 |
|
Content-Type |
是 |
String |
该字段填为：application/json;charset=UTF-8。 缺省值：None 最小长度：30 最大长度：30 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
log_time_ns |
是 |
Long |
日志数据上报时间，UTC时间（纳秒）。
说明：
通过接口上报日志到LTS的时间相距当前时间不超过2天，否则上报日志会被LTS删除。 |
|
contents |
是 |
Array of String |
日志内容。 |
|
labels |
是 |
Object |
用户自定义label。
说明：
请不要将字段名称设置为内置保留字段，否则可能会造成字段名称重复、查询不精确等问题。 |
|
tenant_project_id |
否 |
String |
租户项目ID，获取方式请参见：获取账号ID、项目ID、日志组ID、日志流ID。 |
响应参数
状态码为 200 时:
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errorCode |
String |
错误码。 枚举值：
|
|
errorMessage |
String |
调用失败响应信息描述。 枚举值：
|
|
result |
String |
响应结果。 |
状态码为 400 时:
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errorCode |
String |
错误码。 枚举值：
|
|
errorMessage |
String |
调用失败响应信息描述。 枚举值：
|
|
result |
String |
响应结果。 |
状态码为 401 时:
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errorCode |
String |
错误码。 枚举值：
|
|
errorMessage |
String |
调用失败响应信息描述。 枚举值：
|
|
result |
String |
响应结果。 |
状态码为 500 时:
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errorCode |
String |
错误码。 枚举值：
|
|
errorMessage |
String |
调用失败响应信息描述。 枚举值：
|
|
result |
String |
响应结果。 |
状态码为 503 时:
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
String |
ServiceUnavailable。 被请求的服务无效，服务不可用。 |
请求示例
POST https://{接入点IP:8102}/v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents
{
"log_time_ns": 1586850540000000000,
"contents": [
"Fri Feb 1 07:48:04 UTC 2019 0\n",
"Sat Apri 18 16:04:04 UTC 2019"
],
"labels": {
"user_tag": "string"
}
}
响应示例
状态码： 200
日志上报成功。
{
"errorCode": "SVCSTG.ALS.200.200",
"errorMessage": "Report success.",
"result": null
}
状态码： 401
在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。
{
"errorCode" : "SVCSTG.ALS.403.105",
"errorMessage" : "Project id is invalid.",
"result": null
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求响应成功。 |
|
400 |
BadRequest。非法请求。建议根据error_msg直接修改该请求，不要重试该请求。 |
|
401 |
在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 |
|
500 |
系统内部错误。 |
|
503 |
ServiceUnavailable。被请求的服务无效，服务不可用。 |
