修改日志组
功能介绍
该接口用于修改指定日志组下的日志存储时长。
URI
POST /v2/{project_id}/groups/{log_group_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方式请参见：获取项目ID，获取账号ID，日志组ID、日志流ID 最小长度：36 最大长度：36 |
|
log_group_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_group_name |
String |
日志组的名称。 |
|
log_group_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 |
调用失败响应信息描述。 |
请求示例
修改日志组
POST https://{endpoint}/v2/{project_id}/groups/{log_group_id}
{
"ttl_in_days" : 8
}
响应示例
状态码：200
请求响应成功, 成功修改日志组。
{
"creation_time" : 156541515155541,
"log_group_name" : "groupName",
"log_group_id" : "b6b9332b-091f-4b22-b810-264318d2",
"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.0102",
"error_msg" : "Failed to update log group"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求响应成功, 成功修改日志组。 |
|
400 |
BadRequest。非法请求。 建议根据error_msg直接修改该请求，不要重试该请求。 |
|
401 |
AuthFailed。鉴权失败, 请确认token后再次请求 。 |
|
403 |
Forbidden。请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 |
|
500 |
InternalServerError。 表明服务端能被请求访问到，但是服务内部出错。 |
错误码
请参见错误码。
