调用ForbidLiveStream禁止某条流的推送,可以预设某个时刻将流恢复。

说明 禁止直播流的上限为10,000路,超出限制将禁用失败,请您注意统计当前禁用流的数量。调用频率限制为20次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ForbidLiveStream

系统规定参数。取值:ForbidLiveStream

AppName String testApp

播流所属应用名称。

DomainName String www.yourdomain.com

主播流域名。

LiveStreamType String publisher

用于指定主播推流还是客户端播流。目前仅支持:publisher(主播推流)。

StreamName String testStream

播流名称。

Oneshot String yes

是否只断流不加入黑名单。取值:

  • yes:只断流不加黑名单(支持上行推送或上行播流)。
  • no:断流加入黑名单。
ResumeTime String 2015-12-01T10:37:00Z

恢复流的时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

返回数据

名称 类型 示例值 描述
RequestId String 16BFE188-B193-4C3C-ADC5-79A7E31486EA

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=ForbidLiveStream
&AppName=testApp
&DomainName=www.yourdomain.com
&LiveStreamType=publisher
&StreamName=testStream
&<公共请求参数>

正常返回示例

XML格式

<ForbidLiveStreamResponse>
	  <RequestId>16BFE188-B193-4C3C-ADC5-79A7E31486EA</RequestId>
</ForbidLiveStreamResponse>

JSON格式

{
    "RequestId":"16BFE188-B193-4C3C-ADC5-79A7E31486EA"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidResumeTime.Malformed Specified parameter ResumeTime is not valid. ResumeTime参数错误,请您确认该ResumeTime参数是否正确。
400 ConfigAlreadyExists Config has already exist. 配置已添加。

访问错误中心查看更多错误码。