调用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"
}