请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必填	示例值	描述
AcceleratorId	String	是	`accinstance-basic-UKBfMXboZLwxFGNkiR****`	指定要查询的加速器 ID。
State	String	否	`Active`	按基础型加速器状态筛选。取值： `Active`：运行中。 `Inactive`：待配置。 `Deploying`：配置中。 `Overdue`：欠费中。 `Expired`：已过期。
Name	String	否	`test-hk-layer3`	按基础型加速器名称精确匹配筛选。
ChargeType	String	是	`PREPAY`	按加速器的计费方式筛选。取值： `PREPAY`：预付费（包年包月）。 `POSTPAY`：后付费（按量计费）。
PageSize	Integer	否	`10`	分页查询时每页返回的最大条目数。默认值为 `10`，最大值为 `100`。
PageNum	Integer	否	`1`	分页查询的页码。默认值为 `1`。
IPSetRegion	String	是	`CN_South`	按加速区域筛选。取值： `CN_South`：华南。 `AP1`：亚太 1。仅对申请该功能的客户开放： `CN_North`：华北。 `CN_East`：华东。 `CN_NorthEast`：东北。 `CN_Central`：华中。 `CN_NorthWest`：西北。 `CN_SouthWest`：西南。
EndPointGroupRegion	String	是	`CN_South`	按终端节点组区域筛选。取值： `CN_North`：华北。 `CN_East`：华东。 `CN_South`：华南。 `CN_NorthEast`：东北。 `CN_Central`：华中。 `CN_NorthWest`：西北。 `CN_SouthWest`：西南。 `AP1`：亚太 1。
ProjectName	String	否	`test-project`	按所属项目筛选。仅返回该项目下的基础型加速器。项目是火山引擎通用的资源管理工具，用于对账号下的云资源进行分组管理与权限隔离。
ResourceTagFilter	Object	否		按资源标签筛选基础型加速器。通过 `FilterType` 指定多个标签的组合逻辑，通过 `ResourceTags` 指定用于筛选的标签集合。

返回参数

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

参数	类型	示例值	描述
Accelerators	Object[]		符合筛选条件的基础型加速器列表，每个元素为一个基础型加速器的详细信息。
TotalCount	Integer	`20`	符合筛选条件的基础型加速器总数。
PageNum	Integer	`1`	本次返回结果的页码。
PageSize	Integer	`10`	本次返回的每页条目数。

请求示例

POST https://ga.volcengine-api.com?Action=ListBasicAccelerators&Version=2022-03-01
{
  "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
  "State": "Active",
  "Name": "test-name",
  "ChargeType": "PREPAY",
  "PageSize": 10,
  "PageNum": 1,
  "IPSetRegion": "CN_South",
  "EndPointGroupRegion": "CN_South"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2024111315291005307120222920FC9B",
    "Action": "ListBasicAccelerators",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "Accelerators": [
      {
        "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
        "Name": "test-name",
        "Mode": "Standard",
        "State": "Active",
        "BillingType": "PayByBandwidthMonthly",
        "RenewType": 0,
        "ChargeType": "PREPAY",
        "AccountID": "210005XXXX",
        "ProjectName": "test-project",
        "BeginTime": 1717127708,
        "AccountName": "test-name",
        "BandwidthPackageVolume": 2,
        "IPSets": [
          {
            "IPSetId": "ipset-basic-YFsv8EcxWd8gHLrEvf****",
            "Region": "CN_South"
          }
        ],
        "BandwidthPackageIds": [
          "gbwp-RTw5UPU3k2n4mfDYsC****"
        ],
        "CrossDomainBandwidthIds": [
          "crb-6PYMjSLm9xrFuBJrpx****"
        ],
        "EndPointGroups": [
          {
            "EndPointGroupId": "endpointgroup-basic-e8QPGGCbk2fr32Dd3y****",
            "Region": "CN_South"
          }
        ],
        "CreateTime": 1717127708,
        "ResourceTags": [
          {
            "Key": "organization",
            "Value": "user-dept-1"
          }
        ]
      }
    ],
    "TotalCount": 1,
    "PageNum": 1,
    "PageSize": 10
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码。

状态码	错误码	错误信息	说明
400	GAInnerError	内部错误, 请重试。	服务内部错误，请稍后重试。

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

这个页面对您有帮助吗？

有用

无用

全球加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求说明

请求参数

Query

Body

返回参数

请求示例

返回示例

错误码