查看磁盘的监控信息
描述
分页查询本用户的指定磁盘的相关监控信息。
只能查询到状态 In_use 状态的磁盘的监控信息。
可返回的监控内容包括：磁盘的读 IOPS，磁盘的写 IOPS，磁盘的读带宽(Bps)，磁盘的写带宽(Bps)，磁盘的读延时(ms)，磁盘的写延时(ms)。有可能返回的监控内容中会缺少部分内部，这可能是由于系统没有获得到相应的信息，比如磁盘不在 In_use 状态。
一次最大只容许返回 400 条监控数据，如果指定的 (EndTime – StartTime)/ Peroid > 400，则返回错误。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 系统规定参数，取值：DescribeDiskMonitorData |
| DiskId | String | 是 | 指定监控的磁盘 ID |
| StartTime | String | 是 | 获取数据的起始时间点：按照 ISO8601 标准表示，并需要使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ。 如果秒不是 00，则自动取为下一分钟开始时 |
| EndTime | String | 是 | 获取数据的结束时间点：按照 ISO8601 标准表示，并需要使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ。 如果秒不是 00，则自动取为下一分钟开始时 |
| Period | Integer | 否 | 获取监控数据的精度:
默认 60 秒。 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| TotalCount | Integer | 磁盘监控数据的总个数 |
| MonitorData | DiskMonitorDataType | 磁盘的监控数据 DiskMonitorDataType 组成的集合。 |
错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
|---|---|---|---|
| InvalidDiskId.NotFound | The DiskId provided does not exist in our records. | 404 | 磁盘 ID 不存在 |
| MissingParameter | The input parameter "DiskId" that is mandatory for processing this request is not supplied. | 400 | 缺少 Disk ID 参数 |
| InvalidStartTime.Malformed | The specified parameter "StartTime" is not valid. | 400 | StartTime 格式不合法 |
| MissingParameter | The input parameter "StartTime" that is mandatory for processing this request is not supplied. | 400 | 缺少 StartTime 值 |
| InvalidEndTime.Malformed | The specified parameter "EndTime" is not valid. | 400 | 指定的 EndTime 格式不合法 |
| MissingParameter | The input parameter "EndTime" that is mandatory for processing this request is not supplied. | 400 | 缺少 EndTime 值 |
| InvalidParameter | The specified parameter "Period" is not valid. | 400 | 指定的 Period 不是数字 |
| InvalidPeriod.ValueNotSupported | The specified parameter "Period" is not valid. | 400 | 指定的 Period 格式不合法 |
| InvalidStartTime.TooEarly | The specified parameter "StartTime" is too early. | 400 | 指定的 StartTime 太早 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-mydisk001
&StartTime=2014-07-23T12:07:00Z
&EndTime=2014-07-23T12:09:00Z
&<公共请求参数>
返回示例
JSON格式
{
"MonitorData": {
"DiskMonitorData": [
{
"BPSRead": 0,
"BPSTotal": 0,
"BPSWrite": 0,
"DiskId": "d-23b3p4r8b",
"IOPSRead": 0,
"IOPSTotal": 0,
"IOPSWrite": 0,
"TimeStamp": "2014-07-23T12:07:00Z"
},
{
"BPSRead": 0,
"BPSTotal": 204,
"BPSWrite": 204,
"DiskId": "d-23b3p4r8b",
"IOPSRead": 0,
"IOPSTotal": 0,
"IOPSWrite": 0,
"TimeStamp": "2014-07-23T12:08:00Z"
},
{
"BPSRead": 0,
"BPSTotal": 819,
"BPSWrite": 819,
"DiskId": "d-23b3p4r8b",
"IOPSRead": 0,
"IOPSTotal": 0,
"IOPSWrite": 0,
"TimeStamp": "2014-07-23T12:09:00Z"
}
]
},
"RequestId": "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
"TotalCount": 3
}