全部產品
Search
文件中心

CDN:DescribeCdnDomainStagingConfig - 查詢類比環境配置

更新時間:Dec 14, 2025

調用DescribeCdnDomainStagingConfig查詢類比環境配置資訊,一次可查詢多個功能配置。

介面說明

說明

單使用者調用頻率:30 次/秒。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

DomainName

string

加速網域名稱,僅支援單個查詢。

example.com

FunctionNames

string

功能名稱列表,多個用半形逗號(,)分隔,可配置功能請參見功能列表

aliauth

返回參數

名稱

類型

描述

樣本值

object

DomainName

string

加速網域名稱。

example.com

RequestId

string

請求 ID。

C80705BF-0F76-41FA-BAD1-5B59296A4E59

DomainConfigs

array<object>

網域名稱配置列表。

array<object>

Status

string

配置狀態。取值:

  • testing:配置校正中。

  • configuring:配置中。

  • success:成功。

  • failed:失敗。

success

ParentId

string

規則條件 ID,非必填項。通過配置網域名稱配置功能參數中的功能函數 condition(規則引擎),可以建立出規則條件(規則條件可以通過識別使用者請求中攜帶的各種參數來匹配和過濾使用者請求),每一個規則條件被建立以後都會產生一個對應的 ConfigId ,ConfigId 可以被當作 ParentId 參數被其他功能函數引用,這樣規則條件就可以與功能配置一起組合形成更靈活的配置。 具體配置操作請參考大量設定網域名稱或下文 ParentId 配置樣本說明。

222728944812032

ConfigId

string

配置 ID。

6xx5

FunctionName

string

功能名稱。

aliauth

FunctionArgs

array<object>

各個功能說明。

object

ArgName

string

配置名稱。

auth_type

ArgValue

string

配置值。

req_auth

ParentId 配置樣本

parentId-1:表示刪除該配置裡面已有的規則條件。

[{
   "functionArgs": [{
     "argName": "功能參數 A", 
     "argValue": "功能參數 A 對應的值"
    }, 
  {
    "argName": "功能參數 B", 
    "argValue": "功能參數 B 對應的值"
     }], 
 "functionName": "功能名稱",
 "parentId": "選填項,對應引用規則條件的 configid"
}]

不使用 parentId 的情況下,配置樣本如下:

使用函數origin_request_header添加回源 HTTP 要求頭的時候引用了configid=222728944812032的規則條件,請求參數如下:

[{
        "functionArgs": [{
            "argName": "header_operation_type",
            "argValue": "add"
        }, {
            "argName": "header_name",
            "argValue": "Accept-Encoding"
        }, {
            "argName": "header_value",
            "argValue": "gzip"
        }, {
            "argName": "duplicate",
            "argValue": "off"
        }],
        "functionName": "origin_request_header"
}]

使用 parentId 的情況下,配置樣本如下:

使用函數origin_request_header添加回源 HTTP 要求頭的時候引用了configid=222728944812032的規則條件,請求參數如下:

[{
        "functionArgs": [{
            "argName": "header_operation_type",
            "argValue": "add"
        }, {
            "argName": "header_name",
            "argValue": "Accept-Encoding"
        }, {
            "argName": "header_value",
            "argValue": "gzip"
        }, {
            "argName": "duplicate",
            "argValue": "off"
        }],
        "functionName": "origin_request_header",
        "parentId": "222728944812032"
}]

樣本

正常返回樣本

JSON格式

{
  "DomainName": "example.com",
  "RequestId": "C80705BF-0F76-41FA-BAD1-5B59296A4E59",
  "DomainConfigs": [
    {
      "Status": "success",
      "ParentId": "222728944812032",
      "ConfigId": "6xx5",
      "FunctionName": "aliauth",
      "FunctionArgs": [
        {
          "ArgName": "auth_type",
          "ArgValue": "req_auth"
        }
      ]
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported.

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

變更歷史

更多資訊,參考變更詳情