DescribeDBInstancePerformance - ApsaraDB RDS

根據績效參數查看某個執行個體、某時間段範圍內的效能監控資料。根據版本、監控頻率（ModifyDBInstanceMonitor）和查詢時間範圍的不同，有如下幾種輸出形式：

除MySQL 5.7高可用雲端硬碟版和MariaDB之外的版本：
- 監控頻率為5秒：
  - 查詢時間範圍大於7天，採集粒度為1天；
  - 查詢時間範圍大於1天，小於等於7天，採集粒度為1小時；
  - 查詢時間範圍大於1小時，小於等於1天，採集粒度為1分鐘；
  - 查詢時間範圍小於等於1小時，採集粒度為5秒。
- 監控頻率為60秒：
  - 查詢範圍大於30天的，採集粒度為1天；
  - 查詢範圍大於7天小於等於30天的，採集粒度為1小時；
  - 查詢範圍小於等於7天的，採集粒度為1分鐘。
- 監控頻率為300秒：
  - 查詢範圍大於30天的，採集粒度為1天；
  - 查詢範圍大於7天小於等於30天的，採集粒度為1小時；
  - 查詢範圍小於等於7天的，採集粒度為5分鐘。
MySQL 5.7高可用雲端硬碟版和MariaDB：
- 查詢範圍大於30天的，採集粒度為1天；
- 查詢範圍大於7天小於等於30天的，採集粒度為1小時；
- 查詢範圍小於等於7天的，採集粒度為1分鐘。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數


名稱	類型	是否必選	樣本值	描述
Action	String	是	DescribeDBInstancePerformance	系統規定參數，取值：DescribeDBInstancePerformance。
DBInstanceId	String	是	rm-uf6wjk5xxxxxxx	執行個體ID。
Key	String	是	MySQL_Sessions	想要查詢的效能指標，多個值用英文逗號（,）分隔，詳細參數請參見績效參數表。说明 Key為MySQL_SpaceUsage或SQLServer_SpaceUsage時，僅支援查詢1天內的監控資料。
StartTime	String	是	2012-06-08T15:00Z	查詢開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。
EndTime	String	是	2012-06-18T15:00Z	查詢結束時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。

返回資料


名稱	類型	樣本值	描述
DBInstanceId	String	rm-uf6wjk5xxxxxxxxxx	執行個體ID。
Engine	String	MySQL	資料庫類型。
StartTime	String	2012-06-10T15:00Z	查詢開始時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。
EndTime	String	2012-06-19T15:00Z	查詢結束時間。格式：yyyy-MM-ddTHH:mmZ（UTC時間）。
PerformanceKeys			執行個體績效參數列表。
Key	String	MySQL_Sessions	績效參數。
Unit	String	KB	資料單位。
ValueFormat	String	recv_k&sent_k	效能值的格式。如果效能值由多個參數構成，以“&”分隔，例如com_delete&com_insert&com_insert_select&com_replace。
Values			數組格式：{value1, value2, …}。
Value	String	0.0&13.6	效能值。
Date	String	2011-05-30T03:29:00Z	記錄日期。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。
RequestId	String	A5409D02-D661-4BF3-8F3D-0A814D0574E7	請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=DescribeDBInstancePerformance
&DBInstanceId= rm-uf6wjk5xxxxxxx
&Key=MySQL_Sessions
&StartTime=2012-06-08T15:00Z
&EndTime=2012-06-18T15:00Z
&<公用請求參數>

正常返回樣本

XML 格式

<DescribeDBInstancePerformanceResponse>
	  <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
	  <DBInstanceID> rm-uf6wjk5xxxxxxx</DBInstanceID>
	  <StartTime>2012-06-11T15:00Z</StartTime>
	  <EndTime>2013-10-17T15:00Z</EndTime>
	  <Engine>MySQL</Engine>
	  <PerformanceKeys>
		    <PerformanceKey>
			      <Key>MySQL_NetworkTraffic</Key>
			      <Unit>KB</Unit>
			      <ValueFormat>recv_k&amp;sent_k</ValueFormat>
			      <Values></Values>
		    </PerformanceKey>
	  </PerformanceKeys></DescribeDBInstancePerformanceResponse>

JSON 格式

{
	"DBInstanceID":" rm-uf6wjk5xxxxxxx",
	"RequestId":"A5409D02-D661-4BF3-8F3D-0A814D0574E7",
	"PerformanceKeys":{
		"PerformanceKey":[
			{
				"Values":{
					"PerformanceValue":[]
				},
				"Key":"MySQL_NetworkTraffic",
				"Unit":"KB",
				"ValueFormat":"recv_k&sent_k"
			}
		]
	},
	"EndTime":"2013-10-17T15:00Z",
	"StartTime":"2012-06-11T15:00Z",
	"Engine":"MySQL"
}

錯誤碼

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