調用DescribeCdnDomainStagingConfig查詢網域名稱類比環境配置-CDN-阿里雲 - CDN

呼叫 DescribeCdnDomainStagingConfig 查詢模擬環境配置資訊，一次可查詢多個功能配置。

介面說明

說明

單使用者呼叫頻率：30 次/秒。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cdn:DescribeCdnDomainStagingConfig

get

*Domain

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

無

請求參數

名稱	類型	必填	描述	樣本值
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.

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

變更歷史

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