LiveChannel分為啟用(enabled)和禁用(disabled)兩種狀態。您可以使用PutLiveChannelStatus介面在兩種狀態之間進行切換。
注意事項
LiveChannel有如下注意事項:
LiveChannel處於disabled狀態時,OSS會禁止您向該LiveChannel進行推流操作。如果您正在向該LiveChannel推流,那麼推流的用戶端會被強制斷開(會有10s左右的延遲)。
當沒有用戶端向該LiveChannel推流時,調用PutLiveChannel重新建立LiveChannel也可以達到修改Status的目的。
當有用戶端向該LiveChannel推流時,只能將LiveChannel的狀態修改為disabled,無法調用PutLiveChannelStatus重新建立LiveChannel。
請求文法
PUT /ChannelName?live&status=NewStatus HTTP/1.1
Date: Tue, 25 Dec 2018 17:35:24 GMT
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
請求元素
名稱 | 類型 | 是否必選 | 描述 |
status | 字串 | 是 | 設定LiveChannel的Status。 有效值:
|
要求標頭
此介面僅涉及公用要求標頭,請參見公用要求標頭(Common Request Headers)。
回應標頭
此介面僅涉及公用回應標頭,詳情請參見公用回應標頭(Common Response Headers)。
樣本
請求樣本
PUT /test-channel?live&status=disabled HTTP/1.1
Date: Tue, 25 Dec 2018 17:35:24 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
返回樣本
HTTP/1.1 200
Content-Length: 0
Server: AliyunOSS
Connection: close
x-oss-request-id: 57BE8422B92475920B00****
Date: Tue, 25 Dec 2018 17:35:24 GMT