DescribeHybridCloudClusterServers - 集群机器列表_Web应用防火墙(WAF)-阿里云帮助中心

集群机器列表

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-waf:DescribeHybridCloudClusterServers

get

*全部资源

*

acs:ResourceGroupId

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	WAF 实例 ID。说明您可以通过调用 DescribeInstance 接口查看当前 WAF 实例 ID。	waf_v3prepaid_public_cn-******nd07
ClusterId	integer	是	集群 ID。	1
Ip	string	否	服务器 IP 地址。	1.X.X.1
HostName	string	否	主机名称。	online-***wwq
GroupType	string	否	混合云节点组类型。取值： protect：防护。 control：管控。 storage：存储。 controlStorage：管控＆存储。	protect
GroupName	string	否	节点组名称。	test
PageSize	integer	否	分页查询时，每页的行数。默认值为 10。	10
PageNumber	integer	否	当前页码。默认值：1。	1
RegionId	string	否	WAF 实例所属地域。取值： cn-hangzhou：表示中国内地。 ap-southeast-1：表示非中国内地。	cn-hangzhou
ResourceManagerResourceGroupId	string	否	阿里云资源组 ID。	rg-acfm***q

返回参数

名称	类型	描述	示例值
	object
TotalCount	integer	返回结果的总数。	3
RequestId	string	请求 ID。	C3B0FDD2-11CE-59A5-BEB5-*****1A969
ClusterServers	array<object>	结果列表。
	object
GroupName	string	节点组名称。	测试组。
Operator	string	云厂商。	aliyun。
Status	string	机器状态。	ok
RegionCodeValue	integer	区域 code。	0
RegionCode	string	区域名称。	beijing
Memory	integer	内存数据。	33547386880
Ip	string	IP 地址。	1..1。
Cpu	integer	cpu 核数。	4
Mid	string	机器 MID。	28ab688cd403563e8e173*****79600
ContinentsValue	integer	防护集群大洲 Code。说明 Code 的取值列表，见返回参数补充说明。	410
Mac	string	MAC 地址。	::00:02:eb:c7
GroupId	integer	节点分组 ID。	1
JobStatus	string	机器运行状态。	running
GroupType	string	混合云节点组类型。取值： protect：防护。 control：管控。 storage：存储。 controlStorage：管控＆存储。	protect
CustomName	string	节点组名称。	测试组
UpdateTimestamp	integer	最后更新时间戳。	1711953897000
Continents	string	大洲。	asiapacific
CreateTimestamp	integer	创建时间戳，单位为毫秒。	1665987186000
HostName	string	主机名称。	qsh5-sec-waf-*****-6
OperatorValue	integer	操作值。	0

示例

正常返回示例

JSON格式

{
  "TotalCount": 3,
  "RequestId": "C3B0FDD2-11CE-59A5-BEB5-*****1A969",
  "ClusterServers": [
    {
      "GroupName": "测试组。",
      "Operator": "aliyun。",
      "Status": "ok",
      "RegionCodeValue": 0,
      "RegionCode": "beijing",
      "Memory": 33547386880,
      "Ip": "1.*.*1。",
      "Cpu": 4,
      "Mid": "28ab688cd403563e8e173*****79600",
      "ContinentsValue": 410,
      "Mac": "**:**:00:02:eb:c7",
      "GroupId": 1,
      "JobStatus": "running",
      "GroupType": "protect",
      "CustomName": "测试组",
      "UpdateTimestamp": 1711953897000,
      "Continents": "asiapacific",
      "CreateTimestamp": 1665987186000,
      "HostName": "qsh5-sec-waf-*****-6",
      "OperatorValue": 0
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。