云监控API调用是向云监控API的服务端地址发送HTTPS GET或POST请求。您需要按照API说明在请求中加入相应请求参数,调用后系统会返回处理结果。请求及返回结果都使用UTF-8字符集进行编码。

请求结构

云监控API是RPC风格,您可以通过发送HTTPS GET请求调用云监控API。

其请求结构如下:
https://Endpoint/?Action=xx&Parameters
请求结构中参数说明如下表所示。
参数 描述
Endpoint 云监控API的接入地址。各地域的接入地址,请参见接入地址
Action 要执行的操作,例如:调用DescribeMetricList接口查询指定云服务的指定监控项的监控数据。
Version 要使用的API版本。云监控的API版本是2019-01-01
Parameters 请求参数,每个参数之间用“&”分隔。

请求参数由公共请求参数和API自定义参数组成。公共参数中包含API版本号、身份验证等信息。更多信息,请参见公共参数

接入地址

以下表格分别罗列了各个地域的接入地址,其中接入地址一列包含如下信息:
  • 公网:互联网访问地址。
  • VPC:可在同地域内VPC中访问,无需开放公网访问权限。
地域名称 地域ID 接入地址
中国内地 不涉及 公网:metrics.aliyuncs.com
说明 在中国内地,您可以直接使用该统一公网接入地址,也可以使用所在地域的接入地址。
华东1(杭州) cn-hangzhou
  • 公网:metrics.cn-hangzhou.aliyuncs.com
  • VPC:metrics-vpc.cn-hangzhou.aliyuncs.com
华东2(上海) cn-shanghai
  • 公网:metrics.cn-shanghai.aliyuncs.com
  • VPC:metrics-vpc.cn-shanghai.aliyuncs.com
华南1(深圳) cn-shenzhen
  • 公网:metrics.cn-shenzhen.aliyuncs.com
  • VPC:metrics-vpc.cn-shenzhen.aliyuncs.com
华北1(青岛) cn-qingdao
  • 公网:metrics.cn-qingdao.aliyuncs.com
  • VPC:metrics-vpc.cn-qingdao.aliyuncs.com
华北2(北京) cn-beijing
  • 公网:metrics.cn-beijing.aliyuncs.com
  • VPC:metrics-vpc.cn-beijing.aliyuncs.com
华北3(张家口) cn-zhangjiakou
  • 公网:metrics.cn-zhangjiakou.aliyuncs.com
  • VPC:metrics-vpc.cn-zhangjiakou.aliyuncs.com
华北5(呼和浩特) cn-huhehaote
  • 公网:metrics.cn-huhehaote.aliyuncs.com
  • VPC:metrics-vpc.cn-huhehaote.aliyuncs.com
中国(香港) cn-hongkong
  • 公网:metrics.cn-hongkong.aliyuncs.com
  • VPC:metrics-vpc.cn-hongkong.aliyuncs.com
新加坡 ap-southeast-1
  • 公网:metrics.ap-southeast-1.aliyuncs.com
  • VPC:metrics-vpc.ap-southeast-1.aliyuncs.com
澳大利亚(悉尼) ap-southeast-2
  • 公网:metrics.ap-southeast-2.aliyuncs.com
  • VPC:metrics-vpc.ap-southeast-2.aliyuncs.com
马来西亚(吉隆坡) ap-southeast-3
  • 公网:metrics.ap-southeast-3.aliyuncs.com
  • VPC:metrics-vpc.ap-southeast-3.aliyuncs.com
印度尼西亚(雅加达) ap-southeast-5
  • 公网:metrics.ap-southeast-5.aliyuncs.com
  • VPC:metrics-vpc.ap-southeast-5.aliyuncs.com
日本(东京) ap-northeast-1
  • 公网:metrics.ap-northeast-1.aliyuncs.com
  • VPC:metrics-vpc.ap-northeast-1.aliyuncs.com
美国(硅谷) us-west-1
  • 公网:metrics.us-west-1.aliyuncs.com
  • VPC:metrics-vpc.us-west-1.aliyuncs.com
美国(弗吉尼亚) us-east-1
  • 公网:metrics.us-east-1.aliyuncs.com
  • VPC:metrics-vpc.us-east-1.aliyuncs.com
德国(法兰克福) eu-central-1
  • 公网:metrics.eu-central-1.aliyuncs.com
  • VPC:metrics-vpc.eu-central-1.aliyuncs.com
英国(伦敦) eu-west-1
  • 公网:metrics.eu-west-1.aliyuncs.com
  • VPC:metrics-vpc.eu-west-1.aliyuncs.com
印度(孟买) ap-south-1
  • 公网:metrics.ap-south-1.aliyuncs.com
  • VPC:metrics-vpc.ap-south-1.aliyuncs.com
阿联酋(迪拜) me-east-1
  • 公网:metrics.me-east-1.aliyuncs.com
  • VPC:metrics-vpc.me-east-1.aliyuncs.com

请求示例

调用DescribeMetricList接口查询指定云服务的指定监控项的监控数据,具体示例如下:
说明 为了便于您查看,本文档中的示例都做了格式化处理。
https://metrics.cn-hangzhou.aliyuncs.com/?Action=DescribeMetricList
&Format=xml
&Version=2019-01-01
&Signature=LbCj99dCxXdE9amsCivm0U4yT****
&SignatureMethod=HMAC-SHA1
&SignatureNonce=87d98ae51f0793f2c8638d3a9bdd****
&SignatureVersion=1.0
&AccessKeyId=LTAI4G4jDmmbPAG9CXfH****
&TimeStamp=2021-05-06T12:00:00Z
…