更新配置APP錄制,輸出內容保存到OSS中。
接口說明
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
live:UpdateLiveAppRecordConfig | *Domain acs:cdn:*:{#accountId}:domain/{#DomainName} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DomainName | string | 是 | 主播流域名。 | example.com |
AppName | string | 是 | 播流所屬應用名稱。 | liveApp**** |
OssEndpoint | string | 是 | OSS 存儲的 Endpoint 名稱。 直播錄制文件存儲至 OSS,需提前創建 OSS Bucket,創建方法請參見配置 OSS 。 | learn.developer.aliyundoc.com |
StreamName | string | 否 | 播流名稱。 | teststream |
StartTime | string | 否 | 錄制開始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。 說明
設置的時間必須是實際推流時間開始 7 天之內,只在流級別錄制(StreamName 不為空)有效。
| 2018-04-10T09:57:21Z |
EndTime | string | 否 | 錄制結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。 說明
EndTime 與 StartTime 相差不應超過 7 天,超過 7 天將按照 7 天計算。只在流級別錄制(StreamName 不為空)有效。
| 2018-04-16T09:57:21Z |
OnDemand | integer | 否 | 按需錄制。取值:
說明
當 OnDemand 取值為 1 時,需要先通過 AddLiveRecordNotifyConfig 接口配置 OnDemandUrl,否則默認不錄制。
| 1 |
DelayTime | integer | 否 | 斷流拼接時長。 直播斷流時長超過設定的拼接時長后,將會生成新文件,斷流拼接時長支持 15~21600 秒。 | 180 |
RecordFormat | array<object> | 否 | 記錄詳情。 | |
object | 否 | |||
CycleDuration | integer | 否 | 周期錄制時長。單位:秒。不填則默認為 6 小時。 說明
| 1 |
Format | string | 否 | 格式。目前支持 M3U8、FLV、MP4、CMAF。取值: 注意 RecordFormat 和 TranscodeRecordFormat 兩者至少需要設置一個。如果選擇 m3u8 或 cmaf 格式,必須同時設置請求參數 RecordFormat.N.SliceOssObjectPrefix 和 RecordFormat.N.SliceDuration。
| m3u8 |
SliceDuration | integer | 否 | 單個切片時長。單位:秒。 注意 當 RecordFormat.N.Format(格式)設為 m3u8 或 cmaf 時,本參數才有效。
不填則默認為 30 秒。取值范圍:5s~30s。 | 30 |
TranscodeRecordFormat | array<object> | 否 | 轉碼記錄詳情。 | |
object | 否 | |||
CycleDuration | integer | 否 | 轉碼流錄制周期錄制時長。單位:秒。不填則默認為 6 小時。 | 21600 |
Format | string | 否 | 轉碼流錄制格式。目前支持 M3U8、FLV、MP4、CMAF。取值: 注意 這如果選擇 m3u8 或 cmaf 格式,必須同時設置請求參數 TranscodeRecordFormat.N.SliceOssObjectPrefix 和 TranscodeRecordFormat.N.SliceDuration。
| m3u8 |
SliceDuration | integer | 否 | 轉碼流錄制單個切片時長,單位:秒。 注意 當 TranscodeRecordFormat.N.Format(轉碼流錄制格式)設為 m3u8 或 cmaf 時,本參數才生效。
不填則默認為 30 秒。取值范圍:5s~30s。 | 30 |
TranscodeTemplates | array | 否 | 轉碼流錄制的轉碼模板組。 | |
string | 否 |
說明
TranscodeTemplates 不允許傳入 raw ,屬于保留標識。RepeatList 表示為 TranscodeTemplates.N 中的 N,可理解為遞增進行多個設置,如: TranscodeTemplates.1=sd, TranscodeTemplates.2=hd。 | sd |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidOssEndpoint.Malformed | %s | - |
400 | InvalidOssBucket.Malformed | Specified parameter OssBucket is not valid. | OSSBucket參數錯誤,請您確認該OSS BUCKET參數是否正確。 |
400 | InvalidOssBucket.NotFound | The parameter OssBucket does not exist. | OSSBucket參數錯誤,請您確認該OSS BUCKET參數是否正確。 |
400 | InvalidFormat.Malformed | Specified parameter Format is not valid. | Format參數錯誤,請您確認該Format參數是否正確。 |
400 | InvalidCycleDuration.Malformed | Specified CycleDuration Format is not valid. | CycleDuration參數格式錯誤,請您確認該CycleDuration參數格式是否正確。 |
400 | InvalidSliceDuration.Malformed | Specified SliceDuration Format is not valid. | - |
400 | InvalidTemplateLength.Malformed | Specified record template length is not valid. | - |
400 | InvalidTemplate.ForbidRaw | Template named raw is Forbidden. | - |
400 | MissingTemplate | Template is mandatory for this action. | - |
400 | MissingOssObjectPrefix | OssObjectPrefix is mandatory for this action. | 缺少OssObjectPrefix值,請您確認OssObjectPrefix值是否正確。 |
400 | MissingSliceOssObjectPrefix | SliceOssObjectPrefix is mandatory for this action. | - |
400 | InvalidOssObjectPrefix.Malformed | Specified parameter OssObjectPrefix is not valid. | OSSObjectPrefix參數錯誤,請您確認該OSSObjectPrefix參數是否正確。 |
400 | InvalidSliceOssObjectPrefix.Malformed | Specified parameter SliceOssObjectPrefix is not valid. | SliceOssObjectPrefix參數錯誤,請您確認該SliceOssObjectPrefix參數是否正確。 |
400 | ConfigAlreadyExists | Config has already exist. | 配置已添加。 |
400 | InvalidFormat.IllegalOperation | Specified parameter Format can not be multiple. | - |
400 | InvalidDelayTime | Specified Delaytime is invalid. | - |
400 | Live2Vod.ConfigAlreadyExists | Had live2vod record config already. | - |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime參數錯誤,請您確認該StartTime參數是否正確。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間錯誤,請您確認結束時間是否正確。 |
400 | InvalidEndTime.Mismatch | Specified EndTime does not math the specified StartTime or current time. | - |
400 | InvalidStartTime.Mismatch | Specified StartTime does not math the current time. | - |
400 | Forbidden | Ram Permission is forbidden. | - |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|
暫無變更歷史