You need to enable JavaScript to run this app.
文档中心
全球加速

全球加速

复制全文
下载 pdf
基础型加速器-终端节点组和终端节点接口
查询基础型加速器终端节点列表 ListBasicEndpoints
复制全文
下载 pdf
查询基础型加速器终端节点列表 ListBasicEndpoints

分页查询指定基础型加速器终端节点组下的终端节点,返回终端节点的类型、地址及其绑定的加速 IP 信息。

请求说明

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

请求参数

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

Query

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

Body

参数
类型
是否必填
示例值
描述
AcceleratorId
String
是
accinstance-basic-UKBfMXboZLwxFGNkiR****
指定要查询的加速器 ID。
EndpointGroupId
String
是
endpointgroup-basic-e8QPGGCbk2fr32Dd3y****
指定要查询的终端节点组 ID。
PageSize
Integer
否
10
分页查询时每页返回的最大条目数。默认值为 10,最大值为 100。
PageNum
Integer
否
1
分页查询的页码。默认值为 1。

返回参数

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

参数
类型
示例值
描述
Endpoints
Object[]
终端节点列表。每个元素为一个终端节点的详情。
TotalCount
Integer
20
符合查询条件的终端节点总数。
PageSize
Integer
10
本次响应的每页条目数。
PageNum
Integer
1
本次返回结果的页码。

请求示例

POST https://ga.volcengine-api.com?Action=ListBasicEndpoints&Version=2022-03-01
{
  "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
  "EndpointGroupId": "endpointgroup-basic-e8QPGGCbk2fr32Dd3y****"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250609153351B9F56DE416CE44D7D7A7",
    "Action": "ListBasicEndpoints",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "Endpoints": [
      {
        "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
        "EndpointGroupId": "endpointgroup-basic-e8QPGGCbk2fr32Dd3y****",
        "EdgeNode": "bdcdn-szmp04",
        "EdgeNodeAlias": "示例01",
        "EndpointAddress": "veen411120122491xxxxxxxxxxxx",
        "EndpointId": "endpoint-basic-3mN8qZr6TyLpKxVdHs****",
        "Type": "ECS",
        "AccelerateIPs": []
      },
      {
        "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
        "EndpointGroupId": "endpointgroup-basic-e8QPGGCbk2fr32Dd3y****",
        "EdgeNode": "bdcdn-gdguangzhou-mp01",
        "EdgeNodeAlias": "示例02",
        "EndpointAddress": "veen150012501042xxxxxxxxxxxx",
        "EndpointId": "endpoint-basic-NhQyqd6KKsBWpcC5AE****",
        "Type": "ECS",
        "AccelerateIPs": [
          {
            "AccelerateIP": "198.51.100.1",
            "AccelerateIPId": "ip-basic-f4azPvEXZwZJsXrirm****",
            "ISP": "BGP",
            "State": "active"
          }
        ]
      }
    ],
    "TotalCount": 2,
    "PageSize": 10,
    "PageNum": 1
  }
}

错误码

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

最近更新时间:2026.09.23 16:20:54
这个页面对您有帮助吗?
有用
有用
无用
无用