调用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
}

错误码

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