调用DescribeDBClusterForecast接口查看指定日期内目标AnalyticDB MySQL版集群的磁盘水位、QPS和TPS的趋势预测信息。

关于趋势图的更多详情,请参见每日健康报告

调试

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

请求参数

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

系统规定参数。取值:DescribeDBClusterForecast

StartTime String 2021-08-30

需要查询的日期,格式为yyyy-MM-dd(UTC时间)。

DBClusterId String am-****************

集群ID。

说明 您可以调用DescribeDBClusters接口查看目标地域下所有AnalyticDB MySQL集群的详情,包括集群ID。
RegionId String cn-hangzhou

地域ID。

说明 您可以调用DescribeRegions接口查看AnalyticDB MySQL版支持的地域和可用区信息,包括地域ID。
MetricType String adbmysql_diskStatistics_disk_used

StartTime所设日期为起点,查看目标维度在指定时间内的趋势预测信息。其中维度取值如下:

  • adbmysql_diskStatistics_disk_used:以小时为粒度统计过去2周的磁盘水位信息,并预测未来2周的磁盘水位趋势。
  • adbmysql_qps_qps:以小时为粒度统计过去7天的QPS信息,并预测未来2天的QPS趋势。
  • adbmysql_tps_tps:以小时为粒度统计过去7天的TPS信息,并预测未来2天的TPS趋势。
说明 若该参数留空,则返回上述所有维度的趋势预测信息。

返回数据

名称 类型 示例值 描述
Performances Array of Performances

各指标详情。

Key String adbmysql_diskStatistics_disk_used

指标项。

Unit String MB

单位。

说明 仅当Keyadbmysql_diskStatistics_disk_used时,会返回该参数。
Series Array of Series

各时间点的指标项详情。

Name String fact

对应指标项在如下情况中的值:

  • fact:实际观测值。
  • yhat:趋势预测值。
  • yhatLower:趋势预测下限值。
  • yhatUpper:趋势预测上限值。
Values String ["2021-08-16 23:58:49","12889.5584"]

对应指标项在各时间点的具体取值。

RequestId String B6B60C7B-897D-5F95-A9E9-CCA23C******

请求ID。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeDBClusterForecast
&StartTime=2021-08-30
&DBClusterId=am-****************
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

<DescribeDBClusterForecastResponse>
    <RequestId>B6B60C7B-897D-5F95-A9E9-CCA23C******</RequestId>
    <Performances>
        <Series>
            <Values>
                <0>2021-08-16 23:58:49</0>
                <1>12889.5584</1>
            </Values>
            <Values>
                <0>2021-08-17 00:00:19</0>
                <1>12889.5823</1>
            </Values>
            <Name>fact</Name>
        </Series>
        <Series>
            <Values>
                <0>2021-08-16 23:58:49</0>
                <1>12923.9609</1>
            </Values>
            <Values>
                <0>2021-08-17 00:00:19</0>
                <1>12923.8966</1>
            </Values>
            <Name>yhat</Name>
        </Series>
        <Series>
            <Values>
                <0>2021-08-16 23:58:49</0>
                <1>12858.7716</1>
            </Values>
            <Values>
                <0>2021-08-17 00:00:19</0>
                <1>12854.6119</1>
            </Values>
            <Name>yhatLower</Name>
        </Series>
        <Series>
            <Values>
                <0>2021-08-16 23:58:49</0>
                <1>12992.0099</1>
            </Values>
            <Values>
                <0>2021-08-17 00:00:19</0>
                <1>12992.8980</1>
            </Values>
            <Name>yhatUpper</Name>
        </Series>
        <Unit>MB</Unit>
        <Key>adbmysql_diskStatistics_disk_used</Key>
    </Performances>
</DescribeDBClusterForecastResponse>

JSON格式

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

{
  "RequestId" : "B6B60C7B-897D-5F95-A9E9-CCA23C******",
  "Performances" : [ {
    "Series" : [ {
      "Values" : [ [ "2021-08-16 23:58:49", "12889.5584" ], [ "2021-08-17 00:00:19", "12889.5823" ] ],
      "Name" : "fact"
    }, {
      "Values" : [ [ "2021-08-16 23:58:49", "12923.9609" ], [ "2021-08-17 00:00:19", "12923.8966" ] ],
      "Name" : "yhat"
    }, {
      "Values" : [ [ "2021-08-16 23:58:49", "12858.7716" ], [ "2021-08-17 00:00:19", "12854.6119" ] ],
      "Name" : "yhatLower"
    }, {
      "Values" : [ [ "2021-08-16 23:58:49", "12992.0099" ], [ "2021-08-17 00:00:19", "12992.8980" ] ],
      "Name" : "yhatUpper"
    } ],
    "Unit" : "MB",
    "Key" : "adbmysql_diskStatistics_disk_used"
  } ]
}

错误码

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