You need to enable JavaScript to run this app.
导航

更新录制配置

最近更新时间2023.10.12 17:39:58

首次发布时间2022.04.19 20:40:35

根据域名空间下的应用所关联的录制模版配置更新修改,可调整格式和存储目录等。

说明

该接口属于历史版本 API,我们计划于 2023 年 12 月 25 日停止对其进行维护,并于 2024 年 3 月 25 日下线文档,建议您使用新版更新录制列表接口。

注意事项

  • 请求频率:单用户请求频率限制为 10 次/秒
  • 传参说明:如果请求时,未传入非必选参数,则不更改该参数值。

请求说明

  • 请求方式:POST
  • 请求地址:https://live.volcengineapi.com?Action=UpdateRecordPresetV2&Version=2020-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数类型是否必选示例值描述
ActionStringUpdateRecordPresetV2接口名称。当前 API 的名称为 UpdateRecordPresetV2
VersionString2020-08-01接口版本。当前 API 的版本为 2020-08-01

Body

参数类型是否必选示例值描述
VhostStringpush.example.com域名空间名称
AppStringlive应用名称,由 1 到 30 位数字、字母、下划线及"-"和"."组成
StreamStringexample_stream流名称
PresetStringliverecord模版名称,由 1 到 50 位数字、字母、下划线及"-"和"."组成。可调用 ListVhostRecordPresetV2 接口,查询模版名称
RecordPresetConfigObject of RecordPresetConfig-录制模板详细配置

RecordPresetConfig

参数类型是否必选示例值描述

TranscodeRecord

Integer

1

转码流录制,默认值为 0。支持的取值如下所示。

  • 0:不录制;
  • 1:录制。

说明

TranscodeRecordOriginRecord的取值至少一个为 1。

OriginRecord

Integer

1

源流录制,默认值为 0。支持的取值如下所示。

  • 0:不录制;
  • 1:录制。

说明

TranscodeRecordOriginRecord的取值至少一个为 1。

SliceDurationInteger5录制 HLS 格式时,单个 TS 切片时长,单位为 s,默认值为 5,取值范围为 [5,30]

FlvParam

Object of RecordParam

-

FLV 录制参数,开启 FLV 录制时设置

说明

FlvParamHlsParamMp4Param至少开启一个。

HlsParam

Object of RecordParam

-

HLS 录制参数,开启 HLS 录制时设置

说明

FlvParamHlsParamMp4Param至少开启一个。

Mp4Param

Object of RecordParam

-

MP4 录制参数,开启 MP4 录制时设置

说明

FlvParamHlsParamMp4Param至少开启一个。

RecordParam

参数类型是否必选示例值描述

Enable

Boolean

true

当前格式的录制是否开启,默认 false,取值及含义如下所示。

  • false:不开启;
  • true:开启。
DurationInteger7200断流录制单文件录制时长,单位为 s,默认值为 7200,取值范围为 [300,86400]
RealtimeRecordDurationInteger7200实时录制文件时长,单位为 s,取值范围为 [300,21600]

Splice

Integer

0

断流拼接间隔时长,对实时录制无效,单位为 s,默认值为 0。支持的取值如下所示。

  • -1:一直拼接;
  • 0:不拼接;
  • 大于 0:断流拼接时间间隔,对 HLS 录制生效。

TOSParam

Object of TOSParam

-

TOS 存储相关配置

说明

TOSParamVODParam配置且配置其中一个。

VODParam

Object of VODParam

-

VOD 存储相关配置

说明

TOSParamVODParam配置且配置其中一个。

TOSParam

参数类型是否必选示例值描述

Enable

Boolean

true

是否使用 TOS 存储,默认为 false,取值及含义如下所示。

  • false:不使用;
  • true:使用。

Bucket

String

live-test-tos-example

TOS 存储空间,一般使用 CDN 对应的 Bucket

说明

如果 TOSParam 中的 Enable 取值为 true,则 Bucket 必填。

StorageDirString/TOS 存储目录,默认为空
ExactObjectStringrecord/{PubDomain}/{App}/{Stream}/{StartTime}_{EndTime}录制文件的存储位置。存储路径为 record/{PubDomain}/{App}/{Stream}/{StartTime}_{EndTime}

VODParam

参数类型是否必选示例值描述

Enable

Boolean

true

是否使用 VOD 存储,默认为 false,取值及含义如下所示。

  • false:不使用;
  • true:使用。

VodNamespace

String

Snapshot

视频点播(VOD)空间名称。可登录视频点播控制台查询

说明

如果 VODParam 中的 Enable 取值为 true,则 VodNamespace 必填。

WorkflowIDString25524a2d*********891d7daf4b9工作流模版 ID,对于存储在点播的录制文件,会使用该工作流模版对视频进行处理。可登录视频点播控制台获取 ID
ClassificationIDString23**41直播录制文件存储到点播时的视频分类 ID,您可以通过视频点播的 ListVideoClassifications 接口查询视频分类 ID 等信息。

StorageClass

Integer

1

直播录制文件存储到点播时的存储类型。默认值为 1,支持的取值及含义如下所示。

  • 1:标准存储;
  • 2:归档存储。

ExactObject

String

record/{PubDomain}/{App}/{Stream}/{StartTime}_{EndTime}

录制文件的存储位置,最大长度为 200 个字符。默认的存储位置为 record/{PubDomain}/{App}/{Stream}/{StartTime}_{EndTime} ,参数格式要求如下所示。

  • 支持删除固定路径,如 {App}/{Stream};
  • 不支持以正斜线(/)或者反斜线(\)开头;
  • 不支持 “//” 和 “/./” 等字符串;
  • 不支持 \b、\t、\n、\v、\f、\r 等字符;
  • 不支持 “..” 作为文件名;
  • 目录层级至少包含 2 级及以上,如 live/{App}/{Stream}

返回参数

本接口无特有的返回参数。更多信息请见返回结构

示例

请求示例

POST https://live.volcengineapi.com?Action=UpdateRecordPresetV2&Version=2020-08-01
{
    "Vhost":"push.example.com",
    "App":"live",
    "Preset":"liverecord",
    "RecordPresetConfig": { 
				"OriginRecord": 1,  
				"HlsParam": { 
						"Enable": "true", 
            "RealtimeRecordDuration": 7200, 
            "Splice": 0
          }, 
		        "TOSParam": { 
				        "Enable": true, 
				        "Bucket": "live-test-tos-example", 
				        "StorageDir": "", 
				        "RecordObject": "record/{PubDomain}/{App}/{Stream}/{StartTime}_{EndTime}" 
		        },
		  }
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20220726*******************051B513A",
    "Action": "UpdateRecordPresetV2",
    "Version": "2020-08-01",
    "Service": "live",
    "Region": "cn-north-1"
  }
}

错误码

访问公共错误码获取详细信息。