全部產品
Search

搜尋本產品

    ApsaraVideo Live：BatchSetLiveDomainConfigs - 大量設定網域名稱

    文件中心

    ApsaraVideo Live：BatchSetLiveDomainConfigs - 大量設定網域名稱

    更新時間：Dec 13, 2025

    大量設定網域名稱。

    介面說明

    先擷取需要進行配置的直播網域名稱，再調用本介面大量設定網域名稱。

    QPS 限制

    本介面的單使用者 QPS 限制為 30 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    live:BatchSetLiveDomainConfigs

    update

    *Domain

    acs:cdn:*:{#accountId}:domain/{#DomainName}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DomainNames

    string

    是

    需要進行大量設定的網域名稱。取值可以是推流網域名稱、主播流網域名稱或子播流網域名稱。多個網域名稱用英文逗號（,）分隔。

    demo.aliyundoc.com,example.aliyundoc.com,example.com
    Functions

    string

    是

    功能列表。

    某些功能，如filetype_based_ttl_set，可以設定多條記錄，當需要更新其中某條記錄時，可通過該條記錄的configId來指定。更多資訊，請參見下表 Function 格式說明和Functions 功能說明。

    [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

    Functions 格式說明

    • 樣本如下所示： [{"functionArgs":[{"argName":"domain_name","argValue":"developer.aliyundoc.com"}],"functionName":"set_req_host_header"}]

    • 某些功能，如 filetype_based_ttl_set，可以設定多條記錄，當需要更新其中某條記錄時，可通過該條記錄的 configId 來指定，樣本如下所示： [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

    Functions 功能說明

    名稱參數
    referer_white_list_set：refer 白名單。refer_domain_allow_list：白名單列表，多個使用英文逗號（,）分隔。
    allow_empty：是否允許空 refer 進入。取值：on 或 off。
    referer_black_list_set：refer 黑名單。refer_domain_deny_list：黑名單列表，多個使用英文逗號（,）分隔。
    allow_empty：是否允許空 refer 進入。取值：on 或 off。
    filetype_based_ttl_set：檔案到期時間設定。ttl：cache 時間。單位：秒，取值範圍是 1~99999999（3 年多一些）。
    file_type：檔案類型。多個使用英文逗號（,）隔開。
    weight：權重。取值範圍：1~99。

    path_based_ttl_set：目錄到期時間設定。ttl：cache 時間。單位：秒，取值範圍是 1~99999999（3 年多一些）。
    path：目錄。必須以正斜線（/）開頭。
    weight：權重。取值範圍：1~99。

    oss_auth：OSS 鑒權 Bucket。oss_bucket_id：使用者 bucket 地址。
    ip_black_list_set：IP 黑名單。ip_list：IP 列表。多個使用英文逗號（,）隔開。
    ip_allow_list_set：IP 白名單。ip_list：IP 列表。多個使用英文逗號（,）隔開。
    ip_white_list_set：訪問頻次控制免攔截。ip_list：IP 列表。多個使用英文逗號（,）隔開。
    error_page：錯誤頁面重新導向。error_code：錯誤碼。
    rewrite_page：重新導向頁面。
    set_req_host_header：修改回源 Host 頭。domain_name：回源 Host 頭內容。
    set_hashkey_args：忽略 URL 參數。hashkey_args：保留參數的列表。多個使用英文逗號（,）分隔。
    disable：是否忽略所有參數。取值：僅支援 on（忽略所有參數）或 off（不忽略）。
    aliauth：阿里鑒權。auth_type：鑒權類型。取值：type_a（鑒權 A）、no_auth（關閉鑒權）。
    auth_key1：鑒權 key1，鑒權 key 支援大寫字母、小寫字母、數字，建議設定長度為 8~32 個字元。
    auth_key2：鑒權 key2。
    ali_auth_delta：自訂鑒權緩衝時間，單位：秒。建議最小設定為 60 秒，無上限限制。
    auth_m3u8：是否開啟 m3u8 內容改寫，對 m3u8 裡面的 ts 補齊對應的鑒權，可以避免 ts 的訪問鑒權失敗。取值：on（預設值）或 off。



    remote_auth：直播遠程鑒權 。enable：是否開啟遠程鑒權，必填項。取值：on 或 off。
    remote_auth_path ： 鑒權伺服器位址，必填項。
    remote_auth_pattern ：鑒權模式串。有以下功能可設定：
    - param：是否向鑒權伺服器透傳推流 URL 中的參數，取值 pass（預設）或 fail。
    - args_white：透傳指定參數設定，多個參數用英文逗號（,）分隔。
    - args_black：不透傳指定參數設定，多個參數用英文逗號（,）分隔。
    - code：鑒權狀態代碼，code=XXX，鑒權伺服器在鑒權成功時返回給直播的 HTTP 狀態代碼。例如：code=200。code=~XXX，鑒權伺服器在鑒權失敗時返回給直播的 HTTP 狀態代碼。例如：code=~403。
    - delta ：鑒權逾時時間長度。
    - retry：鑒權逾時重試次數。
    - timeout：鑒權逾時行為，取值：pass 或 fail。pass：ApsaraVideo for Live將直接通過使用者請求。fail：ApsaraVideo for Live將響應鑒權失敗狀態代碼（403）給使用者。
    - async：非同步鑒權，取值 on（開啟非同步鑒權）或 off（預設，關閉非同步鑒權）。









    set_resp_header：設定回應標頭（瀏覽器端可見）。key：回應標頭。取值：
    Content-Type。
    Cache-Control。
    Content-Disposition。
    Content-Language。
    Expires。
    Access-Control-Allow-Origin。
    Access-Control-Allow-Methods。
    Access-Control-Allow-Headers。
    Access-Control-Max-Age。
    Access-Control-Expose-Headers。
    value：回應標頭內容。刪除填寫 null。











    https_force：強制 HTTPS 跳轉。enable：功能開關。取值：on 或 off。https_force 和 http_force 只能存在其中一個，兩者為互斥關係，配置另外一個需要先刪除原來的配置。
    http_force：強制 HTTP 跳轉。enable：功能開關。取值：on 或 off。https_force 和 http_force 只能存在其中一個，兩者為互斥關係，配置另外一個需要先刪除原來的配置。
    forward_scheme：自適應回源。enable：功能開關，取值：on 或 off。
    scheme_origin：回來源站點協議 （http、https、follow）。
    scheme_origin_port：回來源站點協議連接埠（80、443、80:443）。

    green_manager：鑒黃功能。enable：是否開啟鑒黃功能。取值：on 或 off。
    tmd_signature：自訂的訪問頻次控制規則。name：規則名稱。網域名稱內不可重複。
    path：可重複，需校正 URI 路徑合法性。
    pathType：匹配規則。0 首碼匹配，1 完全符合。
    interval：監測時間長度。單位：秒。參數限制必須≥10。
    count：單 IP 訪問次數。
    action：阻斷類型。0 封鎖，1 人機識別。
    ttl：阻斷時間長度。單位：秒。





    l2_oss_key：L2 OSS 回源私密金鑰。private_oss_auth：是否開啟私人 OSS 鑒權功能。取值：on 或 off。
    video_seek：視頻切片拖拽開關。enable：功能開關。取值：on 或 off。
    gzip：頁面 Gzip 最佳化 。enable：功能開關。取值：on 或 off。
    tesla：頁面最佳化加速。enable：功能開關。取值：on 或 off。
    ali_ua：User-Agent 限制訪問。ua：User-Agent。
    type：名單類型。取值 black 和 white。
    host_redirect:rewrite功能。regex：需要重寫的 URL。例如 ^/$。
    replacement：目標 URL。例如 /go/act/sale/tbzlsy.php。
    flag：僅支援：redirect、break。

    ipv6：ipv6 配置。switch：開關（必填）。取值：on 或 off，開啟功能，一旦開啟後，如需關閉請取消勾選，不要刪除配置，否則不生效。
    region：開啟 IPv6 功能的地區，取值：cn-beijing（北京）、cn-shanghai（上海）、cn-shenzhen（深圳）、cn-qingdao（青島）、apsoutheast-1（新加坡）、eu-central-1（德國）、ap-northeast-1（東京）、ap-southeast-5（雅加達）。
    ali_location：地區限制訪問。location：地區列表。
    type：名單類型。取值 black 或 white。
    cc_defense：防 CC 攻擊。enable：開啟或關閉防 CC 攻擊。取值：on 或 off。
    alilive：ApsaraVideo for Live配置。notify_url：直播通知 URL。
    enable：功能開關。取值：on 或 off。
    live_forbid_flv：禁止播放 flv。取值：on 或 off。
    live_forbid_rtmp：禁止播放 rtmp。取值：on 或 off。
    live_forbid_hls：禁止播放 hls。取值：on 或 off。



    ali_grtn：grtn 業務接入開關。grtn_rts_pub：RTS 推流開關，推流網域名稱使用。取值：on 或 off。
    grtn_rts_play：RTS 播流開關，播流網域名稱使用。取值：on 或 off。
    grtn_rts_transcode：RTS H5 播放自動轉碼開關。取值：on 或 off。

    edge_function：邊緣函數。必填參數：
    rule：DSL 規則。
    pri：優先順序。
    enable：本條規則是否生效。取值：on 或 off。
    選擇性參數：
    name：規則名稱。
    pos：規則執行位置。
    brk：命中本條規則後，當前執行位置剩餘規則均跳過。
    option：option 管控。
    grammar：grammar 管控。可選值：空、es2、js。
    jsmode：js 網域名稱白單管控，可選值：redirect 或 bypass。









    https_tls_version：TLS 協議版本。tls10：開啟 TLSv1.0，預設為 on。取值：on 或 off。
    tls11：開啟 TLSv1.1，預設為 on。取值：on 或 off。
    tls12：開啟 TLSv1.2，預設為 on。取值：on 或 off。
    tls13：開啟 TLSv1.3，預設為 on。取值：on 或 off。


    https_option：http 通訊協定設定。http2：是否開啟 http2，預設為 off。取值：on 或 off。
    live_http2：是否開啟 live_http2，預設為 off。取值：on 或 off。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    04F0F334-1335-436C-A1D7-6C044FE73368

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidFunctions.Malformed Specified Functions is malformed.
    400 InvalidFunctionArgs.Malformed The specified FunctionArgs is invalid.
    400 InvalidArgValue.Malformed Specified ArgValue is malformed.
    400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported.
    400 Invalid%s.Malformed ArgValue [%s] is malformed.
    400 MissingParameter%s The specified value of ArgName[%s] is missing.
    400 FunctionMutex Function is mutex with other function.
    400 RewriteHostRely Domain name is configured as rewrite host by others.
    400 ConfigurationConflicts The staging environment has a configuration in effect and cannot modify the production environment configuration. 預發環境存在已生效配置，無法修改生產環境配置。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。