日志单元列表
更新时间 2025-09-16 19:01:06
最近更新时间: 2025-09-16 19:01:06
接口功能介绍
该接口用于查询指定日志项目下的所有日志单元信息。
接口约束
无
URI
GET /v1/unit/list
路径参数 无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
projectCode | 是 | String | 日志项目ID。可在云日志控制台 日志管理->日志项目列表->鼠标悬浮查看日志项目ID | aebfe4d04fbc03 | |
unitName | 否 | String | 可根据单元名称和原始名称模糊匹配 | myUnitName |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionId | 是 | String | 资源池编码,可参考资源池列表 | 2000******852 |
请求体body参数 无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 响应状态码。0:代表正常; -1:代表严重错误; -2:代表普通错误 | 0 | |
error | String | 业务错误码,仅错误时返回,例LTS_XXXX | LTS_0001 | |
message | String | 请求响应信息 | 成功 | |
requestId | String | 请求ID | 3e31ebb2-572e5408e | |
returnObj | Array of Objects | 返回日志单元对象列表 | unitObject | |
表 unitObject |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
unitCode | String | 日志单元ID | 7254e534de23ee | |
unitName | String | 日志单元原始名称 | ctyunUnit | |
aliasName | String | 日志单元名称 | ctyunUnitName | |
description | String | 日志单元描述 | test | |
ttlDays | Integer | 存储时长(天) | 15 | |
createTime | String | 创建时间 | 2024-03-04 12:00:00 |
枚举参数
无
请求示例
请求url
GET https://[endpoint]/v1/unit/list?projectCode=aqkfe4d04fbc03
请求头header
regionId: 2000******852
请求体body
无
响应示例
{
"statusCode":0,
"error": null,
"message": "成功",
"requestId":"3e31ebb2-572e5408e",
"returnObj":[
{
"unitCode":"7254e534de23ee",
"unitName":"ctyunUnit",
"unitAliasName":"ctyunUnitName",
"description":"test",
"ttlDays": 15,
"createTime":"2024-03-04 12:00:00"
}
]
}
状态码
请参考 状态码
错误码
请参考 错误码