调用DescribeSnapshotMonitorData查询一个地域下近30天内的快照容量变化监控数据。
接口说明
调用该接口时，您需要注意：
- 每次最多返回400条监控数据，如果指定的参数
(EndTime - StartTime)/Period大于400时，则返回错误。 - 单次最多能查询近30天内的监控信息，如果指定的参数
StartTime超过30天，则返回错误。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeSnapshotMonitorData |
系统规定参数。取值：DescribeSnapshotMonitorData |
| EndTime | String | 是 | 2019-05-10T03:00:00Z |
获取快照容量变化数据的结束时间点。按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。如果指定的秒（ss）不是 00，则自动换算为下一分钟。 |
| RegionId | String | 是 | cn-hangzhou |
地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| StartTime | String | 是 | 2019-05-10T00:00:00Z |
获取快照容量变化数据的起始时间点。按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。如果指定的秒（ss）不是 00，则自动换算为下一分钟。 |
| Period | Integer | 否 | 60 |
获取快照容量变化数据的间隔时间，单位为秒。取值范围：
默认值：60 |
| Category | String | 否 | Standard |
快照类型。取值范围：
默认值：Standard |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| MonitorData | Array of DataPoint |
快照容量变化数据的集合。 |
|
| DataPoint | |||
| Size | Long | 243036848128 |
快照总容量，单位：字节（Byte）。 |
| TimeStamp | String | 2019-05-10T04:00:00Z |
某一快照容量数值对应的时间戳。 |
| RequestId | String | 9F8163A8-F5DE-47A2-A572-4E062D223E09 |
请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?&Action=DescribeSnapshotMonitorData
&RegionId=cn-hangzhou
&StartTime=2019-05-10T00:00:00Z
&EndTime=2019-05-10T03:00:00Z
&Period=60
&<公共请求参数>正常返回示例
XML 格式
<DescribeSnapshotMonitorDataResponse>
<MonitorData>
<DataPoint>
<element>
<Size>243036848128</Size>
<TimeStamp>2019-05-10T01:00:00Z</TimeStamp>
</element>
<element>
<Size>243036848128</Size>
<TimeStamp>2019-05-10T02:00:00Z</TimeStamp>
</element>
<element>
<Size>243036848128</Size>
<TimeStamp>2019-05-10T03:00:00Z</TimeStamp>
</element>
</DataPoint>
</MonitorData>
<RequestId>9F8163A8-F5DE-47A2-A572-4E062D223E09</RequestId>
</DescribeSnapshotMonitorDataResponse>JSON 格式
{
"RequestId": "9F8163A8-F5DE-47A2-A572-4E062D223E09",
"MonitorData": {
"DataPoint": [
{
"TimeStamp": "2019-05-10T01:00:00Z",
"Size": 243036848128
},
{
"TimeStamp": "2019-05-10T02:00:00Z",
"Size": 243036848128
},
{
"TimeStamp": "2019-05-10T03:00:00Z",
"Size": 243036848128
}
]}
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidStartTime.Malformed | The specified parameter "StartTime" is not valid. | 指定的开始时间格式不合法。 |
| 400 | InvalidEndTime.Malformed | The specified parameter "EndTime" is not valid. | 指定的结束时间格式不合法。 |
| 400 | InvalidPeriod.ValueNotSupported | The specified parameter "Period" is not valid. | 指定的Period参数不合法。 |
| 400 | InvalidStartTime.TooEarly | The specified parameter "StartTime" is too early. | 指定的开始时间太早。 |
| 400 | InvalidParameter.TooManyDataQueried | Too many data queried. | 监控数据节点超出范围。 |
| 400 | Throttling | Request was denied due to request throttling. | 当前的操作太过频繁，请稍后重试。 |
访问错误中心查看更多错误码。
