元數據概覽
更新時間 2025-09-04 18:10:24
最近更新時間: 2025-09-04 18:10:24
分享文章
接口功能介紹
此接口提供獲取集群元數據概覽功能,系統接收用戶輸入的查詢條件,返回集群的庫總數、表總數、總存儲量、總文件數等概覽信息。
接口約束
集群必須處于運行狀態。
URI
GET /v1/emr/doctor/openapi/meta/hive/overview
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| clusterId | 是 | String | 集群id | da595eb1d81503b323fdc01d9bf786b7 | |
| timestamp | 是 | Long | 要查詢的時間點,以 Unix 時間戳表示(單位:秒) | 1700000000 |
請求參數
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 狀態碼 | 200 | / |
| message | String | 用來簡述當前接口調用狀態以及必要提示信息 | success | / |
| error | String | 錯誤碼,請求成功時,不返回該字段 | EMR_400001 | / |
| returnObj | Object | 返回結果 | returnObj |
表 returnObj(請求成功)
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| databaseCnt | Long | 數據庫總數 | 5 | |
| tableCnt | Long | 表總數 | 237 | |
| storageCnt | Long | 總存儲量(單位:字節) | 10240000 | |
| fileCnt | Long | 文件總數 | 12223 |
表 returnObj(請求失敗)
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| timestamp | String | timestamp參數錯誤時返回該字段 | 時間戳不能為null | |
| clusterId | String | clusterId參數錯誤時返回該字段 | 不能為空 |
枚舉參數
無
請求示例
請求url
//emr-global.ctapi.daliqc.cn/v1/emr/doctor/openapi/meta/hive/overview?clusterId=da595eb1d81503b323fdc01d9bf786b7×tamp=1700000000
請求頭header
無
請求體body
無
響應示例
請求成功返回值示例
{
"statusCode": 200,
"message": "success",
"returnObj": {
"databaseCnt": 5,
"tableCnt": 237,
"storageCnt": 10240000,
"fileCnt": 12223
}
}
請求失敗返回值示例
請求參數無效示例:
{
? "statusCode": 500,
? "error": "EMR_401002",
? "message": "請求參數值無效",
? "returnObj": {
? "timestamp": "timestamp應為長整型"
? }
}
請求參數無效示例2:
{
? "statusCode": 500,
? "error": "EMR_401002",
? "message": "請求參數值無效",
? "returnObj": {
? "timestamp": "時間戳不能為null"
? }
}
請求參數無效示例3:
{
? "statusCode": 500,
? "error": "EMR_401002",
? "message": "請求參數值無效",
? "returnObj": {
? "timestamp": "時間戳必須是正整數"
? }
}
請求參數無效示例4:
{
? "statusCode": 500,
? "error": "EMR_401002",
? "message": "請求參數值無效",
? "returnObj": {
? "timestamp": "時間戳不在有效范圍內,請輸入不大于當前時間的時間戳(單位: 秒)"
? }
}
請求參數無效示例5:
{
? "statusCode": 500,
? "error": "EMR_401002",
? "message": "請求參數值無效",
? "returnObj": {
? "timestamp": "時間戳不在有效范圍內,請輸入不大于當前時間的時間戳(單位: 秒)"
? }
}
請求參數無效示例6:
{
? "statusCode": 500,
? "error": "EMR_401002",
? "message": "請求參數值無效",
? "returnObj": {
? "clusterId": "不能為空"
? }
}
請求參數無效示例7:
{
? "statusCode": 500,
? "error": "EMR_401002",
? "message": "請求參數值無效",
? "returnObj": {
? "clusterId": "無效的集群id"
? }
}
集群狀態不合法示例:
{
? "statusCode": 500,
? "error": "EMR_401006",
? "message": "非運行中集群無法查看信息,當前的集群狀態為:啟動中",
? "returnObj": {}
}
集群不涉及元數據組件示例:
{
? "statusCode": 500,
? "error": "EMR_401014",
? "message": "集群不涉及元數據組件",
? "returnObj": {}
}
集群不屬于該用戶示例:
{
? "statusCode": 500,
? "error": "EMR_401004",
? "message": "非法操作",
? "returnObj": {}
}
該集群不存在示例:
{
? "statusCode": 500,
? "error": "EMR_401005",
? "message": "該集群不存在",
? "returnObj": {}
}
請求失敗示例:
{
? "statusCode": 500,
? "error": "EMR_400000",
? "message": "請求失敗",
? "returnObj": {}
}
狀態碼
請參考
錯誤碼
請參考