服务端 API v2
  • API概览
  • 调用方式
  • 房间信令接口
  • 混流接口
  • 媒体服务接口
  • 媒体文件接口
  • 音视频流审核接口
  • 回调说明
  • 全局返回码
  • 调测指南

停止 CDN 录制

更新时间:2021-10-25 17:43

1 描述

调用本接口停止 CDN 录制。相关回调请参考 录制文件生成回调

2 接口原型

  • 请求方法:GET
  • 请求地址:https://rtc-api.zego.im/?Action=StopCDNRecord
  • 传输协议:HTTPS
  • 调用频率限制:20 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数

参数 类型 是否必选 描述
StreamId[] Array of String 流 ID 列表。
以同时停止录制 “cdn01” 和 “cdn02” 两个流为例,请求的参数为:StreamId[]=cdn01和StreamId[]=cdn02。
Vendor String CDN 厂商名。
  • Tencent:腾讯云。

4 请求示例

https://rtc-api.zego.im/?Action=StopCDNRecord
&StreamId[]=cdn01
&StreamId[]=cdn02
&Vendor=Tencent
&<公共请求参数>

5 响应参数

参数 类型 描述
Code Number 返回码。
Message String 操作结果描述。
RequestId String 请求 ID。
Data Object 响应数据。
└ Tencent Array of Object 任务 ID,全局唯一标识录制任务。
  └ StreamName String 流名称。
  └ RequestId String 唯一请求 ID,每次请求都会返回; 定位问题时需要提供该次请求的 RequestId。
  └ Code String 当前流的错误码。
  └ Message String 当前流错误信息。

6 响应示例

{
    "Code":0,
    "Message":"success",
    "Data":{
        "Tencent":[
            {
                "StreamName":"cdn01",
                "RequestId":"d39548da-fbd4-4dce-8023-cfccd28a9963",
                "Code":"",
                "Message":""
            }
        ]
    },
    "RequestId":"4315169065145771656"
}

7 返回码

以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码

返回码 说明
41001 直播保存失败。
41002 频道保存失败。
41003 直播不存在。
41004 流已不存在。
42001 禁用直播失败。
42002 恢复直播失败。
43001 创建录制索引文件失败。