edit-icon download-icon

CreateLiveStreamRecordIndexFiles

Last Updated: May 11, 2018

Description

Create a record index file.

Request parameters

Parameters Type Required Example values Description
Action String Yes CreateLiveStreamRecordIndexFiles

The name of this interface. Value: CreateLiveStreamRecordIndexFiles

AppName String Yes testApp

Name of the app, which 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.

OssBucket String Yes test123

Name of the bucket in OSS.

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

OSS endpoint.

OssObject String Yes {AppName}/{StreamName}/{Date}/{Hour}/{Minute}_{Second}.m3u8

Name of the recorded file stored in OSS.

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
RequestId String 550439A3-F8EC-4CA2-BB62-B9DB43EEEF30

The ID of the job request.

RecordInfo

Recording configuration.

  └RecordUrl String http://xxx.xxx/atestObject.m3u8

Index file address.

  └DomainName String test.com

The CDN domain name, which the stream belongs to.

  └AppName String test123

The CDN domain name, which the stream belongs to.

  └StreamName String test123

Name of the live stream.

  └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 20

Recording duration. Unit: seconds.

  └Height Integer 480

Video height.

  └Width Integer 640

Video width.

  └CreateTime String 2016-05-27T09:40:56Z

Creation time.

  └RecordId String c4d7f0a4-b506-43f9-8de3-07732c3f3d82

Index file ID.

  └OssBucket String bucket

Name of the bucket in OSS.

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

OSS endpoint domain name.

  └OssObject String atestObject.m3u8

Name of the recorded file stored in OSS.

Example

Request example

  1. https://live.aliyuncs.com/?Action=CreateLiveStreamRecordIndexFiles&DomainName=xxxxx&AppName=aliyuntest&StreamName=xxx&OssEndpoint=oss-cn-hangzhou.aliyuncs.com&OssBucket=xxx&OssObject=atestObject.m3u8&StartTime=xxx&EndTime=xxx&<Public Request Parameter>

Fore more information, see Public Request Parameter.

Normal request example

JSON format

  1. {
  2. "RecordInfo":{
  3. "AppName":"xxx",
  4. "CreateTime":"2016-05-27T09:40:56Z",
  5. "DomainName":"xxx",
  6. "Duration":588.849,
  7. "EndTime":"2016-05-25T05:47:11Z",
  8. "Height":480,
  9. "OssBucket":"bucket",
  10. "OssEndpoint":"oss-cn-hangzhou.aliyuncs.com",
  11. "OssObject":"atestObject.m3u8",
  12. "RecordId":"c4d7f0a4-b506-43f9-8de3-07732c3f3d82",
  13. "RecordUrl":"http://xxx.xxx/atestObject.m3u8",
  14. "StartTime":"2016-05-25T05:37:11Z",
  15. "StreamName":"xxx",
  16. "Width":640
  17. },
  18. "RequestId":"550439A3-F8EC-4CA2-BB62-B9DB43EEEF30"
  19. }

Exception return example

JSONformat

  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.