全部產品
Search

搜尋本產品

    Web Application Firewall：DescribeHybridCloudResources

    文件中心

    Web Application Firewall：DescribeHybridCloudResources

    更新時間：Jul 06, 2026

    查詢混合雲端網域列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-waf:DescribeHybridCloudResources

    get

    *All Resource

    *
    • acs:ResourceGroupId
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    InstanceId

    string

    是

    WAF 執行個體的 ID。

    說明

    您可以呼叫 DescribeInstance ，檢視目前 WAF 執行個體的 ID。

    waf_v3prepaid_public_cn-***********
    Domain

    string

    否

    要查詢的網域名稱。

    www.aliyundoc.com
    Backend

    string

    否

    網域對應的來源伺服器 IP 或伺服器回源網域。

    1.1.XX.XX
    PageNumber

    integer

    否

    分頁查詢時，返回第幾頁資料。預設值為 1，表示返回第 1 頁資料。

    1
    PageSize

    integer

    否

    分頁查詢時，每頁包含多少筆結果。預設值為 10，表示每頁包含 10 筆結果。

    10
    CnameEnabled

    boolean

    否

    是否啟用公共雲端容災。取值：

    • true：表示啟用公共雲端容災。

    • false：表示不啟用公共雲端容災。

    true
    RegionId

    string

    否

    WAF 執行個體所屬地域。取值：

    • cn-hangzhou：表示中國內地。

    • ap-southeast-1：表示非中國內地。

    cn-hangzhou
    ResourceManagerResourceGroupId

    string

    否

    阿里雲資源群組 ID。

    rg-acfmvtc5z52****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Domains

    array<object>

    本次獲取的網域列表。

    array<object>

    網域接入詳情。

    Status

    integer

    網域狀態。取值：

    • 1：表示網域處於正常狀態。

    • 2：表示網域建立中。

    • 3：表示網域修改中。

    • 4：表示網域釋放中。

    • 5：表示網域停止轉發。

    1
    ResourceManagerResourceGroupId

    string

    阿里雲資源群組 ID。

    rg-acfmvtc5z52****
    Uid

    string

    使用者 ID。

    130715431409****
    Listen

    object

    設定監聽資訊。

    HttpsPorts

    array

    HTTPS 連接埠列表。

    integer

    HTTPS 協議的連接埠。

    443
    ProtectionResource

    string

    要使用的防護資源類型。取值：

    • share：表示使用共用叢集。

    • gslb：表示使用共用叢集智能負載平衡。

    share
    CustomCiphers

    array

    要添加的具體自訂加密套件。

    說明

    僅 CipherSuite 取值為 99 時，返回該參數。

    string

    自訂加密套件。

    ECDHE-ECDSA-AES128-GCM-SHA256
    TLSVersion

    string

    TLS 的版本。取值：

    • tlsv1

    • tlsv1.1

    • tlsv1.2

    tlsv1.2
    Http2Enabled

    boolean

    是否開啟 HTTP2。取值：

    • true：表示開啟 HTTP2。

    • false：表示不開啟 HTTP2。

    false
    CertId

    string

    認證 ID

    72***76-cn-hangzhou
    CipherSuite

    integer

    加密套件類型。取值：

    • 1：表示添加全部加密套件。

    • 2：表示添加強加密套件。

    • 99：表示添加自訂加密套件。

    1
    EnableTLSv3

    boolean

    是否支援 TLS1.3 版本。取值：

    • true：表示支援 TLS1.3 版本。

    • false：表示不支援 TLS1.3 版本。

    true
    IPv6Enabled

    boolean

    開啟 IPv6 是否開啟 IPv6。取值：

    • true：表示開啟 IPv6。

    • false：表示不開啟 IPv6。

    false
    FocusHttps

    boolean

    是否開啟 HTTPS 的強制跳轉。取值：

    • true：表示開啟 HTTPS 的強制跳轉。

    • false：表示不開啟 HTTPS 的強制跳轉。

    false
    XffHeaders

    array

    用於擷取用戶端 IP 的自訂欄位列表，使用**["header1","header2",……]**格式表示。

    說明

    僅在 XffHeaderMode 取值為 2（表示 WAF 讀取要求標頭中由您設定的自訂欄位值作為用戶端 IP）時，返回該參數。

    string

    用於擷取用戶端 IP 的自訂欄位列表。

    Client-ip
    XffHeaderMode

    integer

    WAF 擷取用戶端真實 IP 的方式。取值：

    • 0：表示用戶端訪問流量到 WAF 前沒有經過其他七層代理轉寄。

    • 1：表示 WAF 讀取要求標頭中 X-Forwarded-For（XFF）欄位的第一個值作為用戶端 IP。

    • 2：表示 WAF 讀取要求標頭中由您設定的自訂欄位值作為用戶端 IP。

    0
    ExclusiveIp

    boolean

    是否支援獨享 IP。取值：

    • true：表示支援。

    • false：表示不支援。

    true
    HttpPorts

    array

    HTTP 協議的監聽連接埠列表。

    integer

    HTTP 協議的監聽連接埠。

    80
    Id

    integer

    接入 ID。

    12345
    Redirect

    object

    設定轉發資訊。

    ConnectTimeout

    integer

    連線逾時時間長度。單位：秒。 取值範圍：5~120。

    120
    Keepalive

    boolean

    是否保持長串連。取值：

    • true：表示保持長串連。

    • false：表示不保持長串連。

    true
    SniEnabled

    boolean

    是否開啟回源 SNI。取值：

    • true：表示開啟回源 SNI。

    • false：表示不開啟回源 SNI。

    true
    CnameEnabled

    boolean

    是否開啟公用雲容災。取值：

    • true：表示開啟公用雲容災。

    • false：表示不開啟公用雲容災。

    true
    KeepaliveTimeout

    integer

    空閑長連線逾時時間，取值範圍：1~60，預設 15，單位：秒。

    說明

    複用的長串連空閑多久後釋放。

    15
    ReadTimeout

    integer

    讀逾時時間長度，單位：秒。 取值範圍：5~1800。

    200
    Backends

    array

    網域名稱對應的來源站點伺服器 IP 或伺服器回源網域名稱。

    string

    網域名稱對應的來源站點伺服器 IP 或伺服器回源網域名稱。

    1.1.XX.XX
    SniHost

    string

    SNI 擴充欄位的自訂值。取值為空白表示未自訂 SNI 值，預設使用要求標頭中 Host 欄位的值作為 SNI 擴充欄位的值。

    說明

    僅在 SniEnabled 取值為 true（表示開啟 SNI 回源）時，返回該參數。

    www.aliyundoc.com
    FocusHttpBackend

    boolean

    是否開啟強制 HTTP 回源。取值：

    • true：表示開啟強制 HTTP 回源。

    • false：表示不開啟強制 HTTP 回源。

    true
    WriteTimeout

    integer

    寫逾時時間長度，單位：秒。 取值範圍：5~1800。

    200
    RoutingRules

    string

    混合雲轉寄規則。使用 JSON 數組轉化的字串格式表示。JSON 數組中的每個元素是一個結構體，包含以下欄位：

    • rs：Array 類型 | 表示回源 IP 位址或者回源 CNAME 列表

    • location：String 類型 | 表示防護節點名稱

    • locationId：Long 類型 | 表示防護節點 ID

    [ { "rs": [ "1.1.XX.XX" ], "locationId": 535, "location": "test1111" } ]
    Retry

    boolean

    WAF 回源失敗時，是否重試。取值：

    • true：表示重試。

    • false：表示不重試。

    true
    RequestHeaders

    array<object>

    網域名稱的流量標記欄位和值，用於標記經過 WAF 處理的流量。

    object

    網域名稱的流量標記欄位和值，用於標記經過 WAF 處理的流量。

    Value

    string

    指定的自訂要求標頭部欄位設定的值。

    bbb
    Key

    string

    指定的自訂要求標頭部欄位。

    aaa
    KeepaliveRequests

    integer

    複用長串連的請求個數。取值範圍：60~1000，單位：個。

    說明

    開啟長串連後，複用多少個長串連。

    1000
    Loadbalance

    string

    回源時採用的負載平衡演算法。取值：

    • iphash：表示 IP Hash 演算法。

    • roundRobin：表示輪詢演算法。

    • leastTime：表示 Least Time 演算法。

    iphash
    Domain

    string

    網域。

    www.aliyundoc.com
    Cname

    string

    WAF 為網域分配的 CNAME 位址。

    說明

    僅在 CnameEnabled 取值為 true（表示啟用公共雲端容災）時，返回此參數。

    50fqmu1ci7g0xtiyxnrhgx6qdhmn****.yundunwaf5.com
    TotalCount

    integer

    返回結果的總數。

    24
    RequestId

    string

    本次請求的 ID。

    98D2AA9A-5959-5CCD-83E3-B6606232A2BE

    樣本

    正常返回樣本

    JSON格式

    {
  "Domains": [
    {
      "Status": 1,
      "ResourceManagerResourceGroupId": "rg-acfmvtc5z52****",
      "Uid": "130715431409****",
      "Listen": {
        "HttpsPorts": [
          443
        ],
        "ProtectionResource": "share",
        "CustomCiphers": [
          "ECDHE-ECDSA-AES128-GCM-SHA256"
        ],
        "TLSVersion": "tlsv1.2",
        "Http2Enabled": false,
        "CertId": "72***76-cn-hangzhou",
        "CipherSuite": 1,
        "EnableTLSv3": true,
        "IPv6Enabled": false,
        "FocusHttps": false,
        "XffHeaders": [
          "Client-ip"
        ],
        "XffHeaderMode": 0,
        "ExclusiveIp": true,
        "HttpPorts": [
          80
        ]
      },
      "Id": 12345,
      "Redirect": {
        "ConnectTimeout": 120,
        "Keepalive": true,
        "SniEnabled": true,
        "CnameEnabled": true,
        "KeepaliveTimeout": 15,
        "ReadTimeout": 200,
        "Backends": [
          "1.1.XX.XX"
        ],
        "SniHost": "www.aliyundoc.com",
        "FocusHttpBackend": true,
        "WriteTimeout": 200,
        "RoutingRules": "[\n      {\n            \"rs\": [\n                  \"1.1.XX.XX\"\n            ],\n            \"locationId\": 535,\n            \"location\": \"test1111\"\n      }\n]",
        "Retry": true,
        "RequestHeaders": [
          {
            "Value": "bbb",
            "Key": "aaa"
          }
        ],
        "KeepaliveRequests": 1000,
        "Loadbalance": "iphash"
      },
      "Domain": "www.aliyundoc.com",
      "Cname": "50fqmu1ci7g0xtiyxnrhgx6qdhmn****.yundunwaf5.com"
    }
  ],
  "TotalCount": 24,
  "RequestId": "98D2AA9A-5959-5CCD-83E3-B6606232A2BE"
}

    錯誤碼

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

    變更歷史

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