日志单元分页列表
更新时间 2025-09-16 19:00:56
最近更新时间: 2025-09-16 19:00:56
接口功能介绍
该接口用于分页查询指定日志项目ID下的日志单元信息。
接口约束
无
URI
GET /v1/unit/page
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| projectCode | 是 | String | 日志项目ID。可在云日志控制台 日志管理->日志项目列表->鼠标悬浮查看日志项目ID | e400db5f77d76d | |
| unitName | 否 | String | 日志单元原始名称（模糊匹配） | myUnitName | |
| pageNum | 否 | Integer | 页码（默认1） | 1 | |
| pageSize | 否 | Integer | 每页记录数量（默认10） | 10 |
请求参数
请求头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 | Object | 返回对象 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| total | Integer | 数据总数 | 5 | |
| list | Array of Objects | 数据列表 | unit | |
| 表 unit |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| unitCode | String | 日志单元ID | ac67a091b4e159 | |
| unitName | String | 日志单元原始名称 | myname | |
| aliasName | String | 日志单元名称 | my_alias_name | |
| description | String | 描述 | test unit | |
| ttlDays | String | 存储时长（天） | 15 | |
| createTime | String | 创建时间 | 2024-03-04 12:00:00 |
枚举参数
无
请求示例
请求url
GET https://[endpoint]/v1/unit/page?projectCode=e400db5f77d76d&pageNum=1&pageSize=10
请求头header
regionId: 2000******852
请求体body
无
响应示例
{
"statusCode": 0,
"error": null,
"requestId": "c3436e88-7848899b4",
"message": "成功",
"returnObj": {
"total": 1,
"list": [
{
"unitCode": "d07166c33486db", // 日志单元ID
"unitName": "ctyunUnit",
"aliasName": "ctyunUnitName",
"description": "test unit",
"ttlDays": 15,
"createTime":"2024-03-04 12:00:00"
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码
