调用SetLiveStreamBlock设置直播流粒度封禁-阿里云帮助中心

调用SetLiveStreamBlock设置直播流粒度封禁。

使用说明

一个域名最多支持配置200条直播流区域封禁规则，直播流区域封禁中如果出现重复的AppName和StreamName对应的规则，则以最近的更新时间生效。

QPS限制

本接口的单用户QPS限制为50次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见视频直播API QPS限制。

请求参数

参数名	类型	是否必须	说明
Action	String	是	操作接口名，系统规定参数，取值：SetLiveStreamBlock。
DomainName	String	是	播放域名。
AppName	String	是	直播流所属应用名称。
StreamName	String	是	直播流名称。
BlockType	String	是	封禁方式，blacklist：黑名单，whitelist：白名单。
LocationList	String	是	封禁区域，如CN，AS多个以逗号隔开。
ReleaseTime	String	否	封禁结束时间，UTC格式，不填默认封禁7天。

返回参数

名称	类型	描述
RequestId	String	请求ID。
Status	String	ok：配置成功，fail：失败。
Description	String	成功：ok，失败：失败详情。

特殊错误码

错误代码	描述	Http 状态码	语义
InternalError	The request processing has failed due to some unknown error.	500	后台发生未知错误。
InvalidDomain.NotFound	The domain provided does not exist in our records.	404	当前账户下未查到域名。
InvalidParam	Parameter invalid.	400	参数错误。

示例

请求示例：

https://live.aliyuncs.com?Action=SetLiveStreamBlock&DomainName=example.com&AppName=test&StreamName=test&LocationList=CN,AS&BlockType=whitelist&<公共请求参数>

返回示例：

{
    "RequestId": "0D70427D-91E4-4349-AAD3-5511A5BB823B",
    "Status": "ok",
    "Description": "ok"
}