上传数据

最近更新时间:2019-11-21 11:30:51

上传数据

1.接口描述

2.参数说明

3.POST样式

4.响应

1.接口描述

域名:monitor.region.api.ksyun.com

接口名: PutMetricData

请求方法:POST

Version=2017-07-01

对已有指标的数据写入,或者发布新的指标。

2.参数说明

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。
其中此接口的Action字段为PutMetricData。推荐使用SDK

参数名称 必选 类型 描述
NameSpace String 命名空间。
MetricName String 指标名称
Dimensions String 指标对应的维度,格式:k1=v1,k2=v2
Timestamp String UTC时间,格式如:2017-07-01T00:00:00Z
Value float64 指标上传的数值
Unit String 指标对应的单位

Unit支持:(Seconds|Microseconds|Milliseconds|Bytes|Kilobytes|Megabytes|Gigabytes|Terabytes|Bits|Kilobits|Megabits|Gigabits|Terabits|Percent|Count|Bytes/Second|Kilobytes/Second| Megabytes/Second|Gigabytes/Second| Terabytes/Second| Bits/Second| Kilobits/Second|Megabits/Second|Gigabits/Second|Terabits/Second|Count/Second|None)`

3.POST样式

https://monitor.domain.api.ksyun.com?
Action=PutMetricData
&Version=2017-07-01

用户可以一次提交多条统计数据,数据放在消息体中,遵循 JSON 格式。 tao部门有xiaojin产品,监控该产品的内容:

[
    {
        "nameSpace": "tao",
        "metricName": "api_exist",
        "timestamp": "2017-07-03T12:04:00Z",
        "value": 1.2,
        "dimensions": [
            "product=xiaojin",
            "apiname=apinameA"      
        ],
        "unit": "Seconds"
    },
    {
        "nameSpace": "xiaojin",
        "metricName": "api_exist",
        "timestamp": "2017-07-03T12:04:00Z",
        "value": 0.01,
        "dimensions": [
            "product=xiaojin",
            "apiname=apinameB"      
        ],
        "unit": "Seconds"
    }
]

4.响应

参数名称 类型 描述
Message String 请求的返回信息。
RequestId String 请求ID,标识定位请求。

例如:

{
    "responseMetadata": {
        "requestId": "337a5f92-a2c5-4ade-8be6-18526ab5faa6"
    },
    "message": "SUCCESS"
}

金山云,开启您的云计算之旅

注册有礼