调用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\"}" ]
}
错误码
访问错误中心查看更多错误码。