调用DescribeRDSPerformance接口查询存储层RDS性能数据详情。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeRDSPerformance

系统固定参数，取值为DescribeRDSPerformance。

DrdsInstanceId String 是 drds*********

PolarDB-X实例ID。
Keys String 是 MySQL_MemCpuUsage

性能监控指标，允许一次传入多个指标进行查询，多个指标参数间用英文逗号（,）隔开。

说明 更多关于性能监控指标详情，请参见存储监控。
RdsInstanceId String 是 rm-************

存储层RDS实例ID。
StartTime Long 否 1603123290000

查询开始时间，格式为Unix时间戳（UTC时间），单位为毫秒。
EndTime Long 否 1603209690000

查询结束时间，格式为Unix时间戳（UTC时间），单位为毫秒。
DbInstType String 否 mysql

数据库引擎类型。

返回数据

名称 类型 示例值 描述
Data Array of PartialPerformanceData

查询结果集。
Key String cpuusage

监控指标名称。
NodeName String pi-*************

节点名称。

说明 仅数据库存储类型为PolarDB MySQL时返回该参数，RDS MySQL不会返回该参数。
NodeNum Integer 1

节点数量。
Unit String %

监控指标的单位。
Values Array of PerformanceValue

监控指标数据详情。
Date Long 1603209660000

获取监控指标数值的时间点，格式为Unix时间戳（UTC时间），单位为毫秒。
Value String 0.58

监控指标数值。
RequestId String DB53EC68-463C-4187-8D2B-C2AD8C******

请求ID。
Success Boolean true

请求是否成功。

示例

请求示例

http(s)://drds.cn-hangzhou.aliyuncs.com/?Action=DescribeRDSPerformance
&DrdsInstanceId=drds*********
&Keys=MySQL_MemCpuUsage
&RdsInstanceId=rm-************
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeRDSPerformanceResponse>
  <RequestId>DB53EC68-463C-4187-8D2B-C2AD8C******</RequestId>
  <Data>
        <NodeNum>1</NodeNum>
        <Values>
              <Value>0.58</Value>
              <Date>1603209660000</Date>
        </Values>
        <Unit>%</Unit>
        <Key>cpuusage</Key>
  </Data>
  <Data>
        <NodeNum>1</NodeNum>
        <Values>
              <Value>9.75</Value>
              <Date>1603209660000</Date>
        </Values>
        <Unit>%</Unit>
        <Key>memusage</Key>
  </Data>
  <Success>true</Success>
</DescribeRDSPerformanceResponse>

JSON 格式 

{
	"RequestId": "DB53EC68-463C-4187-8D2B-C2AD8C******",
	"Data": [
		{
			"NodeNum": 1,
			"Values": [
				{
					"Value": "0.58",
					"Date": 1603209660000
				}
			],
			"Unit": "%",
			"Key": "cpuusage"
		},
		{
			"NodeNum": 1,
			"Values": [
				{
					"Value": "9.75",
					"Date": 1603209660000
				}
			],
			"Unit": "%",
			"Key": "memusage"
		}
	],
	"Success": true
}

错误码

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