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