DescribeInstanceMonitorData

查询一台 ECS 实例所有相关的监控信息。返回的监控内容包括 ECS 实例的 CPU 使用率、接收的数据流量、发送的数据流量、网络流量、平均带宽。当返回信息中缺少部分内容时，可能是由于系统没有获取到相应的信息，比如当时实例处于已停止（Stopped）状态。

描述

调用该接口时，您需要注意：

每次最多返回 400 条监控数据，如果指定的参数 (EndTime – StartTime)/Peroid > 400 时，则返回错误。
单次最多能查询近 30 天内的监控信息，如果指定的参数 StartTime 超过 30 天，则返回错误。

调试

前往【API Explorer】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。

请求参数


名称	类型	是否必选	示例值	描述
EndTime	String	是	2014-10-30T08:00:00Z	获取数据的结束时间点。按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为：YYYY-MM-DDThh:mm:ssZ。如果指定的秒（ss）不是 00，则自动换算为下一分钟。
InstanceId	String	是	i-instnace1	待查询的实例 ID。
StartTime	String	是	2014-10-29T23:00:00Z	获取数据的起始时间点。按照 ISO8601 表示，并需要使用 UTC 时间，格式为：YYYY-MM-DDThh:mm:ssZ。如果指定的秒（ss）不是 00，则自动换算为下一分钟。
Action	String	否	DescribeInstanceMonitorData	系统规定参数。取值：DescribeInstanceMonitorData
OwnerAccount	String	否	ECSforCloud@Alibaba.com	RAM 用户的账号登录名称。
Period	Integer	否	60	获取监控数据的间隔时间，单位为秒。取值范围： 60 600 3600 默认值：60

返回参数


名称	类型	示例值	描述
MonitorData			实例的监控数据集合
└BPSRead	Integer	1000	实例系统盘读带宽，单位：Byte/s
└BPSWrite	Integer	200	实例系统盘写带宽，单位：Byte/s
└CPU	Integer	2	实例 vCPU 的使用比例，单位：百分比（%）
└CPUAdvanceCreditBalance	Float	0.4	超额积分（t5实例积分超限部分）。
└CPUCreditBalance	Float	120	突发性能（t5）实例积分总数。
└CPUCreditUsage	Float	30	突发性能（t5）实例已使用的积分数。
└CPUNotpaidSurplusCreditUsage	Float	0.5	超额未支付积分。
└IOPSRead	Integer	1000	实例系统盘 I/O 读操作，单位：次/s
└IOPSWrite	Integer	200	实例系统盘 I/O 写操作，单位：次/s
└InstanceId	String	i-instnace1	实例ID
└InternetBandwidth	Integer	10	实例的公网带宽，单位时间内的网络流量，单位：kbits/s
└InternetRX	Integer	122	实例在 TimeStamp 时刻接收的公网数据流量，单位：kbits
└InternetTX	Integer	343	实例在 TimeStamp 时刻发送的公网数据流量，单位：kbits
└IntranetBandwidth	Integer	10	实例的内网带宽，单位时间内的网络流量，单位：kbits/s
└IntranetRX	Integer	122	实例在 TimeStamp 时刻接收的内网数据流量，单位：kbits
└IntranetTX	Integer	343	实例在 TimeStamp 时刻发送的内网数据流量，单位：kbits
└TimeStamp	String	2010-01-21T09:50:23Z	查询监控信息的时间戳。按照 ISO8601 标准表示，并需要使用UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求 ID。无论调用接口成功与否，我们都会返回请求 ID。

示例

请求示例


https://ecs.aliyuncs.com/?Action=DescribeInstanceMonitorData
&EndTime=2014-10-30T08:00:00Z
&InstanceId=i-instnace1
&StartTime=2014-10-29T23:00:00Z
&Period=60
&<公共请求参数>

正常返回示例

XML 格式

<DescribeInstanceMonitorDataResponse>
  <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  <MonitorData>
    <InstanceMonitorData>
      <InstanceId>Bc0102-23xYm09</InstanceId>
      <CPU>2</CPU>
      <IntranetRX>122</IntranetRX>
      <IntranetTX>343</IntranetTX>
      <IntranetFlow>675</IntranetFlow>
      <IntranetBandwidth>10</IntranetBandwidth>
      <InternetRX>122</InternetRX>
      <InternetTX>343</InternetTX>
      <InternetFlow>675</InternetFlow>
      <InternetBandwidth>10</InternetBandwidth>
      <IOPSRead>1000</IOPSRead>
      <IOPSWrite>200</IOPSWrite>
      <BPSRead>1000</BPSRead>
      <BPSWrite>200</BPSWrite>
      <TimeStamp>2010-01-21T09:50:23Z</TimeStamp>
    </InstanceMonitorData>
  </MonitorData>
</DescribeInstanceMonitorDataResponse>

JSON 格式

{
	"RequestId":"C8B26B44-0189-443E-9816-D951F59623A9",
	"MonitorData":{
		"InstanceMonitorData":[
			{
				"IOPSRead":1000,
				"BPSWrite":200,
				"IntranetBandwidth":10,
				"IntranetTX":343,
				"IntranetRX":122,
				"InstanceId":"Bc0102-23xYm09",
				"InternetFlow":675,
				"CPU":0,
				"TimeStamp":"2010-01-21T09:50:23Z",
				"BPSRead":1000,
				"InternetRX":122,
				"IntranetFlow":675,
				"InternetBandwidth":10,
				"IOPSWrite":200,
				"InternetTX":343
			}
		]
	}
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidStartTime.ValueNotSupported	The specified parameter StartTime is later than EndTime.	结束时间不得早于开始时间。

查看本产品错误码

发布者：佚, 佚名，转转请注明出处：https://www.cms2.cn/aliyun/1867.html

DescribeInstanceMonitorData

描述

调试

请求参数

返回参数

示例

错误码

相关推荐

在弹性伸缩中使用负载均衡服务

让ESS更灵活的新特性

CancelTask

自动将伸缩组ECS实例添加到Redis实例白名单

使用实例启动模板创建实例

管理命令

发表评论