全部產品
Search
文件中心

:PutLiveChannelStatus

更新時間:Jun 19, 2024

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。

有效值:

  • enabled:啟用LiveChannel

  • disabled:禁用LiveChannel

要求標頭

此介面僅涉及公用要求標頭,請參見公用要求標頭(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