全部產品
Search
文件中心

Web Application Firewall:DescribeHybridCloudGroups

更新時間:Aug 12, 2026

查詢新增至 Web 應用程式防火牆的混合雲節點群組清單。

介面說明

呼叫本介面前,請確保 WAF 執行個體已開通混合雲功能。您可以透過呼叫 DescribeInstance 介面查詢執行個體詳細資訊,若返回參數 Details.HybridCloud 為 true,則表示已開通混合雲功能;若未開通,可登入 WAF 主控台透過升級執行個體開通混合雲功能。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-waf:DescribeHybridCloudGroups

list

*全部資源。

*

  • acs:ResourceGroupId
無

請求參數

名稱

類型

必填

描述

樣本值

InstanceId

string

是

WAF 執行個體的 ID。

說明

您可以呼叫 DescribeInstance 查詢目前 WAF 執行個體的 ID。

waf_v3prepaid_public_cn-********w0b

ClusterId

integer

否

混合雲叢集 ID。

428

GroupName deprecated

integer

否

【已廢棄】請使用 GroupDisplayName 進行查詢。

1

GroupDisplayName

string

否

要查詢的混合雲節點群組名稱。

testGroup

GroupType

string

否

混合雲節點群組類型。取值:

  • protect:防護。

  • control:管控。

  • storage:儲存。

  • controlStorage:管控&儲存。

protect

PageNumber

integer

否

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

1

PageSize

integer

否

分頁查詢時,每頁的列數。預設值為 10。

10

ClusterProxyType

string

否

叢集代理類型。取值:

  • service:SDK 整合。

  • cname:反向代理。

cname

RegionId

string

否

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

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

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

cn-hangzhou

ResourceManagerResourceGroupId

string

否

阿里雲資源群組 ID。

rg-acfm***q

返回參數

名稱

類型

描述

樣本值

object

TotalCount

integer

返回結果的總數。

146

RequestId

string

請求 ID,阿里雲為該請求產生的識別碼。

045660E7-C4C6-5CD7-8182-7B337D95ADF4

Groups

array<object>

混合雲節點群組集合。

object

單一混合雲節點資訊。

GroupName

string

混合雲節點群組名稱。

StorageGroup

RegionCodeValue

integer

防護叢集城市 Code。

說明

Code 的取值清單,請參閱返回參數補充說明。

0

LoadBalanceIp

string

負載平衡(伺服器)IP。

1.1.XX.XX

BackSourceMark

string

防護叢集回源標記,格式為 {防護叢集營運商 Name}-{防護叢集大洲 Name}-{防護叢集城市 Name}-{防護叢集回源識別碼}(可選)。

說明

防護叢集營運商 Name、防護叢集大洲 Name、防護叢集城市 Name、防護叢集回源識別碼的取值清單,請參閱返回參數補充說明。

aliyun-asiapacific-beijing-56477821

GroupType

string

混合雲節點群組類型。取值:

  • protect:防護。

  • control:管控。

  • storage:儲存。

  • controlStorage:管控&儲存。

protect

LocationId

integer

防護節點 ID。

1312

Ports

string

混合雲叢集使用的連接埠。取值為字串,多個連接埠時,使用 port1,port2,port3 的格式返回。

80,9200,20018

ContinentsValue

integer

防護叢集大洲 Code。

說明

Code 的取值清單,請參閱返回參數補充說明。

410

GroupId

integer

混合雲節點群組 ID。

123

Remark

string

備註。

remarkTest

OperatorValue

integer

防護叢集營運商 Code。

說明

Code 的取值清單,請參閱返回參數補充說明。

0

防護叢集營運商 Code

營運商 Code營運商 Tag營運商 Desc
0aliyun阿里雲
3tencent騰訊
100googleGoogle
200IDCIDC

防護叢集大洲 Code

防護大洲 Code防護大洲 Tag防護大洲 Desc
410asiapacificasiapacific
411euroeuro

防護叢集城市 Code

防護大洲 Code防護城市 Code防護城市 Tag防護城市 Desc
4110frankfurt法蘭克福
4111siliconvallery矽谷
4112Virginia維吉尼亞
4100beijing北京
4101shanghai上海
4102hongkong中國香港
4103jakarta雅加達
4104hangzhou杭州
4105zhangjiakou張家口
4106shenzhen深圳
4107singapore新加坡
4108Tokyo東京
4109changsha長沙
41010public_cloud公有雲
41011nanjing南京

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 146,
  "RequestId": "045660E7-C4C6-5CD7-8182-7B337D95ADF4",
  "Groups": [
    {
      "GroupName": "StorageGroup",
      "RegionCodeValue": 0,
      "LoadBalanceIp": "1.1.XX.XX",
      "BackSourceMark": "aliyun-asiapacific-beijing-56477821",
      "GroupType": "protect",
      "LocationId": 1312,
      "Ports": "80,9200,20018",
      "ContinentsValue": 410,
      "GroupId": 123,
      "Remark": "remarkTest",
      "OperatorValue": 0
    }
  ]
}

錯誤碼

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

變更歷史

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