Server APIs v2

Delete recorded files from CDN

Update Time:2021-10-25 17:43

1 Description

Deletes the specified recorded files from CDN.

To use the CDN recording service, you will need to contact ZEGO Technical Support to enable it first. For pricing details, you can check with our sales.

2 Request method and endpoint

  • Request method: GET
  • Request endpoint: https://rtc-api.zego.im/?Action=DeleteMedia
  • Transmission protocol: HTTPS
  • Rate limit: 20 requests/second

3 Request parameters

Listed below are the parameters specific to this request and part of the public request parameters. For the complete list of public request parameters, see Server APIs public request parameters.

Parameter Type Required Description
Vendor String Yes The CDN provider.
  • Tencent: Tencent Cloud
FileId[] Array of String Yes The unique ID of a recorded file on Tencent CDN, returned in the callback [Recorded File Created].
Example: &FileId[]=5285890813221514958&FileId[]=5285890813221513290

4 Request Example

https://rtc-api.zego.im/?Action=DeleteMedia
&Vendor=Tencent
&FileId[]=5285890813221514958&FileId[]=5285890813221513290
&<Public Request Parameters>

5 Response parameters

Parameter Type Description
Code Number Return code.
Message String Description of the request execution result.
Data String Returned data.

6 Response example

{
    "Code":0,
    "Message":"success",
    "Data":""
}

7 Return codes

Listed below are the return codes related to this API. For the complete list of return codes, see Return codes.

Return code Description
41001 Failed to save live stream.
41002 Failed to save channel.
41003 Live stream does not exist.
41004 Stream no longer exists.
42001 Failed to forbid live stream.
42002 Failed to resume live stream.
43001 Failed to create recording index file.

Delete recorded files from CDN


1 Description

Deletes the specified recorded files from CDN.

Rate limit:

  • Production environment: 20 requests/second
  • Testing environment: 20 requests/second
You will need to contact ZEGO Technical Support to enable the CDN recording service before you can use it.

2 Request method and endpoint

  • Request method: GET
  • Request endpoint: https://rtc-api.zego.im/?Action=DeleteMedia
  • Transmission protocol: HTTPS

3 Request parameters

Listed below are the parameters specific to this request and part of the public request parameters. For the complete list of public request parameters, see Server APIs public request parameters.

Parameter Type Required Description
Vendor String Yes The CDN provider.
  • Tencent: Tencent Cloud
FileId[] Array of String Yes The unique ID of a recorded file on Tencent CDN, returned in the callback [Recorded File Created].
Example: &FileId[]=5285890813221514958&FileId[]=5285890813221513290

4 Request Example

https://rtc-api.zego.im/?Action=DeleteMedia
&Vendor=Tencent
&FileId[]=5285890813221514958&FileId[]=5285890813221513290
&<Public Request Parameters>

5 Response parameters

Parameter Type Description
Code Number Return code.
Message String Description of the request execution result.
Data String Returned data.

6 Response example

{
    "Code":0,
    "Message":"success",
    "Data":""
}

7 Return codes

Listed below are the return codes related to this API. For the complete list of return codes, see Return codes.

Return code Description
41001 Failed to save live stream.
41002 Failed to save channel.
41003 Live stream does not exist.
41004 Stream no longer exists.
42001 Failed to forbid live stream.
42002 Failed to resume live stream.
43001 Failed to create recording index file.