全部产品
Search
文档中心

视频直播:设置直播流粒度封禁

更新时间:Aug 18, 2023

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