Queries the number of snapshots for one or more specified domain names.
Usage note
- This operation queries the number of snapshots by day.
- You can query for data generated from up to 90 days.
QPS limit
No queries per second (QPS) limit is imposed on a single user for this operation. You can call this operation based on your business requirements. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeLiveDomainSnapshotData |
The operation that you want to perform. Set the value to DescribeLiveDomainSnapshotData. |
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 that is collected 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. |
DomainName | String | No | example.com |
The main streaming domain. Separate multiple domain names with commas (,). |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
SnapshotDataInfos | Array of SnapshotDataInfo |
The daily statistics on the number of snapshots. |
|
SnapshotDataInfo | |||
Date | String | 20180209 |
The date when the snapshots were captured. |
Total | Integer | 110 |
The total number of snapshots that were captured on the day. |
RequestId | String | B955107D-E658-4E77-B913-E0AC3D31693F |
The ID of the request. |
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
<DescribeLiveDomainSnapshotDataResponse>
<RequestId>0B250400-6260-4CBC-85BF-FB0ED3753690</RequestId>
<SnapshotDataInfos>
<SnapshotDataInfo>
<Date>20180209</Date>
<Total>110</Total>
</SnapshotDataInfo>
<SnapshotDataInfo>
<Date>20180210</Date>
<Total>310</Total>
</SnapshotDataInfo>
</SnapshotDataInfos>
</DescribeLiveDomainSnapshotDataResponse>
JSON
format
{
"RequestId":"0B250400-6260-4CBC-85BF-FB0ED3753690",
"SnapshotDataInfos":{
"SnapshotDataInfo":[
{
"Date":"20180209",
"Total":110
},
{
"Date":"20180210",
"Total":310
}
]
}
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | The error message returned because the format of the start time is invalid. Check whether the value of the StartTime parameter is correct. |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | The error message returned because the format of the end time is invalid. Check whether the value of the EndTime parameter is correct. |
For a list of error codes, visit the API Error Center.