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.
|
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. |
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. |
└EndTime | String | 2015-12-01T17:36:00Z | End time. |
└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
JSON
format
{
"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.