All Products
Search
Document Center

ApsaraVideo Live:DescribeLiveDomainSnapshotData

Last Updated:Aug 29, 2024

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

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.

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.