全部產品
Search
文件中心

:DescribeL2VipsByDomain - 查詢節點IP地址-L2

更新時間:Dec 05, 2025

調用DescribeL2VipsByDomain查詢指定網域名稱的L2節點的IP地址。

介面說明

該介面僅支援日峰值頻寬為 1Gbps 以上的使用者調用,如果您符合該條件,請提交工單申請該介面的調用許可權。

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

  • 本介面的返回結果僅支援 CDN 控制台接入網域名稱查詢相關 L2 節點地址,DCDN 控制台接入網域名稱不適用。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cdn:DescribeL2VipsByDomain

get

*Domain

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

請求參數

名稱

類型

必填

描述

樣本值

DomainName

string

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

example.com

返回參數

名稱

類型

描述

樣本值

object

DomainName

string

網域名稱。

example.com

RequestId

string

請求 ID。

16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Vips

object

Vip

array

VIP 列表。

string

VIP 位址。

1.1.1.1/25

樣本

正常返回樣本

JSON格式

{
  "DomainName": "example.com",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "Vips": {
    "Vip": [
      "1.1.1.1/25"
    ]
  }
}

異常返回樣本

JSON格式

{"RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8","HostId":"cdn.aliyuncs.com","Code":"InternalError","Message":"The request processing has failed due to some unknown error."}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 IllegalOperation Illegal domain operate is not permitted. 網域名稱不支援當前操作
400 SingleRequest.OverLimit A maximum of 1 DomainName is supported for each request.
403 SystemBusy The system is busy, please try again later.

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

變更歷史

更多資訊,參考變更詳情