查詢直播流粒度封鎖 - ApsaraVideo Live

調用DescribeStreamLocationBlock查詢直播流粒度封鎖資訊。

使用說明

先擷取直播播放網域名稱，再調用本介面查詢直播流粒度封鎖資訊。

QPS限制

本介面的單使用者QPS限制為50次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見QPS限制。

請求參數

參數名	類型	是否必須	說明
Action	String	是	操作介面名，系統規定參數，取值：DescribeStreamLocationBlock。
DomainName	String	是	播放網域名稱。
AppName	String	否	直播流所屬應用程式名稱。
StreamName	String	否	直播流名稱。
BlockType	String	否	封鎖方式，blacklist：黑名單，whitelist：白名單。
PageNum	Integer	否	取得第幾頁，預設1。
PageSize	Integer	否	每頁大小，最大100，取值：1~100之間的任意整數。

返回參數

名稱	類型	描述
RequestId	String	請求ID。
Count	Integer	合格總個數。
PageNum	Integer	分頁的頁碼。
PageSize	Integer	每頁大小。
TotalPage	Integer	總頁數。
StreamBlockList	StreamBlock[]	詳細資料。
DomainName	String	加速網域名稱。
AppName	String	封鎖的應用程式名稱。
StreamName	String	封鎖的流名稱。
BlockType	String	封鎖方式，blacklist：黑名單，whitelist：白名單。
LocationList	String	封鎖地區，如CN，AS多個以逗號隔開。
Status	Integer	封鎖狀態，0：未開始，1：正在封鎖，2：成功，3：失敗，4：到期，5：刪除中。
ReleaseTime	String	失效時間，UTC時間。
UpdateTime	String	最後修改時間，UTC時間。

特殊錯誤碼

錯誤碼	描述	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=DescribeStreamLocationBlock&DomainName=example.com&<公用請求參數>

返回樣本：

{
    "RequestId": "0D70427D-91E4-4349-AAD3-5511A5BB823B",
    "Count": 2,
    "StreamBlockList": {
        "StreamBlock": [
            {
                "DomainName": "example.com",
                "AppName": "test",
                "StreamName": "test",
                "BlockType": "whitelist",
                "LocationList": "CN,AS",
                "Status": 2,
                "ReleaseTime": "2023-03-14T03:02:48Z"
            },
            {
                "DomainName": "example.com",
                "AppName": "test",
                "StreamName": "test1",
                "BlockType": "whitelist",
                "LocationList": "CN,AS",
                "Status": 2,
                "ReleaseTime": "2023-03-14T03:02:48Z"
            }
        ]
	}
}