全部產品
Search
文件中心

ApsaraVideo Live:設定直播流粒度封鎖

更新時間:Jun 30, 2024

調用SetLiveStreamBlock設定直播流粒度封鎖。

使用說明

一個網域名稱最多支援配置200條直播流地區封鎖規則,直播流地區封鎖中如果出現重複的AppName和StreamName對應的規則,則以最近的更新時間生效。

QPS限制

本介面的單使用者QPS限制為50次/秒。超過限制,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"
}