DeleteMedia
2026-08-07
GET
https://rtc-api.zego.im/
用户进行 CDN 录制时，会把录制好的媒体文件存放在 CDN 服务器上，用户可以调用本接口删除该文件。
注意
首次使用本接口之前，请确认是否已经开通 CDN 录制服务。若未开通，请前往 ZEGO 控制台 自助开通，详情请参考 控制台 - 服务配置 - CDN，或联系 ZEGO 技术支持开通。
调用频率限制
同一个 AppID 下所有房间：20 次/秒
Request
Query Parameters
Action string必填
可选值: [DeleteMedia]
接口原型参数
https://rtc-api.zego.im?Action=DeleteMedia
AppId uint32必填
💡公共参数。应用 Id，由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。
SignatureNonce string必填
💡公共参数。16 位 16 进制随机字符串（8 字节随机数的 hex 编码）。生成算法可参考 签名示例。
Timestamp int64必填
💡公共参数。当前 Unix 时间戳，单位为秒。生成算法可参考 签名示例，最多允许 10 分钟的误差。
Signature string必填
💡公共参数。签名，用于验证请求的合法性。请参考签名机制生成。
SignatureVersion string必填
可选值: [2.0]
默认值: 2.0
💡公共参数。签名版本号。
Vendor string必填
可选值: [Tencent, Ws, Huawei]
可能的取值及对应的 CDN 厂商：
Tencent：腾讯云。 Ws：网宿。 Huawei：华为云。FileId string[]
可选值: >= 1, <= 100
Media object[]
可选值: >= 1, <= 100
注意
FileId 与 Media 参数互斥，仅支持选择一种方式传递文件 ID。注意
该参数仅在 Vendor 取值为 Tencent 时有效。
需要删除的媒体文件列表，最多支持 100 个文件。
Array[
FileId string必填
需要删除的文件 ID。必须从 0 开始连续递增，最多支持 100 个文件。
该参数仅在 Vendor 取值为 Tencent 时有效。
Query 参数名：
Media.N.FileIdResolution string[]
可选值: <= 3
需要删除文件的分辨率。M 只能为 0、1、2（最多 3 个），必须从 0 开始连续递增；取值仅支持 360p、540p、720p，且不能重复。
用于删除点播转码产生的转码文件。默认不传此参数表示删除该 FileId 下的所有文件；传入此参数时，仅删除对应分辨率的转码文件。
Array[
string
可选值: [360p, 540p, 720p]
Query 参数名：
Media.N.Resolution.M]
]
Query 示例:
Media.0.FileId=5001834814700023699&
Media.0.Resolution.0=360p&
Media.0.Resolution.1=720p&
Media.1.FileId=5001834814583141985&
Media.2.FileId=5001834814648245073&
Media.2.Resolution.0=360p&
Media.2.Resolution.1=540pClearCache boolean
删除文件时是否删除在 CDN 节点上面的缓存。
注意：
只支持网宿,缓存的删除只针对删除成功的文件，只有在删除文件成功后才会删除缓存。
Responses
- 200
成功
- application/json