edit-icon download-icon

DescribeLiveStreamRecordContent

Last Updated: Mar 19, 2018

Description

Query the recording content.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeLiveStreamRecordContent

The name of this interface. Value: DescribeLiveStreamRecordContent

AppName String Yes testApp

Name of the app, whcih the live stream belongs to.

DomainName String Yes www.yourdomain.com

Your CDN domain name.

EndTime String Yes 2017-12-22T08:00:00:00Z

End time.

  • Format: 2015-12-01T17:36:00Z.
  • The interval between the EndTime and StartTime does not exceed 4 days.

StartTime String Yes 2017-12-21T08:00:00:00Z

Start time.
Format: 2015-12-01T17:36:00Z.

StreamName String Yes testStream

Name of the live stream.

Return parameters

Parameters Type Example values Description
RecordContentInfoList

Recorded content list.

  └OssEndpoint String oss-cn-shanghai.aliyuncs.com

OSS endpoint.

  └OssBucket String test123

Name of the bucket in OSS.

  └OssObjectPrefix String record/{Date}/{UnixTimestamp}_{Sequence}

Rules of recorded files stored in OSS.

  └StartTime String 2015-12-01T17:36:00Z

Start time.
Format: 2015-12-01T17:36:00Z.

  └EndTime String 2015-12-01T17:36:00Z

End time.
Format: 2015-12-01T17:36:00Z.

  └Duration Float 10

Recording duration.

RequestId String 62136AE6-7793-45ED-B14A-60D19A9486D3

The ID of the job request.

Example

Request example

  1. https://live.aliyuncs.com/?Action=DescribeLiveStreamRecordContent&DomainName=live.aliyunlive.com&AppName=aliyuntest&StreamName=xxx&StartTime=xxx&EndTime=xxx&<Public Request Parameter>

For more information, see Public Request Parameter.

Normal return example

JSON format

  1. {
  2. "RecordContentInfoList":{
  3. "RecordContentInfo":[{
  4. "Duration":14638.0,
  5. "EndTime":"2016-05-25T09:41:09Z",
  6. "OssBucket":"livevideo-test",
  7. "OssEndpoint":"oss-cn-hangzhou.aliyuncs.com",
  8. "OssObjectPrefix":"record/{Date}/{UnixTimestamp}_{Sequence}",
  9. "StartTime":"2016-05-25T05:37:11Z"
  10. }]
  11. },
  12. "RequestId":"62136AE6-7793-45ED-B14A-60D19A9486D3"
  13. }

Exception return example

JSON format

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

Error code

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

Thank you! We've received your feedback.