全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

PutLiveChannelStatus

更新时间:2017-06-07 13:26:11

LiveChannel有两种Status:enabled和disabled,用户可以使用本接口在两种Status之间进行切换。处于disabled状态时,OSS会禁止用户向该LiveChannel进行推流操作;如果有用户正在向该LiveChannel推流,那么推流的客户端会被强制断开(可能会有10s左右的延迟)。

请求语法

PUT /ChannelName?live&status=NewStatus HTTP/1.1Date: GMT dateHost: BucketName.oss-cn-hangzhou.aliyuncs.comAuthorization: SignatureValue

请求参数

名称 描述 是否必需
NewStatus 指定LiveChannel的目标Status。
有效值:enabled、disabled

细节分析

  1. 当没有客户端向该LiveChannel推流时,调用PutLiveChannel重新创建LiveChannel也可以达到修改Status的目的。
  2. 当有客户端向该LiveChannel推流时,无法调用PutLiveChannel重新创建LiveChannel,只能通过本接口修改LiveChannel的状态为disabled。

示例

请求示例

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

返回示例

  1. HTTP/1.1 200
  2. content-length: 0
  3. server: AliyunOSS
  4. connection: close
  5. x-oss-request-id: 57BE8422B92475920B002030
  6. date: Thu, 25 Aug 2016 05:37:39 GMT
本文导读目录