调用DescribeDBInstancePerformance查看某个实例在某个时间段内指定性能参数的性能监控数据。

调试

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

请求参数

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

系统规定参数。取值:DescribeDBInstancePerformance

ResourceGroupId String rg-bp67acfmxazb4p****

实例当前所属的资源组ID。如何获取资源组ID,请参见查看资源组基本信息

DBInstanceId String gp-bp12ga6v69h86****

实例ID。

说明 您可以调用DescribeDBInstances接口查看目标地域下所有的AnalyticDB PostgreSQL实例的实例ID。
Key String CpuUsage,MemoryUsage,Gpdb_SpaceUsage,Gpdb_IOPS,Gpdb_session

性能指标,多个指标用英文半角“,”分隔,见性能参数表

StartTime String 2022-07-08T03:47Z

查询开始时间,格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

EndTime String 2022-07-09T03:47Z

查询结束时间,需要大于查询开始时间,格式为yyy-MM-ddTHH:mmZ(UTC时间)。

返回数据

名称 类型 示例值 描述
EndTime String 2022-07-09T03:47Z

查询结束时间。

StartTime String 2022-07-08T03:47Z

查询开始时间。

DBInstanceId String gp-bp12ga6v69h86****

实例ID。

Engine String gpdb

数据库类型。

RequestId String 5E85244A-AB47-46A3-A3AD-5F307DCB407E

请求ID。

PerformanceKeys Array of String { "Key": "MemoryUsage", "GroupValues": [{ "Name": "7198315-1530522046144-1", "Values": "" }, { "Name": "7198315-1530522046144-0", "Values": "" }, {"Values": "", "Name": "master" } ], "Unit": "%", "ValueFormat": "mem_usage"}

数组格式:{perf1, perf2, perf3, …}。

示例

请求示例

http(s)://gpdb.aliyuncs.com/?Action=DescribeDBInstancePerformance
&DBInstanceId=gp-bp12ga6v69h86****
&Key=CpuUsage,MemoryUsage,Gpdb_SpaceUsage,Gpdb_IOPS,Gpdb_session
&StartTime=2022-07-08T03:47Z
&EndTime=2022-07-09T03:47Z
&公共请求参数

正常返回示例

XML格式

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

<DescribeDBInstancePerformanceResponse>
    <EndTime>2022-07-09T03:47Z</EndTime>
    <StartTime>2022-07-08T03:47Z</StartTime>
    <DBInstanceId>gp-bp12ga6v69h86****</DBInstanceId>
    <Engine>gpdb</Engine>
    <RequestId>5E85244A-AB47-46A3-A3AD-5F307DCB407E</RequestId>
    <PerformanceKeys> { "Key": "MemoryUsage",  "GroupValues": [{ "Name": "7198315-1530522046144-1", "Values": "" }, { "Name": "7198315-1530522046144-0",  "Values": "" }, {"Values": "",  "Name": "master" } ],  "Unit": "%",  "ValueFormat": "mem_usage"}</PerformanceKeys>
</DescribeDBInstancePerformanceResponse>

JSON格式

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

{
  "EndTime" : "2022-07-09T03:47Z",
  "StartTime" : "2022-07-08T03:47Z",
  "DBInstanceId" : "gp-bp12ga6v69h86****",
  "Engine" : "gpdb",
  "RequestId" : "5E85244A-AB47-46A3-A3AD-5F307DCB407E",
  "PerformanceKeys" : [ " { \"Key\": \"MemoryUsage\",  \"GroupValues\": [{ \"Name\": \"7198315-1530522046144-1\", \"Values\": \"\" }, { \"Name\": \"7198315-1530522046144-0\",  \"Values\": \"\" }, {\"Values\": \"\",  \"Name\": \"master\" } ],  \"Unit\": \"%\",  \"ValueFormat\": \"mem_usage\"}" ]
}

错误码

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