销毁指定 Converter

更新时间不可用

在项目中销毁指定 Converter。

DELETE
https://api.sd-rtn.com/{region}/v1/projects/{appId}/rtmp-converters/{converterId}

鉴权

Basic Auth

声网旁路推流 RESTful API 仅支持 HTTPS 协议。发送请求时,你需要使用声网提供的客户 ID 和客户密钥生成 Base64 编码凭证,并填入请求头部的 Authorization 字段中。详见实现 HTTP 基本认证。

路径参数

regionstring
必填

Converter 所在的区域,必须与创建 Converter 时设置的 region 一致。

appIdstring
必填

声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。

converterIdstring
必填

Converter 的 ID。

请求 Header

X-Request-IDstring

UUID(通用唯一识别码),标识本次请求。推荐你赋值,赋值后,声网服务器会在响应 Header 中返回一个对应的 X-Custom-Request-ID 字段,你可以用此进行问题排查。如果你不赋值,那么声网服务器会自动生成一个 UUID 并在响应 Header 中返回一个对应的 X-Request-ID 字段。

响应

如果状态码为 2XX,请求成功。响应 Body 为空。

响应 Header

X-Request-IDstring

UUID(通用唯一识别码),标识本次请求。该值为本次请求 Header 中 X-Request-ID。如果请求出错,请在日志中打印出该值,排查问题。如果你已在请求 Header 中对 X-Request-ID 赋值,那么你在响应中收到的参数名为 X-Custom-Request-ID,而非 X-Request-ID。

X-Resource-IDstring

UUID(通用唯一识别码),标识本次请求销毁的 Converter 的 ID。

请求示例

Example Request
curl --request DELETE \
  --url "https://api.sd-rtn.com/:region/v1/projects/:appId/rtmp-converters/:converterId" \
  --header 'Authorization: Basic <credentials>' \
  --header 'X-Request-ID: <string>'

响应示例

{
  "message": "描述请求失败的具体原因。"
}