功能描述
PUT LiveChannel - Switch 接口可以使指定通道(Live Channel)在启用(Enabled)和禁用(Disabled)两种状态之间切换。
注意
只有存储桶的拥有者才能进行该请求操作。
对处于 Disabled 状态的通道发送推流请求会失败。
即使在推流过程中,也可调用此接口。
在推流过程中,调用此接口将通道从 Enabled 切换成 Disabled,COS 会强制断开推流链接(可能会有10秒左右延迟)。
请求
请求示例
PUT /<ChannelName>?live&switch=<NewSwitch> HTTP 1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT dateContent-Length: Content SizeContent-Md5: Content MD5Authorization: Auth StringXML Body
说明
请求参数
名称 | 描述 | 类型 | 是否必选 |
NewSwitch | 设置通道的开关状态。有效值:enabled,disabled。 注意:enabled、disabled 需全部英文小写 | EnumString | 是 |
请求头
请求体
该请求的请求体为空。
响应
响应头
响应体
此接口响应体为空。
错误码
实际案例
请求
PUT /test-channel?live&switch=enabled HTTP 1.1Host: examplebucket-1250000000.cos.ap-guangzhou.myqcloud.comDate: GMT dateContent-Length:Content SizeContent-Md5:Content MD5Authorization: Auth String
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 0Connection: keep-aliveDate: Wed, 23 Aug 2020 08:14:53 GMTServer: tencent-cosx-cos-request-id: NTk5ZDM5N2RfMjNiMjM1MGFfMmRiX2Y0****