请求说明

请求方式：POST
请求地址：https://ga.volcengine-api.com?Action=ListEndpointGroups&Version=2022-03-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	`ListEndpointGroups`	要执行的操作，取值：`ListEndpointGroups`。
Version	String	是	`2022-03-01`	API 的版本，取值：`2022-03-01`。

Body

参数	类型	是否必填	示例值	描述
AcceleratorId	String	否	`accinstance-YfiSM6k5BspFcC4BaG****`	用于按加速器筛选终端节点组。
ListenerId	String	是	`listener-kRcRXoTS4WccfHXVdv****`	指定要查询其终端节点组的监听器 ID。
PageSize	Integer	否	`10`	分页查询时每页返回的最大条目数。默认值为 `10`，最大值为 `1000`。
PageNum	Integer	否	`1`	分页查询的页码。默认值为 `1`。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
EndpointGroups	Object[]		指定监听器下的终端节点组列表，每个元素表示一个终端节点组。
PageNum	Integer	`1`	本次返回结果的页码。
PageSize	Integer	`10`	本次响应的每页条目数。
TotalCount	Integer	`20`	符合查询条件的终端节点组总数。

请求示例

POST https://ga.volcengine-api.com?Action=ListEndpointGroups&Version=2022-03-01
{
  "AcceleratorId": "accinstance-YfiSM6k5BspFcC4BaG****",
  "ListenerId": "listener-kRcRXoTS4WccfHXVdv****",
  "PageSize": 10,
  "PageNum": 1
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202306041104201234100232280022D31",
    "Action": "ListEndpointGroups",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "EndpointGroups": [
      {
        "AcceleratorId": "accinstance-YfiSM6k5BspFcC4BaG****",
        "Region": "CN_East",
        "HealthCheckStatus": "normal",
        "HealthyConfig": {
          "HealthCheckEnable": true,
          "HealthCheckProtocol": "TCP",
          "HealthCheckPort": 80,
          "HealthResponseTimeOut": 2,
          "HealthCheckInterval": 2,
          "HealthyThreshold": 3
        },
        "TrafficPercentage": 100,
        "ListenerId": "listener-kRcRXoTS4WccfHXVdv****",
        "EndpointGroupId": "endpointgroup-pFJjvVR67ZTb4ZcW6T****",
        "Name": "test",
        "State": "active",
        "EndpointConfigurations": [
          {
            "Type": "IP",
            "Endpoint": "203.0.113.1",
            "Weight": 1
          }
        ],
        "KeepClientIP": true,
        "KeepClientIPMethod": "Proxy Protocol v1",
        "EndpointType": "public",
        "SourceIP": []
      }
    ],
    "PageNum": 1,
    "PageSize": 10,
    "TotalCount": 1
  }
}

错误码

本接口无专用错误码。公共错误码请参见公共错误码。

最近更新时间：2026.09.23 16:20:53

这个页面对您有帮助吗？

有用

无用

全球加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求说明

请求参数

Query

Body

返回参数

请求示例

返回示例

错误码