You can call this operation to query the monitoring data on snapshot capacity changes in a region over the past 30 days.

Description

When you call this operation, note that:

  • A maximum of 400 entries of monitoring data can be returned at a time. If the result of the (EndTime - StartTime)/Period formula is more than 400, an error is returned.
  • You can only query the monitoring data of the last 30 days. If the value of the StartTime parameter is more than 30 days ago, an error is returned.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
RegionId String Yes cn-hangzhou

The region ID of the instance. You can call the DescribeRegions operation to query the most recent region list.

StartTime String Yes 2019-05-10T00:00:00Z

The beginning of the time period in which to obtain the data of snapshot capacity changes. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the specified value of seconds (ss) is not 00, the time is rounded up to the next minute.

EndTime String Yes 2019-05-10T03:00:00Z

The end of the time period in which to obtain the data of snapshot capacity changes. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the specified value of seconds (ss) is not 00, the time is rounded up to the next minute.

Action String No DescribeSnapshotMonitorData

The operation that you want to perform. Set the value to DescribeSnapshotMonitorData.
Period Integer No 600

The interval for obtaining the data of snapshot capacity changes. Unit: seconds. Valid values: 600 to 3600.

Default value: 600.

Response parameters

Parameter Type Example Description
MonitorData

The collection of snapshot capacity change data.
DataPoint

The collection of snapshot capacity change data.
Size Long 243036848128

The total capacity of the snapshots. Unit: bytes.
TimeStamp String 2019-05-10T04:00:00Z

The timestamp corresponding to a snapshot capacity value.
RequestId String 9F8163A8-F5DE-47A2-A572-4E062D223E09

The ID of the request.

Examples

Sample requests

https://ecs.aliyuncs.com/?&Action=DescribeSnapshotMonitorData
&RegionId=cn-hangzhou
&StartTime=2019-05-10T00:00:00Z
&EndTime=2019-05-10T03:00:00Z
&Period=3600
&<Common request parameters>

Sample success responses

XML format 

<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 format 

{
	"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
			}
		]
	}
}

Error codes

HTTP status code Error code Error message Description
400 InvalidStartTime.Malformed The specified parameter "StartTime" is not valid. The error message returned because the format of the specified StartTime parameter is invalid.
400 InvalidEndTime.Malformed The specified parameter "EndTime" is not valid. The error message returned because the format of the specified EndTime parameter is invalid.
400 InvalidPeriod.ValueNotSupported The specified parameter "Period" is not valid. The error message returned because the specified Period parameter is invalid.
400 InvalidStartTime.TooEarly The specified parameter "StartTime" is too early. The error message returned because the specified StartTime parameter is earlier than the valid range of time.
400 InvalidParameter.TooManyDataQueried Too many data queried. The error message returned because the amount of queried monitoring data is out of range.
400 Throttling Request was denied due to request throttling. The error message returned because the system is busy. Try again later.

For a list of error codes, visit the API Error Center.