LiveChannel有两种状态:enabled和disabled,您可以使用本接口在两种状态之间进行切换。

请求语法

说明
  • LiveChannel处于disabled状态时,OSS会禁止您向该LiveChannel进行推流操作。如果您正在向该LiveChannel推流,那么推流的客户端会被强制断开(会有10s左右的延迟)。
  • 当没有客户端向该LiveChannel推流时,调用PutLiveChannel重新创建LiveChannel也可以达到修改Status的目的。
  • 当有客户端向该LiveChannel推流时,无法调用PutLiveChannel重新创建LiveChannel,只能通过本接口修改LiveChannel的状态为disabled。
PUT /ChannelName?live&status=NewStatus HTTP/1.1Date: GMT dateHost: BucketName.oss-cn-hangzhou.aliyuncs.comAuthorization: SignatureValue

请求头

名称 类型 是否必选 描述
NewStatus 字符串 指定LiveChannel的目标Status。

有效值:enableddisabled

示例

请求示例

PUT /test-channel?live&status=disabled HTTP/1.1
Date: Thu, 25 Aug 2016 05:37:38 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS YJjHKOKWDWINLKXv:X/mBrSbkNoqM/JoAfRC0ytyQ****

返回示例

HTTP/1.1 200
content-length: 0
server: AliyunOSS
connection: close
x-oss-request-id: 57BE8422B92475920B002030
date: Thu, 25 Aug 2016 05:37:39 GMT