修改日志流
功能介绍
该接口用于修改指定日志流下的日志存储时长。
URI
PUT /v2/{project_id}/groups/{log_group_id}/streams-ttl/{log_stream_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方式请参见：获取项目ID，获取账号ID，日志组ID、日志流ID 最小长度：36 最大长度：36 |
|
log_group_id |
是 |
String |
日志组ID，获取方式请参见：获取项目ID，获取账号ID，日志组ID、日志流ID 最小长度：36 最大长度：36 |
|
log_stream_id |
是 |
String |
日志流ID，获取方式请参见：获取项目ID，获取账号ID，日志组ID、日志流ID 最小长度：36 最大长度：36 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token，获取方式请参见：获取用户Token 最小长度：1000 最大长度：2000 |
|
Content-Type |
是 |
String |
该字段填为：application/json;charset=UTF-8。 最小长度：30 最大长度：30 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ttl_in_days |
是 |
Integer |
日志存储时间（天）。 最小值：1 最大值：365 |
|
tags |
否 |
Array of tagsBody objects |
标签字段信息 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
creation_time |
Long |
创建该日志流的时间 |
|
log_topic_name |
String |
日志流的名称。 |
|
log_topic_id |
String |
日志流ID。 |
|
ttl_in_days |
Integer |
日志存储时间（天）。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
调用失败响应信息描述。 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
调用失败响应信息描述。 |
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
调用失败响应信息描述。 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
调用失败响应信息描述。 |
请求示例
修改日志流
PUT https://{endpoint}/v2/{project_id}/groups/{log_group_id}/streams-ttl/{log_stream_id}
{
"ttl_in_days" : 8
}
响应示例
状态码：200
请求响应成功，成功修改日志流。
{
"creation_time" : 1629947408497,
"log_topic_name" : "string",
"log_topic_id" : "string",
"ttl_in_days" : 8
}
状态码：400
BadRequest。非法请求。 建议根据error_msg直接修改该请求，不要重试该请求。
{
"error_code" : "LTS.0009",
"error_msg" : "Failed to validate the request body"
}
状态码：401
AuthFailed。鉴权失败, 请确认token后再次请求 。
{
"error_code" : "LTS.0414",
"error_msg" : "Invalid token"
}
状态码：403
Forbidden。 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。
{
"error_code" : "LTS.0001",
"error_msg" : "Invalid projectId"
}
状态码：500
InternalServerError。 表明服务端能被请求访问到，但是服务内部出错。
{
"error_code" : "LTS.0204",
"error_msg" : "Failed to update log stream"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求响应成功，成功修改日志流。 |
|
400 |
BadRequest。非法请求。 建议根据error_msg直接修改该请求，不要重试该请求。 |
|
401 |
AuthFailed。鉴权失败, 请确认token后再次请求 。 |
|
403 |
Forbidden。 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 |
|
500 |
InternalServerError。 表明服务端能被请求访问到，但是服务内部出错。 |
|
503 |
ServiceUnavailable。 被请求的服务无效，服务不可用。 |
错误码
请参见错误码。
