描述

對于指定數據庫，查詢該數據庫的資源使用情況（例如磁盤）。

默認情況下，不需要傳入時間相關參數，此函數僅返回該實例當前（最近時間點）的資源使用情況。如果傳入指定的時間段參數，則可以返回該段時間內的數據。

說明 一次最多只容許返回 400 條監控數據，如果指定的（EndTime – StartTime）/ Interval > 400，則返回錯誤。

請求參數

名稱 類型 是否必須 描述
<公共請求參數> - - 參見公共參數
Action String 是 系統規定參數，取值：DescribeDatabaseResourceUsage。
InstanceId String 是 實例名。
DBName String 是 數據庫名。
StartTime String 否 查詢開始時間，格式如：2018-08-08T19:07:18Z。
EndTime String 否 查詢結束時間，格式如：2018-08-08T20:07:18Z，且大于查詢開始時間。
Interval String 否 間隔時間。

返回參數

名稱 類型 描述
<公共返回參數> String 參見公共返回參數。
MonitorDatas List<MonitorData> 監控數據組成的集合。
表 1. MonitorData參數
名稱 類型 描述
OtherSize Integer 剩余空間（DataSize+LogSize），單位：Byte，-1表示沒有數據。
DataSize Integer 數據文件占用空間，單位：Byte，-1表示沒有數據。
BinlogSize Integer 日志占用空間，單位：Byte，-1表示沒有數據。
TotalSize Integer 總共空間，單位：Byte，-1表示沒有數據。
Date String 計算日期，格式為：2018-08-08T19:07:18Z。

請求示例

https://petadata.aliyuncs.com/?Action=DescribeDatabaseResourceUsage
&InstanceId=pd-xxxxxxxxxxxxxx
&DBName=testdb
&<[公共請求參數]>

返回示例

XML格式

<DescribeDatabaseResourceUsageResponse>  
	<MonitorDatas>
		<MonitorData>
			<Date>2018-08-08T19:07:18Z</Date>
			<OtherSize>6400</OtherSize>
			<DataSize>12</DataSize>
			<TotalSize>6420</TotalSize>
			<BinlogSize>8</BinlogSize>
		</MonitorData>
	</MonitorDatas>
	<RequestId>3A21A8FF-BA22-4AE2-8A3A-4A15D0ACCAB5</RequestId>
</DescribeDatabaseResourceUsageResponse>

JSON格式

{
    "MonitorDatas":{
        "MonitorData":[
            {
                "Date":"2018-08-08T19:07:18Z",
                "OtherSize":6400,
                "DataSize":12,
                "TotalSize":6420,
                "BinlogSize":8
            }
        ]
    },
    "RequestId":"3A21A8FF-BA22-4AE2-8A3A-4A15D0ACCAB5"
}