全部產品
Search

搜尋本產品

    Web Application Firewall：DescribeCloudResourceList

    文件中心

    Web Application Firewall：DescribeCloudResourceList

    更新時間：Jul 10, 2026

    查詢雲端產品接入資源列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-waf:DescribeCloudResourceList

    list

    *DefenseResource

    acs:yundun-waf:{#regionId}:{#accountId}:defenseresource/{#Resource}

    		 無
    • yundun-waf:DescribeCloudResourceList

    請求文法

    POST  HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    InstanceId

    string

    是

    WAF 執行個體的 ID。

    說明

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

    waf_elasticity-cn-0xldbqt****
    ResourceManagerResourceGroupId

    string

    否

    阿里雲資源群組 ID。

    rg-acfm***q
    OwnerUserId

    string

    否

    資源歸屬使用者 UID。

    1111111111
    ResourceInstanceId

    string

    否

    資源的執行個體 ID。

    i-8vbdlsd********81e22
    Port

    string

    否

    接入 WAF 的雲端產品連接埠。

    80
    ResourceProduct

    string

    否

    資源所屬雲端產品，取值：

    • alb：表示 ALB 產品。

    • mse：表示 MSE 產品。

    • fc：表示 FC 產品。

    • sae：表示 SAE 產品。

    • ecs：表示 ECS 產品。

    • clb4：表示 CLB (TCP) 產品。

    • clb7：表示 CLB (HTTP/HTTPS) 產品。

    • apig：表示 APIG 產品。

    • nlb：表示 NLB 產品。

    • ddos：表示 DDoS 產品。

    說明

    每個產品支援的地域不同，當產品篩選欄位有值時，需要參考地域支援的產品，否則可能導致篩選失敗。

    ecs
    CloudResourceId

    string

    否

    已接入的資源 ID，雲端產品接入時由 WAF 自動產生。

    說明

    您可以透過 CreateCloudResource 接入資源後，檢視回應中的資源 ID。

    i-8vbdlsd********81e22-80-ecs
    NextToken

    string

    否

    下一頁查詢憑證（Token），如果有下一頁，則該欄位有回傳值。

    說明

    該參數只要有回傳值，即表示還有下一頁。您可以將回傳的 NextToken 作為請求參數再次取得下一頁的資料，直到無回傳值，表示已取得所有資料。

    AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS
    MaxResults

    integer

    否

    分頁查詢時每頁筆數。取值範圍為：1-100，預設值為 10。

    10
    RegionId

    string

    否

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

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

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

    cn-hangzhou
    ResourceDomain

    string

    否

    接入 WAF 的網域名稱。

    說明

    僅當雲端產品類型為 ddos 時，支援查詢。

    www.c**sw.net
    地域 ID地域名稱支援的產品
    cn-hangzhou華東 1（杭州）SAE,ALB,FC,MSE,ECS,CLB,NLB
    cn-shanghai華東 2（上海）SAE,ALB,FC,MSE,ECS,CLB,NLB
    cn-shenzhen華南 1（深圳）SAE,ALB,FC,MSE,ECS,CLB,NLB
    cn-beijing華北 2（北京）SAE,ALB,FC,MSE,ECS,CLB,NLB
    cn-zhangjiakou華北 3（張家口）SAE,ALB,FC,MSE,ECS,CLB,NLB
    cn-chengdu西南 1（成都）ALB,ECS,CLB,NLB
    cn-qingdao華北 1（青島）ALB,ECS,CLB,NLB
    cn-guangzhou華南 3（廣州）ALB
    cn-wulanchabu華北 6（烏蘭察布）ALB
    cn-hongkong中國香港ALB,MSE,ECS,CLB,NLB
    cn-fuzhou華東 6（福州-本地地域-關停中）ALB
    ap-southeast-6菲律賓（馬尼拉）ALB
    ap-southeast-5印度尼西亞（雅加達）ALB,ECS,CLB,NLB
    ap-northeast-1日本（東京）ALB
    ap-southeast-3馬來西亞（吉隆坡）ALB,MSE,ECS,CLB,NLB
    ap-southeast-1新加坡ALB,MSE
    eu-central-1德國（法蘭克福）ALB
    us-west-1美國（矽谷）ALB
    us-east-1美國（維吉尼亞）ALB

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    本次請求的 ID。

    F35F45B0-5D6B-4238-BE02-A62D****E840
    NextToken

    string

    下一頁查詢憑證（Token），如果有下一頁，則該欄位有回傳值。

    說明

    該參數只要有回傳值，即表示還有下一頁。您可以將回傳的 NextToken 作為請求參數再次取得下一頁的資料，直到無回傳值，表示已取得所有資料。

    AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS
    TotalCount

    integer

    回傳結果的總數。

    118
    MaxResults

    integer

    分頁查詢時每頁筆數。

    20
    CloudResourceList

    array<object>

    雲端產品接入 WAF 的資源列表。

    object

    雲端產品接入 WAF 的資源。

    Protocol

    string

    通訊協定類型。取值：

    • http：表示 HTTP 通訊協定。

    • https：表示 HTTPS 通訊協定。

    http
    Port

    integer

    接入 WAF 的雲端產品連接埠。

    80
    ResourceRegionId

    string

    資源歸屬地域 ID，取值請檢視回傳參數補充說明。

    cn-hangzhou
    ResourceInstanceId

    string

    已接入 WAF 的執行個體 ID。

    i-8vbdlsd********81e22
    ResourceProduct

    string

    資源所屬雲端產品。取值：

    • alb：表示 ALB 產品。

    • mse：表示 MSE 產品。

    • fc：表示 FC 產品。

    • sae：表示 SAE 產品。

    • ecs：表示 ECS 產品。

    • clb4：表示 CLB (TCP) 產品。

    • clb7：表示 CLB (HTTP/HTTPS) 產品。

    • nlb：表示 NLB 產品。

    ecs
    CloudResourceId

    string

    接入的資源 ID，由 WAF 自動產生。

    i-8vbdlsd********81e22-80-ecs
    ResourceManagerResourceGroupId

    string

    阿里雲資源群組 ID。

    rg-aek2uo2****lbka
    ResourceDomain

    string

    接入 WAF 的網域名稱。

    www.c**sw.net

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "F35F45B0-5D6B-4238-BE02-A62D****E840",
  "NextToken": "AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS",
  "TotalCount": 118,
  "MaxResults": 20,
  "CloudResourceList": [
    {
      "Protocol": "http",
      "Port": 80,
      "ResourceRegionId": "cn-hangzhou",
      "ResourceInstanceId": "i-8vbdlsd********81e22",
      "ResourceProduct": "ecs",
      "CloudResourceId": "i-8vbdlsd********81e22-80-ecs",
      "ResourceManagerResourceGroupId": "rg-aek2uo2****lbka",
      "ResourceDomain": "www.c**sw.net"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Waf.Instance.ValidFaild WAF instance check failed. Check whether the instance ID is correct. WAF 執行個體檢查失敗，請確認執行個體 ID 是否正確。
    400 Waf.Pullin.CloudProductParamEmpty The resource Id of the cloud product accessing WAF is null or null values exist in the three input parameters of the cloud product name, port, and cloud product instance. 雲端產品接入 WAF 的資源 ID 為空，或雲端產品名稱、連接埠、雲端產品執行個體等 3 個輸入參數中存在空值。
    400 Waf.Pullin.CloudResourceInvalid CloudResourceId parameter is illegal. CloudResourceId 參數不合法。

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

    變更歷史

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