DescribeDBClusterResourcePoolPerformance - 云原生数仓 AnalyticDB MySQL

说明您还可以在控制台上以图表的形式查看AnalyticDB MySQL版弹性模式集群版（新版）资源池监控信息。更多详细信息，请参见查看监控信息。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeDBClusterResourcePoolPerformance	系统规定参数。取值：DescribeDBClusterResourcePoolPerformance。
DBClusterId	String	是	am-****************	集群ID。说明您可以调用DescribeDBClusters接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。
Key	String	否	AnalyticDB_RP_CPU	资源池数据监控指标。允许同时输入多个指标进行查询，多个指标间用英文逗号（,）分隔。支持监控如下指标： AnalyticDB_RP_CPU ：CPU平均使用率，单位：%。 AnalyticDB_RP_RT：查询响应时间（RT），单位：毫秒（ms）。 AnalyticDB_RP_QPS：每秒查询率（QPS），单位：数值。 AnalyticDB_RP_WaitTime：查询等待时间，单位：毫秒（ms）。 AnalyticDB_RP_OriginalNode：资源池基础节点数。 AnalyticDB_RP_ActualNode：资源池分时弹性实际弹出的节点数（即执行扩容计划时实际增加的节点数）。 AnalyticDB_RP_PlanNode：资源池分时弹性计划弹出的节点数。 AnalyticDB_RP_TotalNode：资源池拥有的总节点数，总节点数=基础节点数+分时弹性计划中实际生效的节点数。说明若该参数留空，默认返回所有指标的监控数据详情。更多关于资源池弹性计划的信息，请参见资源弹性扩容。
ResourcePools	String	否	TEST_POOL	目标资源池名称。允许同时输入多个资源池名称进行查询，多个名称间用英文逗号（,）分隔。说明输入的资源池名称不区分大小写，例如`USER_DEFAULT`与`user_default`表示的是同一个资源池。若该参数留空，将返回`USER_DEFAULT`即默认资源池的监控信息。
StartTime	String	是	2021-06-10T07:00Z	资源池数据监控开始时间。格式为yyyy-MM-ddTHH:mmZ（UTC时间）。说明仅支持查看最近2天的资源池监控信息。
EndTime	String	是	2021-06-10T07:01Z	资源池数据监控结束时间，结束时间需晚于开始时间。格式为yyyy-MM-ddTHH:mmZ（UTC时间）。

返回数据


名称	类型	示例值	描述
EndTime	String	2021-06-10T07:01:00Z	资源池数据监控结束时间，格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
RequestId	String	C7EDB8E4-9769-4233-88C7-DCA4C9******	请求ID。
StartTime	String	2021-06-10T07:00:00	资源池数据监控开始时间，格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
DBClusterId	String	am-****************	集群ID。
Performances	Array of PerformanceItem		以监控指标为维度的数据详情列表。
Key	String	AnalyticDB_RP_CPU	资源池数据监控指标。
Unit	String	%	监控指标的单位。
ResourcePoolPerformances	Array of ResourcePoolPerformancesItem		以资源池为维度的监控数据列表。
ResourcePoolName	String	test_pool	资源池名称。
ResourcePoolSeries	Array of ResourcePoolSeriesItem		资源池监控数据的序列列表。
Values	Array of String	["2021-06-10T07:00:22.601Z","0.0000"],["2021-06-10T07:00:52.62Z","0.0312"]	不同时间点下的资源池监控项数值。
Name	String	cpu	监控指标名称。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeDBClusterResourcePoolPerformance
&DBClusterId=am-****************
&StartTime=2021-06-10T07:00Z
&EndTime=2021-06-10T07:01Z
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDBClusterResourcePoolPerformanceResponse>
    <RequestId>C7EDB8E4-9769-4233-88C7-DCA4C9******</RequestId>
    <EndTime>2021-06-10T07:01:00Z</EndTime>
    <StartTime>2021-06-10T07:00:00Z</StartTime>
    <Performances>
        <ResourcePoolPerformances>
            <ResourcePoolSeries>
                <Values>
                    <0>2021-06-10T07:00:22.601Z</0>
                    <1>0.0000</1>
                </Values>
                <Values>
                    <0>2021-06-10T07:00:52.62Z</0>
                    <1>0.0312</1>
                </Values>
                <Name>cpu</Name>
            </ResourcePoolSeries>
            <ResourcePoolName>test_pool</ResourcePoolName>
        </ResourcePoolPerformances>
        <Unit>%</Unit>
        <Key>AnalyticDB_RP_CPU</Key>
    </Performances>
</DescribeDBClusterResourcePoolPerformanceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C7EDB8E4-9769-4233-88C7-DCA4C9******",
  "EndTime" : "2021-06-10T07:01:00Z",
  "StartTime" : "2021-06-10T07:00:00Z",
  "Performances" : [ {
    "ResourcePoolPerformances" : [ {
      "ResourcePoolSeries" : [ {
        "Values" : [ [ "2021-06-10T07:00:22.601Z", "0.0000" ], [ "2021-06-10T07:00:52.62Z", "0.0312" ] ],
        "Name" : "cpu"
      } ],
      "ResourcePoolName" : "test_pool"
    } ],
    "Unit" : "%",
    "Key" : "AnalyticDB_RP_CPU"
  } ]
}

错误码


HttpCode	错误码	错误信息	描述
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。

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