Queries the number of snapshots for one or more streaming domains.
Usage notes
- You can call this operation to collect statistics on the total number of snapshots on a day.
- You can query data in the last 90 days.
QPS limit
This operation does not have a queries per second (QPS) limit on a single user. You can call this operation based on your business requirements. For more information, see QPS limits.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | DescribeLiveDomainSnapshotData | The operation that you want to perform. Set the value to DescribeLiveDomainSnapshotData. |
DomainName | String | No | example.com | The main streaming domain. Separate multiple main streaming domains with commas (,). |
StartTime | String | Yes | 2018-01-01T00:00:00Z | 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. Note You can query data in the last 90 days. |
EndTime | String | Yes | 2018-01-02T00:00:00Z | The end of the time range to query. The end time must be later than the start time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
Response parameters
Parameter |
Type |
Example |
Description |
RequestId | String | B955107D-E658-4E77-B913-E0AC3D31693F | The request ID. |
SnapshotDataInfos | Array of SnapshotDataInfo | The daily statistics on the number of snapshots. |
|
SnapshotDataInfo | |||
Date | String | 20180209 | The date. |
Total | Integer | 110 | The total number of snapshots that were captured on the day. |
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainSnapshotData
&StartTime=2018-01-01T00:00:00Z
&EndTime=2018-01-02T00:00:00Z
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveDomainSnapshotDataResponse>
<RequestId>B955107D-E658-4E77-B913-E0AC3D31693F</RequestId>
<SnapshotDataInfos>
<SnapshotDataInfo>
<Date>20180209</Date>
<Total>110</Total>
</SnapshotDataInfo>
</SnapshotDataInfos>
</DescribeLiveDomainSnapshotDataResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "B955107D-E658-4E77-B913-E0AC3D31693F",
"SnapshotDataInfos" : {
"SnapshotDataInfo" : [ {
"Date" : "20180209",
"Total" : 110
} ]
}
}
Error codes
HTTP status code |
Error code |
Error message |
Description |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | The format of the start time is invalid. Check whether the value of the StartTime parameter is valid. |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | The format of the end time is invalid. Check whether the value of the EndTime parameter is valid. |
For a list of error codes, see Service error codes.