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

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