监控freehost

云监控开发指南开发指南接口简介欢迎使用阿里云监控(AlibabaCloudMonitor).
用户可以使用本文档介绍的API对云监控服务进行相关操作.
目前提供监控数据查询的接口.
请确保在使用这些接口前,已充分了解CloudMonitor产品说明和使用协议.
注意事项OpenAPI提供最近31天的监控数据.
调用方式服务地址CloudMonitorAPI的服务接入地址为metrics.
aliyuncs.
com通信协议支持通过HTTP进行请求通信请求方法支持HTTPGET方法发送请求,这种方式下请求参数需要包含在请求的URL中.
请求参数每个请求都需要包含公共的鉴权、签名相关请求参数和相关操作所特有的请求参数.
云监控开发指南1字符编码请求及返回结果都使用UTF-8字符集进行编码.
公共参数名称类型是否必须描述FormatString否返回值的类型,云监控仅支持JSONVersionString是API版本号,为日期形式:YYYY-MM-DD,本版本对应为2015-10-20AccessKeyIdString是阿里云颁发给用户的访问服务所用的密钥IDSignatureString是签名结果串,关于签名的计算方法,请参见.
SignatureMethodString是签名方式,目前支持HMAC-SHA1TimestampString是请求的时间戳.
日期格式按照ISO8601标准表示,并需要使用UTC时间.
格式为:YYYY-MM-DDThh:mm:ssZ例如,2014-01-10T12:00:00Z(为北京时间2014年1月10日20点0分0秒)SignatureVersionString是签名算法版本,目前版本是1.
0SignatureNonceString是唯一随机数,用于防止网络重放攻击.
用户在不同请求间要使用不同的随机数值RegionIdString是保留关键字,目前云监控全部使用cn-hangzhou云监控开发指南24.
5.
签名机制CloudMonitor服务会对每个访问的请求进行身份验证,使用HTTP需要在请求中包含签名(Signature)信息.
CloudMonitor通过使用AccessKeyID和AccessKeySecret进行对称加密的方法来验证请求的发送者身份.
AccessKeyID和AccessKeySecret由阿里云官方颁发给访问者(可以通过阿里云官方网站申请和管理),其中AccessKeyID用于标识访问者的身份;AccessKeySecret是用于加密签名字符串和服务器端验证签名字符串的密钥,必须严格保密,只有阿里云和用户知道.
Java签名算法可直接引用签名算法参考.
签名处理步骤使用请求参数构造规范化的请求字符串(CanonicalizedQueryString).
使用上一步构造的规范化字符串按照下面的规则构造用于计算签名的字符串.
其中HTTPMethod是提交请求用的HTTP方法,比GET.
percentEncode("/")是按照1.
b中描述的URL编码规则对字符"/"进行编码得到的值,即"%2F".
percentEncode(CanonicalizedQueryString)是对第1步中构造的规范化请求字符串按1.
b中描述的URL编码规则编码后得到的字符串按照RFC2104的定义,使用上面的用于签名的字符串计算签名HMAC值.
注意:计算签名时使用的Key就是用户持有的AccessKeySecret并加上一个"&"字符(ASCII:38),使用的哈希算法是SHA1.
按照Base64编码规则把上面的HMAC值编码成字符串,即得到签名值(Signature).
将得到的签名值作为Signature参数添加到请求参数中,即完成对请求签名的过程.
构造请求字符串的方法按照参数名称的字典顺序对请求中所有的请求参数(包括文档中描述的"公共请求参数"和给定了的请求接口的自定义参数,但不能包括"公共请求参数"中提到Signature参数本身)进行排序.
注:当使用GET方法提交请求时,这些参数就是请求URI中的参数部分(即URI中""之后由"&"连接的部分).
StringToSign=HTTPMethod+"&"+percentEncode(percentEncode(CanonicalizedQueryString)云监控开发指南34.
对每个请求参数的名称和值进行编码.
名称和值要使用UTF-8字符集进行URL编码.
a.
对于字符A-Z、a-z、0-9以及字符"不编码.
b.
对于其他字符编码成"%XY"的格式,其中XY是字符对应ASCII码的16进制表示.
比如英文的双引号(")对应的编码就是%22.
c.
对于扩展的UTF-8字符,编码成"%XY%ZA…"的格式.
d.
需要说明的是英文空格()要被编码是%20,而不是加号(+).
注:一般支持URL编码的库(比如Java中的java.
net.
URLEncoder)都是按照"application/x-www-form-urlencoded"的MIME类型的规则进行编码的.
实现时可以直接使用这类方式进行编码,把编码后的字符串中加号(+)替换成%20、星号(*)替换成%2A、%7E替换回波浪号(~),即可得到上述规则描述的编码字符串.
对编码后的参数名称和值使用英文等号(=)进行连接.
再把英文等号连接得到的字符串按参数名称的字典顺序依次使用&符号连接,即得到规范化请求字符串.
以QueryMetric为例,签名前的请求URL为:那么StringToSign就是:假如使用的AccessKeyId是"TestId",AccessKeySecret是"TestSecret",用于计算HMAC的Key就是"TestSecret&",则计算得到的签名值是:签名后的请求URL为(注意增加了Signature参数):http://metrics.
aliyuncs.
com/Action=QueryMetric&period=60&StartTime=2016-02-02T10:33:56Z&Dimensions={instanceId:'i-23gp0zfjl'}&Timestamp=2016-02-04T03:17:29Z&Project=acs_ecs&SignatureVersion=1.
0&Format=JSON&SignatureNonce=53fddcfe-422a-4177-b983-e33981c9084c&Version=2015-10-20&AccessKeyId=TestId&Metric=CPUUtilization&SignatureMethod=HMAC-SHA1&RegionId=cnGET&%2F&AccessKeyId%3DTestId%26Action%3DQueryMetric%26Dimensions%3D%257BinstanceId%253A%2527i-23gp0zfjl%2527%257D%26Format%3DJSON%26Metric%3DCPUUtilization%26Project%3Dacs_ecs%26RegionId%3Dcn%26SignatureMethod%3DHMAC-SHA1%26SignatureNonce%3D530b9e7a-71e5-4744-8548-77c5df29b8cb%26SignatureVersion%3D1.
0%26StartTime%3D2016-02-02T10%253A33%253A56Z%26Timestamp%3D2016-02-04T03%253A17%253A29Z%26Version%3D2015-10-20%26period%3D60IxsQ79fVwUu33iwZeH11Z2PfwqQ=http://metrics.
aliyuncs.
com/Action=QueryMetric&period=60&StartTime=2016-02-02T10%3A33%3A56Z&Dimensions=%7BinstanceId%3A%27i-23gp0zfjl%27%7D云监控开发指南4--------接口说明概述对CloudMonitor服务接口的调用是通过向CloudMonitor服务端发送HTTP请求(目前仅支持HTTP),并获取CloudMonitor服务对该请求响应结果的过程.
CloudMonitor服务端在接收到用户请求后,对请求做必要的身份验证和参数验证,在所有验证成功后根据请求的指定参数提交或完成相应操作,并把处理的结果以HTTP响应地形式返回给调用者.
请求组成请求由以下几个部分组成:HTTP方法——目前CloudMonitor服务的所有接口都支持GET方法的调用,上报监控数据还支持POST方法.
请求URL——请求的服务地址、要执行的操作名称、操作参数和公共请求参数都包含在请求的URL中.
服务端地址:CloudMonitor服务的域名是http://metrics.
aliyuncs.
com/.