DeleteMedia
https://rtc-api.zego.im/
When users perform CDN recording, they will store the recorded media files on CDN servers, and users can call this interface to delete the file.
Before using this interface for the first time, please confirm whether CDN recording service has been activated. If not, please go to the ZEGOCLOUD Console to activate it yourself, for details, please refer to Console - Service Configuration - CDN, or contact ZEGOCLOUD Technical Support to activate it.
Request
Query Parameters
- Tencent Cloud: FileID.
- Wangsu: PersistentId.
- Huawei Cloud: ObsObject.
Possible values: [DeleteMedia]
Interface prototype parameters
https://rtc-api.zego.im?Action=DeleteMedia
💡Public parameter. Application ID, assigned by ZEGOCLOUD. Get it from the ZEGOCLOUD Admin Console.
💡Common parameter. A 16-character hexadecimal random string (hex-encoded 8-byte random number). For the generation algorithm, refer to the signature example.
💡Common parameter. Current Unix timestamp in seconds. For the generation algorithm, refer to the signature example. A maximum deviation of 10 minutes is allowed.
💡Common parameter. Signature used to verify the legitimacy of the request. Please refer to the signature mechanism to generate it.
Possible values: [2.0]
Default value: 2.0
💡Public parameter. Signature version number.
Possible values: [Tencent, Ws, Huawei]
Possible values and corresponding CDN vendors:
Tencent: Tencent Cloud. Ws: Wangsu. Huawei: Huawei Cloud.Possible values: >= 1, <= 100
FileId and Media are mutually exclusive. Use only one method to pass file IDs.Unique file identifier returned in the recording file generation callback , supporting up to 100 media file FileIds.
Please note that the unique identifiers for recording files are different for each CDN vendor:
You can also obtain the unique identifier of the media file through the search media interface, and the parameter names corresponding to the identifiers are different, please pay attention to distinguish them.
Example: &FileId[]=5285890813221514958&FileId[]=5285890813221513290
Possible values: >= 1, <= 100
FileId and Media are mutually exclusive. Use only one method to pass file IDs.List of media files to delete. Up to 100 files are supported.
File ID to delete. N must start at 0 and increase continuously. Up to 100 files are supported.
This parameter takes effect only when Vendor is set to Tencent.
Media.N.FileIdPossible values: <= 3
Resolution of the file to delete. M can only be 0, 1, or 2 (up to three values), must start at 0 and increase continuously, and supports only 360p, 540p, and 720p without duplicates.
This parameter is used to delete transcoded files generated by On-Demand Transcoding. If omitted, all files under the specified FileId are deleted. If provided, only transcoded files with the specified resolutions are deleted.
Possible values: [360p, 540p, 720p]
Media.N.Resolution.MMedia.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=540pWhether to delete the cache on CDN nodes when deleting files.
Note:
Only supports Wangsu, cache deletion only applies to successfully deleted files, cache will only be deleted after the file deletion is successful.
Responses
- 200
- application/json