調用DescribeMetricLast接口查詢指定監控對象的最新監控數據。
關于各個阿里云產品的Project、Metric、Period、Dimensions等參數的取值,請參見DescribeMetricMetaList或預設監控項參考。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeMetricLast |
系統規定參數,取值:DescribeMetricLast。 |
MetricName | String | 是 | CPUUtilization |
監控項名稱。 |
Namespace | String | 是 | acs_ecs_dashboard |
產品的數據命名空間,用于區分不同的產品。 命名方式:acs_產品名。 |
Dimensions | String | 否 | [{"instanceId":"XXXXXX"}] |
維度map,用于查詢指定資源的監控數據。 格式為
說明
Dimensions 傳入時需要使用JSON字符串表示該map對象,必須按順序傳入。
|
EndTime | String | 否 | 2019-01-31 10:10:00 |
結束時間。 格式為Unix時間戳,即從1970年1月1日開始所經過的秒數。 說明 只能查詢270天以內的監控數據。
|
Express | String | 否 | {"groupby":["userId","instanceId"]} |
對現有查詢結果進行實時計算的表達式。 |
Length | String | 否 | 1000 |
返回監控數據的每頁大小,用于分頁查詢。 默認值為1000,即每頁1000條監控數據。 |
NextToken | String | 否 | 15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae**** |
分頁游標的標識。
|
Period | String | 否 | 60 |
時間間隔,通常為監控項的上報周期,單位為秒。 說明
|
StartTime | String | 否 | 2019-01-31 10:00:00 |
開始時間。 格式為Unix時間戳,即從1970年1月1日開始所經過的秒數。 說明 只能查詢270天以內且開始時間和結束時間不超過31天的監控數據。
|
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 021472A6-25E3-4094-8D00-BA4B6A5486C3 |
請求ID。 |
Code | String | 200 |
狀態碼。 說明 狀態碼為200表示成功。
|
Success | Boolean | true |
請求是否成功。 |
Period | String | 60 |
時間間隔,單位為秒。 |
NextToken | String | xxxxxx |
分頁游標標識。 |
Datapoints | String | [{"timestamp":1548777660000,"userId":"123","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92}] |
監控數據列表。 |
Message | String | Success |
錯誤信息。 |
示例
請求示例
http(s)://[Endpoint]/?Action=DescribeMetricLast
&MetricName=CPUUtilization
&Namespace=acs_ecs_dashboard
&<公共請求參數>
正常返回示例
XML
格式
<QueryMetricListResponse>
<Period>60</Period>
<Datapoints>
<Datapoints>
<timestamp>1490152860000</timestamp>
<Maximum>100</Maximum>
<userId> 123456789876****</userId>
<Minimum>93.1</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.52</Average>
</Datapoints>
<Datapoints>
<timestamp>1490152920000</timestamp>
<Maximum>100</Maximum>
<userId> 123456789876**** </userId>
<Minimum>92.59</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.49</Average>
</Datapoints>
<Datapoints>
<timestamp>1490152980000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>92.86</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.44</Average>
</Datapoints>
<Datapoints>
<timestamp>1490153040000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>91.43</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.36</Average>
</Datapoints>
<Datapoints>
<timestamp>1490153100000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>93.55</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.51</Average>
</Datapoints>
<Datapoints>
<timestamp>1490153160000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>93.1</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.52</Average>
</Datapoints>
<Datapoints>
<timestamp>1490153220000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>92.59</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.42</Average>
</Datapoints>
<Datapoints>
<timestamp>1490153280000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>91.18</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.34</Average>
</Datapoints>
<Datapoints>
<timestamp>1490153340000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>92.86</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.46</Average>
</Datapoints>
<Datapoints>
<timestamp>1490153400000</timestamp>
<Maximum>100</Maximum>
<userId>123456789876****</userId>
<Minimum>91.18</Minimum>
<instanceId>i-abcdefgh12****</instanceId>
<Average>99.35</Average>
</Datapoints>
</Datapoints>
<RequestId>6661EC50-8625-4161-B349-E0DD59002AB7</RequestId>
<Success>true</Success>
<Code>200</Code>
</QueryMetricListResponse>
JSON
格式
{
"Period":"60",
"Datapoints":[
{
"timestamp":1490152860000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":93.1,
"Average":99.52
},
{
"timestamp":1490152920000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":92.59,
"Average":99.49
},
{
"timestamp":1490152980000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":92.86,
"Average":99.44
},
{
"timestamp":1490153040000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":91.43,
"Average":99.36
},
{
"timestamp":1490153100000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":93.55,
"Average":99.51
},
{
"timestamp":1490153160000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":93.1,
"Average":99.52
},
{
"timestamp":1490153220000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":92.59,
"Average":99.42
},
{
"timestamp":1490153280000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":91.18,
"Average":99.34
},
{
"timestamp":1490153340000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":92.86,
"Average":99.46
},
{
"timestamp":1490153400000,
"Maximum":100,
"userId":"123456789876****",
"instanceId":"i-abcdefgh12****",
"Minimum":91.18,
"Average":99.35
}
],
"RequestId":"6A5F022D-AC7C-460E-94AE-B9E75083D027",
"Success":true,
"Code":"200"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。