CreateLiveStreamRecordIndexFiles - API Reference| Alibaba Cloud Documentation Center

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

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

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

Exception return example

JSONformat

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

Error code

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