日志單元分頁列表
更新時間 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 //[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"
}
]
}
}
狀態碼
請參考
錯誤碼
請參考
