Object Storage Service:PutLiveChannelStatus

Usage notes

When you call PutLiveChannelStatus, take note of the following items:

• If a LiveChannel is disabled, OSS prohibits you from ingesting streams to the LiveChannel. If you are ingesting a stream to a disabled LiveChannel, your client is disconnected from the LiveChannel after approximately 10 seconds.

• If no stream is ingested to a LiveChannel, You can re-create the LiveChannel by calling PutLiveChannel to change the status of the LiveChannel.

• If a stream is being ingested to a LiveChannel, you can only call PutLiveChannelStatus to change the status of the LiveChannel to disabled.

Permissions

By default, an Alibaba Cloud account has full permissions on resources in the account. In contrast, RAM users and RAM roles associated with an Alibaba Cloud account initially have no permissions. To manage resources by using a RAM user or role, you must grant the required permissions via RAM policies or Bucket policies.

Request syntax

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

Request elements

Request headers

All headers in a PutLiveChannelStatus request are common request headers. For more information, see Common HTTP headers.

Response headers

All headers in the response to a PutLiveChannelStatus request are common response headers. For more information, see Common HTTP headers.

Examples

Sample request

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****************

Sample response

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