edit-icon download-icon

DescribeLiveDomainRecordData

Last Updated: Apr 09, 2018

Description

Obtain the data of live domain name recording duration.

  • Support query of the daily recording duration data of a single domain name in a specified time range.

  • Daily recording duration data includes the total duration of the current day and duration data list based on different recording formats.

  • Support query of data starting from January 1, 2018. The maximum interval between Starttime and Endtime is 90 days.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeLiveDomainRecordData

The name of this interface. Value: DescribeLiveDomainRecordData

DomainName String Yes www.livetest.com

The live domain name to be queried.

StartTime String Yes 2018-01-01T00:00:00Z

Start time of data query.

  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mm:ssZ.
  • Support query of data starting from January 1, 2018, that is, StartTime≥2018-01-01T00:00:00Z.

EndTime String Yes 2018-01-02T00:00:00Z

End time of data query.

  • Must be later than the Endtime.
  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mm:ssZ.

RecordType String No MP4

Recording type.
Currently support TS, MP4 and FLV. If the parameter is left blank, the system queries all the types.

Return parameters

Parameters Type Example values Description
RecordDataInfos

Daily statistics of the live recording duration.

  └Date String 20180202

Date, accurate to day.

  └Total Integer 4710

Total recording duration of a single day.
Unit: seconds

  └Detail

Recording duration information based on different recording formats.

    └FLV Integer 100

Recording duration in FLV format.
Unit: seconds

    └MP4 Integer 230

Recording duration in MP4 format.
Unit: seconds

    └TS Integer 456

Recording duration in TS format.
Unit: seconds

RequestId String B955107D-E658-4E77-B913-E0AC3D31693F

Request ID.

Example

Request example

  1. /?Action=DescribeLiveDomainRecordData
  2. &DomainName=www.livetest.com
  3. &EndTime=2018-01-01T00:00:00Z
  4. &StartTime=2018-01-02T00:00:00Z
  5. &RecordType=MP4
  6. &<public request parameters>

Normal return example

JSON format

  1. {
  2. "RecordDataInfos":{
  3. "RecordDataInfo":[
  4. {
  5. "Date":"20180101",
  6. "Detail":{
  7. "TS":86310
  8. },
  9. "Total":86310
  10. },
  11. {
  12. "Date":"20180102",
  13. "Detail":{
  14. "TS":86310
  15. },
  16. "Total":86310
  17. }
  18. ]
  19. },
  20. "RequestId":"0B250400-6260-4CBC-85BF-FB0ED3753690"
  21. }

Exception return example

JSON format

  1. {
  2. "Code":"InvalidEndTime.BeyondCurrent",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"EndTime beyond current time.",
  5. "RequestId":"D561201C-1192-4BCB-BDA9-AD16AA62F6FD"
  6. }

Error code

For more information about error code of this product, see Error code.

Thank you! We've received your feedback.