上传数据

上传数据

1.接口描述

2.参数说明

3.请求示例

4.响应

1.接口描述

域名：monitor.api.ksyun.com

VPC内调用域名：monitor.internal.api.ksyun.com

接口名: PutMetricData

请求方法：POST

Version=2017-07-01

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

2.参数说明

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

参数名称	必选	类型	描述
NameSpace	是	String	命名空间；一个命名空间表示一类资源，如云服务器
MetricName	是	String	指标名称；指标是监控的变量，监控数据是该变量随时间变化的数值，格式如：cpu.utilizition.total
Dimensions	是	String	指标对应的维度；用于说明指定资源的监控数据，Key-Value键值对形式的集合，格式如：“k1=v1”,“k2=v2” ，详见下方请求示例
Timestamp	是	String	UTC时间，格式如：2017-07-01T00:00:00Z； UTC时间，为北京时间减8小时， 如果采用北京时间，请减去8小时进行数据上传
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.请求示例

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

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

[
    {
        "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:05: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"
}