調用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,用于查詢指定資源的監控數據。

格式為key-value鍵值對形式的集合,常用的key-value集合為instanceId:XXXXXX

keyvalue的長度為1~64個字節,超過64個字節時截取前64字節。keyvalue的取值可包含字母、數字、點號(.)、短橫線(-)、下劃線(_)、正斜線(/)和反斜線(\)。

說明 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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。