该接口用于查询POLARDB集群节点的性能数据。

监控频率为60秒：

  • 查询范围大于等于30天时，采集粒度为1天。
  • 查询范围大于等于7天小于30天时，采集粒度为1小时。
  • 查询范围大于等于1天小于7天时，采集粒度为10分钟。
  • 查询范围小于1天时，采集粒度为1分钟。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
DBNodeId String 是 pi-xxxxxxxxxxxxxxx

数据库集群节点ID。
EndTime String 是 2012-06-08T15:00Z

查询结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

Key String 是 PolarDBDiskUsage

查询的性能指标，多个值用英文逗号（,）分隔，详细参数请参见性能参数表。

StartTime String 是 2012-06-08T01:00Z

查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

AccessKeyId String 否 key-test

阿里云颁发给用户的访问服务所用的密钥ID。
Action String 否 DescribeDBNodePerformance

系统规定参数，取值：DescribeDBNodePerformance。

返回数据

名称 类型 示例值 描述
DBNodeId String pi-xxxxxxxxxxxxxxx

数据库集群节点ID。
DBType String MySQL

兼容数据库类型。
DBVersion String 5.6

兼容数据库版本。
EndTime String 2012-06-08T15:00Z

查询结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

PerformanceKeys

集群性能数据列表。
PerformanceItem

集群性能数据列表。
Measurement String PolarDBDiskUsage

性能指标。
MetricName String mean_data_size

具体的性能指标度量名称。
Points

性能数据数组。
PerformanceItemValue

性能数据数组。
Timestamp Long 1571193960000

监控指标的具体时间点，时间戳（毫秒ms）。
Value String 14.25

监控指标数据值。
RequestId String A0ADCEAF-3277-48DE-B66D-4B67B120916C

请求ID。
StartTime String 2012-06-08T01:00Z

查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeDBNodePerformance
&DBNodeId=pi-xxxxxxxxxxxxxxx
&EndTime=2012-06-08T15:00Z
&Key=PolarDBDiskUsage
&StartTime=2012-06-08T01:00Z
&<公共请求参数>

正常返回示例

XML 格式 

<code>200</code>
<data>
    <PerformanceKeys>
        <PerformanceItem>
            <Measurement>PolarDBDiskUsage</Measurement>
            <MetricName>mean_data_size</MetricName>
            <Points>
                <PerformanceItemValue>
                    <Timestamp>1571193960000</Timestamp>
                    <Value>14.25</Value>
                </PerformanceItemValue>
            </Points>
        </PerformanceItem>
    </PerformanceKeys>
    <DBVersion>5.6</DBVersion>
    <RequestId>A0ADCEAF-3277-48DE-B66D-4B67B120916C</RequestId>
    <EndTime>2012-06-08T15:00Z</EndTime>
    <StartTime>2012-06-08T01:00Z</StartTime>
    <DBNodeId>pi-xxxxxxxxxxxxxxxx</DBNodeId>
    <DBType>MySQL</DBType>
</data>
<requestId>A0ADCEAF-3277-48DE-B66D-4B67B120916C</requestId>
<successResponse>true</successResponse>

JSON 格式 

{
	"successResponse":true,
	"requestId":"A0ADCEAF-3277-48DE-B66D-4B67B120916C",
	"data":{
		"DBVersion":"5.6",
		"RequestId":"A0ADCEAF-3277-48DE-B66D-4B67B120916C",
		"DBType":"MySQL",
		"PerformanceKeys":{
			"PerformanceItem":[
				{
					"Measurement":"PolarDBDiskUsage",
					"MetricName":"mean_data_size",
					"Points":{
						"PerformanceItemValue":[
							{
								"Value":"14.25",
								"Timestamp":1571193960000
							}
						]
					}
				}
			]
		},
		"EndTime":"2012-06-08T15:00Z",
		"StartTime":"2012-06-08T01:00Z",
		"DBNodeId":"pi-xxxxxxxxxxxxxxxx"
	},
	"code":"200"
}

错误码

访问错误中心查看更多错误码。