实时监控数据查询(v4.2) - 混合云OpenAPI4.0

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

service

string

必需

云监控服务
vm-云主机；disk-云硬盘；bare_metal-裸金属；elb-负载均衡；eip-弹性ip；traffic-共享带宽；listener-监听器；scaling-弹性伸缩组；cstor_sfs-弹性文件；pushgateway_hpfs-并行文件

dimension

string

可选

云监控维度(暂不支持)

itemNameList

array[string]

必需

监控项指标(调用监控项列表查询接口/v4/monitor/query-monitor-items获取)

dimensions

array [object {2}]

必需

name

string

设备标签键

必需

value

array[string]

必需

设备标签键所对应的值
1.vm-云主机uuid 2.pushgateway_hpfs-并行文件uuid 3.disk-云硬盘uuid前20位 4.bare_metal-裸金属id 5.elb-负载均衡uuid(例:lb-f8lo6ya6mt) 6.eip-ip地址(例:100.127.176.100) 7.traffic-共享带宽id(例:bandwidth-zzvlrnorne) 8.listener-监听器uuid(例:listener-005oxpybzk) 9.scaling-弹性伸缩组uuid 10.cstor_sfs-弹性文件uuid(例:01v1aj2as5bg34uq)

示例

{
    "regionID": "2022guizhou_duoaz_siyouyun_test",
    "service": "vm",
    "itemNameList": [
        "free_disk_space_on"
    ],
    "dimensions": [
        {
            "name": "uuid",
            "value": [
                "f0cffc36-0a0c-f6d5-2896-e78ae9be1cca"
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4.2/monitor/query-latest-metric-data' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "2022guizhou_duoaz_siyouyun_test",
    "service": "vm",
    "itemNameList": [
        "free_disk_space_on"
    ],
    "dimensions": [
        {
            "name": "uuid",
            "value": [
                "f0cffc36-0a0c-f6d5-2896-e78ae9be1cca"
            ]
        }
    ]
}'

返回响应

🟢200successful operation

application/json

Body

description

string

失败时的错误描述

必需

errorCode

string

具体错误码标志

必需

message

string

失败时的错误信息

必需

returnObj

object

返回参数

必需

result

array [object {3}]

result对象

必需

statusCode

integer

必需

返回状态码(800为成功，900为失败)

示例

{
    "description": "成功 X-Trace-ID-->cb2ddedba7ba9669",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "result": [
            {
                "regionID": "nm8",
                "deviceUUID": "f0cffc36-0a0c-f6d5-2896-e78ae9be1cca",
                "itemList": [
                    {
                        "dimensions": [
                            {
                                "name": "fs_dir",
                                "value": "/"
                            }
                        ],
                        "itemName": "free_disk_space_on",
                        "timestamp": 1719480314,
                        "value": "40040292352"
                    }
                ]
            }
        ]
    },
    "statusCode": 800
}