All Products
Search
Document Center

Elastic Compute Service:DescribeSnapshotMonitorData

Last Updated:Mar 19, 2024

Queries the monitoring data of snapshot sizes in a region within the last 30 days.

Operation description

Take note of the following items:

  • Up to 400 entries of monitoring data can be returned at a time. If the result of the (EndTime - StartTime)/Period formula is greater than 400, an error is returned.
  • Only the monitored data within the last 30 days can be queried. If the value of StartTime is more than 30 days earlier than the time when you call this operation, 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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

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

cn-hangzhou
StartTimestringYes

The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the value of seconds (ss) is not 00, the time is rounded up to the next minute.

2019-05-10T00:00:00Z
EndTimestringYes

The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. If the value of seconds (ss) is not 00, the time is rounded up to the next minute.

2019-05-10T03:00:00Z
PeriodintegerNo

The interval at which to query the monitoring data of snapshot sizes. Unit: seconds. Valid values:

  • 60
  • 600
  • 3600

Default value: 60.

60
CategorystringNo

The type of the snapshot. Valid values:

  • Standard: normal snapshot.
  • Flash: local snapshot.

Default value: Standard.

Standard

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

9F8163A8-F5DE-47A2-A572-4E062D223E09
MonitorDataobject []

The monitoring data of snapshot sizes.

Sizelong

The total size of snapshots. Unit: bytes.

243036848128
TimeStampstring

The timestamp that corresponds to a snapshot size.

2019-05-10T04:00:00Z

Examples

Sample success responses

JSONformat

{
  "RequestId": "9F8163A8-F5DE-47A2-A572-4E062D223E09",
  "MonitorData": {
    "DataPoint": [
      {
        "Size": 243036848128,
        "TimeStamp": "2019-05-10T04:00:00Z"
      }
    ]
  }
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidStartTime.MalformedThe specified parameter "StartTime" is not valid.-
400InvalidEndTime.MalformedThe specified parameter "EndTime" is not valid.The specified EndTime parameter is invalid.
400InvalidPeriod.ValueNotSupportedThe specified parameter "Period" is not valid.-
400InvalidStartTime.TooEarlyThe specified parameter "StartTime" is too early.-
400InvalidParameter.TooManyDataQueriedToo many data queried.-
400ThrottlingRequest was denied due to request throttling.-

For a list of error codes, visit the Service error codes.