全部產品
Search

搜尋本產品

    Cloud Firewall：DescribePrivateDnsEndpointList - 查詢私網DNS終端節點列表

    文件中心

    Cloud Firewall：DescribePrivateDnsEndpointList - 查詢私網DNS終端節點列表

    更新時間：Jun 10, 2026

    查詢私網DNS終端節點列表

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-cloudfirewall:DescribePrivateDnsEndpointList

    get

    *PrivateDNS

    acs:cloudfirewall::{#accountId}:privatedns/{#AccessInstanceId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AccessInstanceId

    string

    否

    執行個體 ID

    pd-12345
    RegionNo

    string

    否

    地區 ID。

    cn-hangzhou
    VpcId

    string

    否

    VPC 執行個體 ID。

    vpc-8vbwbo90rq0anm6t****
    AccessInstanceName

    string

    否

    私人執行個體名稱。

    test
    FirewallType

    string

    否

    Cloud Firewall類型。取值：

    • internet

    • vpc

    • nat

    vpc
    Status

    string

    否

    執行個體狀態。取值：

    • creating：建立中。

    • deleting：刪除中。

    • normal：正常。

    • updating：更新中。

    normal
    MemberUid

    integer

    否

    成員帳號 UID。

    135809047715****
    PageNo

    integer

    否

    當前頁面的頁碼。

    1
    PageSize

    integer

    否

    當前頁面的頁數。

    10

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    返回結果的請求 ID。

    850A84D6-0DE4-4797-A1E8-00090****
    TotalCount

    integer

    返回結果的總條數。

    3
    PageNo

    integer

    當前頁面的頁碼。

    1
    PageSize

    integer

    當前頁面的頁數。

    10
    AccessInstanceList

    array<object>

    私人執行個體列表。

    object

    私人執行個體列表。

    AliUid

    integer

    Cloud Firewall帳號的 AliUid。

    1379490574415****
    MemberUid

    integer

    Cloud Firewall成員帳號的 UID。

    1844802493****
    RegionNo

    string

    執行個體所在的地區 ID。

    cn-hangzhou
    FirewallType

    array

    Cloud Firewall類型。取值：

    • internet

    • vpc

    • nat

    string

    Cloud Firewall類型。取值：

    • internet

    • vpc

    • nat

    [ "internet", "vpc", "nat" ]
    AccessInstanceId

    string

    執行個體 ID

    123
    AccessInstanceName

    string

    私人執行個體名稱。

    test
    PrivateDnsType

    string

    私人 DNS 類型。取值：

    • PrivateZone

    • Custom（預設）

    Custom
    VpcId

    string

    VPC 執行個體 ID。

    vpc-2zelphbaourpun****
    PrimaryDns

    string

    主 DNS。

    1.1.1.1
    StandbyDns

    string

    備 DNS。

    1.1.1.2
    Port

    integer

    連接埠號碼。

    443
    IpProtocol

    integer

    IP 協議。取值：

    • TCP

    • UDP

    tcp
    Status

    integer

    執行個體狀態。取值：

    • creating：建立中。

    • deleting：刪除中。

    • normal：正常。

    • updating：更新中。

    • abnormal：異常。

    normal
    DomainNameCount

    integer

    網域名稱數。

    3
    TaskId

    string

    任務 Id，任務的唯一標識。

    123
    GmtCreate

    integer

    建立時間（秒，時間戳記格式）。

    1715075765

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090****",
  "TotalCount": 3,
  "PageNo": 1,
  "PageSize": 10,
  "AccessInstanceList": [
    {
      "AliUid": 0,
      "MemberUid": 0,
      "RegionNo": "cn-hangzhou",
      "FirewallType": [
        "[\n  \"internet\",\n  \"vpc\",\n  \"nat\"\n]"
      ],
      "AccessInstanceId": "123",
      "AccessInstanceName": "test",
      "PrivateDnsType": "Custom",
      "VpcId": "vpc-2zelphbaourpun****",
      "PrimaryDns": "1.1.1.1",
      "StandbyDns": "1.1.1.2",
      "Port": 443,
      "IpProtocol": 0,
      "Status": 0,
      "DomainNameCount": 3,
      "TaskId": "123",
      "GmtCreate": 1715075765
    }
  ]
}

    錯誤碼

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

    變更歷史

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