LiveChannel分為啟用(enabled)和禁用(disabled)兩種狀態。您可以使用PutLiveChannelStatus介面在兩種狀態之間進行切換。
注意事項
LiveChannel有如下注意事項:
LiveChannel處於disabled狀態時,OSS會禁止您向該LiveChannel進行推流操作。如果您正在向該LiveChannel推流,那麼推流的用戶端會被強制斷開(會有10s左右的延遲)。
當沒有用戶端向該LiveChannel推流時,調用PutLiveChannel重新建立LiveChannel也可以達到修改Status的目的。
當有用戶端向該LiveChannel推流時,只能將LiveChannel的狀態修改為disabled,無法調用PutLiveChannelStatus重新建立LiveChannel。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
PutLiveChannelStatus | oss:PutLiveChannelStatus | 在啟用(enabled)和禁用(disabled)兩種狀態之間進行切換。 |
請求文法
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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
返回樣本
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