調用DescribeDomainCname檢測加速網域名稱Cname解析狀態-CDN-阿里雲 - CDN

呼叫介面對加速網域 Cname 進行解析檢測，檢視解析結果判斷是否完成 Cname 設定。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cdn:DescribeDomainCname

get

*Domain

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

無

請求參數

名稱	類型	必填	描述	樣本值
DomainName	string	是	需要查詢的加速網域，多個用逗號（,）分隔，單次查詢最多支援 30 個網域。	example.com,example.org

返回參數

名稱	類型	描述	樣本值
	object	檢測結果。
RequestId	string	請求 ID。	06D29681-B7CD-4034-A8CC-28AFFA213539
CnameDatas	object
Data	array<object>	Cname 檢測結果陣列。
	object	Cname 資訊。
Status	integer	Cname 檢查結果。取值： 0 表示通過網域名稱解析檢測到分配給網域名稱的 cname。 1 表示通過網域名稱解析暫未監測到分配給網域名稱的 cname。 -1 表示通過網域名稱解析檢測到分配給網域名稱的 cname 逾時枚舉值： 0 : 0 1 : 1 -1 : -1	0
Domain	string	輸入參數中的加速網域名稱。	a.com
Cname	string	阿里雲 CDN 分配給網域名稱的 Cname	a.com.w.alikunlun.net
Passed	string	通過網域名稱解析檢測到分配給網域名稱的 cname 是否通過，取值： true: 通過 false: 不通過 timeout: 逾時	true
ErrMsg	string	通過網域名稱解析檢測到分配給網域名稱的 cname 不通過或逾時的錯誤資訊。	timeout

樣本

正常返回樣本

JSON格式

{
  "RequestId": "06D29681-B7CD-4034-A8CC-28AFFA213539",
  "CnameDatas": {
    "Data": [
      {
        "Status": 0,
        "Domain": "a.com",
        "Cname": "a.com.w.alikunlun.net",
        "Passed": "true",
        "ErrMsg": "timeout"
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	DomainNameOverLimit	A maximum of 30 domains are supported for each request.
403	InvaildParameter	The parameter you provided is invalid.

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

變更歷史

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