接口功能介绍
查询对象存储设备的实时监控数据。
接口约束
regionID(资源池)存在,且存在对象存储设备。
URI
POST /v4/monitor/query-zos-latestmetricdata
请求参数
请求体body参数
参数 | 参数类型 | 是否必填 | 示例 | 说明 | 下级对象 |
---|---|---|---|---|---|
regionID | String | 是 | 81f7728662dd11ec810800155d307d5b | 资源池ID | |
deviceUUIDList | Array of String | 是 | ["00cf583f-d993-5ae2-a477-a8a93e991bf4","11cf583f-a883-5ae2-a477-a8a93e991bf4"] | 查询设备ID列表,具体值参考监控对象查询返回字段deviceUUID | |
deviceType | String | 是 | 本参数表示设备类型,取值范围:1.zos_bucket:存储桶2.zos_user:用户 | 设备类型 | |
pageNo | Integer | 否 | 1 | 页码,默认为1 | |
pageSize | Integer | 否 | 1 | 页大小,默认为20 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败),默认值:800 | 800 | |
errorCode | String | 失败时的错误代码,参见公共错误码说明 | ||
message | String | 失败时的错误描述,一般为英文描述 | Success | |
msgDesc | String | 失败时的错误描述,一般为中文描述 | 成功 | |
returnObj | Object | 返回对象 | returnObj |
表returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
result | Array of Objects | 返回数据结果 | result | |
totalCount | Integer | 获取对象数据条数 | 138 | |
currentCount | Integer | 当前页记录数 | 10 | |
totalPage | Integer | 总页数 | 14 |
表result
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
regionID | String | 所属资源池ID | 81f7728662dd11ec810800155d307d5b | |
fUID | String | 唯一键 | 00cf583f-d993-5ae2-a477-a8a93e991bf4 | |
fuserLastUpdated | String | 最近更新时间 | 2022-11-07 18:25:12 | |
deviceUUID | String | 设备ID | 00cf583f-d993-5ae2-a477-a8a93e991bf4 | |
itemList | Object | 监控项内容 | itemList |
表itemList
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
samplingTime | Integer | 监控数据采集时间 | 1667816712 | |
{item1} | String | 监控项具体内容,具体监控项及含义参见 监控项列表:查询 | 19 | |
{item2} | String | 监控项具体内容 | 19 | |
... | String | 监控项具体内容 |
请求示例
POST /v4/monitor/query-zos-latestmetricdata
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"deviceUUIDList": [
"00cf583f-d993-5ae2-a477-a8a93e991bf4"
],
"deviceType": "zos_user",
"pageNo": 1,
"pageSize": 20
}
响应示例
{
"statusCode":800,
"returnObj":{
"result":[
{
"regionID":"81f7728662dd11ec810800155d307d5b",
"fUID":"00cf583f-d993-5ae2-a477-a8a93e991bf4",
"fuserLastUpdated":"2023-06-29 11:03:01",
"deviceUUID":"00cf583f-d993-5ae2-a477-a8a93e991bf4",
"itemList":{
"samplingTime":1688007781,
"zos_user_bytes_received_bps":"0.562",
"zos_user_bytes_sent_bps":"1.183",
"zos_user_glacier_inner_bytes_received":"0",
"zos_user_glacier_inner_bytes_sent":"0",
"zos_user_glacier_inner_ops":"0",
"zos_user_glacier_month_ops":"",
"zos_user_glacier_month_public_bytes_sent":"",
"zos_user_glacier_object_nums":"",
"zos_user_glacier_public_bytes_received":"0",
"zos_user_glacier_public_bytes_sent":"0",
"zos_user_glacier_public_ops":"0",
"zos_user_glacier_size_usage":"",
"zos_user_glacier_successful_ops_percent":"0",
"zos_user_ia_inner_bytes_received":"0",
"zos_user_ia_inner_bytes_sent":"0",
"zos_user_ia_inner_ops":"0",
"zos_user_ia_month_ops":"",
"zos_user_ia_month_public_bytes_sent":"",
"zos_user_ia_object_nums":"",
"zos_user_ia_public_bytes_received":"0",
"zos_user_ia_public_bytes_sent":"0",
"zos_user_ia_public_ops":"0",
"zos_user_ia_successful_ops_percent":"0",
"zos_user_inner_bytes_received":"0",
"zos_user_inner_bytes_received_bps":"0",
"zos_user_inner_bytes_sent":"0",
"zos_user_inner_bytes_sent_bps":"0",
"zos_user_inner_ops":"0",
"zos_user_month_ops":"",
"zos_user_month_public_bytes_sent":"",
"zos_user_multi_ia_size_usage":"",
"zos_user_multi_standard_size_usage":"",
"zos_user_object_nums":"",
"zos_user_public_bytes_received":"2022",
"zos_user_public_bytes_received_bps":"0.562",
"zos_user_public_bytes_sent":"4260",
"zos_user_public_bytes_sent_bps":"1.183",
"zos_user_public_ops":"19",
"zos_user_single_ia_size_usage":"",
"zos_user_single_standard_size_usage":"",
"zos_user_size_usage":"",
"zos_user_standard_inner_bytes_received":"0",
"zos_user_standard_inner_bytes_sent":"0",
"zos_user_standard_inner_ops":"0",
"zos_user_standard_month_ops":"",
"zos_user_standard_month_public_bytes_sent":"",
"zos_user_standard_object_nums":"",
"zos_user_standard_public_bytes_received":"2022",
"zos_user_standard_public_bytes_sent":"4260",
"zos_user_standard_public_ops":"19",
"zos_user_standard_successful_ops_percent":"100",
"zos_user_successful_ops_percent":"100"
}
}
],
"totalCount":1,
"currentCount":1,
"totalPage":1
},
"errorCode":"",
"message":"Success",
"msgDesc":"成功"
}
状态码
状态码 | 描述 |
---|---|
200 | 请求成功 |
错误码
errorCode | 描述 |
---|---|
Monitor.DataQuery.RegionNotFound | 找不到资源池 |
Monitor.DataQuery.ItemNameUndefined | 监控项未定义 |
Monitor.DataQuery.QueryError | 查询数据失败 |
Monitor.DataQuery.AccessFailed | 访问内部系统失败 |
Monitor.DataQuery.ResponseError | 访问内部系统返回错误 |
其他 | 参见公共错误码说明 |