请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必填	示例值	描述
AcceleratorId	String	是	`accinstance-YfiSM6k5BspFcC4BaG****`	指定待查询加速器的 ID。可通过调用 `ListAccelerators` 接口获取当前账号下的加速器 ID。

返回参数

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

参数	类型	示例值	描述
AccelerateType	String	`domain`	加速器的接入方式。取值：不传或传空值：默认接入，客户端通过加速器的 CNAME 或 IP 接入。 `domain`：按加速域名接入。
Bandwidth	Integer	`160`	加速器的实际带宽上限，单位为 `Mb`。按量计费加速器，或未绑定带宽包的包年包月加速器，为与加速器规格匹配的带宽上限。绑定了带宽包的包年包月加速器，为带宽包的带宽规格。
BeginTime	Integer	`1717127658`	加速器开始生效、可对外提供加速服务的时间点，用 Unix 秒级时间戳表示。
ConnectionNum	Integer	`40000`	加速器可同时保持的最大并发连接数，由加速器规格决定。
CreateTimeStr	String	`2025-05-09T10:36:26Z`	加速器的创建时间，用字符串表示。
RegionNum	Integer	`1`	加速器规格决定的可添加加速区域数量上限。
IPSets	Object[]		加速器的加速区域列表，每个元素为一个加速区域及其网络配置。
ListenerIds	String[]	`["listener-kRcRXoTS4WccfHXVdv****"]`	加速器下所有监听器的 ID 列表。
AcceleratorId	String	`accinstance-YfiSM6k5BspFcC4BaG****`	加速器的 ID。
AccountID	String	`210005XXXX`	加速器所属账号的 ID。
Name	String	`accelerator-sh-hk`	加速器的名称。
State	String	`active`	加速器的状态。取值： `active`：运行中。 `inactive`：待配置。 `deploying`：配置中。 `overdue`：欠费中。 `expired`：已过期。
CNAME	String	`accelerator-cname-kaiinhy47zndzbruhnrjn5.c.example.com`	加速器的 CNAME，客户端可将业务域名 CNAME 解析到该地址接入加速。
ChargeType	String	`PREPAY`	加速器的计费方式。取值： `PREPAY`：预付费（包年包月）。 `POSTPAY`：后付费（按量计费）。
BillingType	String	`PayByTrafficMonthly`	按量计费加速器（`ChargeType` 为 `POSTPAY`）的具体计费类型。取值： `PayByTrafficDaily`：按日流量计费。 `PayByTrafficMonthly`：按月流量计费。 `PayByBandwidthMonthly`：按月 95 峰值带宽计费。包年包月加速器（`ChargeType` 为 `PREPAY`）该值始终为 `ByBandwidthPrePay`。
BillingSpec	String	`small`	加速器的规格，决定带宽上限、并发连接数、可添加加速区域数量等能力上限。取值： `small`：小型。 `middle`：中型。 `large`：大型。
BandwidthPackageIds	String[]	`["gbwp-RTw5UPU3k2n4mfDYsC****"]`	加速器已绑定的公网带宽包 ID 列表。
CrossDomainBandwidthIds	String[]	`["crb-6PYMjSLm9xrFuBJrpx****"]`	加速器已绑定的跨域带宽包 ID 列表。
RenewType	Integer	`0`	加速器的续费方式。取值： `0`：不涉及续费（适用于按量计费加速器）。 `1`：手动续费（适用于包年包月加速器）。 `2`：自动续费（适用于包年包月加速器）。
FullPortSwitch	Boolean	`false`	是否开启全端口模式。
RegionCount	Integer	`1`	加速器下已添加的加速区域数量。
ListenerCount	Integer	`10`	加速器下已创建的监听器数量。
CreateTime	Integer	`1717127658`	加速器的创建时间，用 Unix 秒级时间戳表示。
BillingSpecEffectiveTime	Integer	`1717127658`	加速器当前规格的计费生效时间，用 Unix 秒级时间戳表示。变更规格后，新规格从该时间点开始计费。
ExpiredTime	Integer	`1717127658`	加速器的过期时间，用 Unix 秒级时间戳表示。仅包年包月加速器（`ChargeType` 为 `PREPAY`）包含此字段。
ProjectName	String	`test-project`	加速器所属的项目。项目是火山引擎通用的资源管理工具，用于对账号下的云资源进行分组管理与权限隔离。
ResourceTags	Object[]		加速器已关联的资源标签列表，每个元素为一个键值对。

请求示例

POST https://ga.volcengine-api.com?Action=DescribeAccelerator&Version=2022-03-01
{
  "AcceleratorId": "accinstance-YfiSM6k5BspFcC4BaG****"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241017141322146108173218A0A93F",
    "Action": "DescribeAccelerator",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "IPSets": [
      {
        "IPVersion": "IPv4/IPv6",
        "IPSetId": "CN_South",
        "AccelerateRegion": "华南",
        "State": "active",
        "IspType": "Standard",
        "AcceleratorId": "accinstance-YfiSM6k5BspFcC4BaG****",
        "IPAddressList": {
          "IPV4s": [
            {
              "Addr": "203.0.113.1",
              "ISP": "ChinaUnicom",
              "ISPName": "联通"
            }
          ],
          "IPV6s": [
            {
              "Addr": "2001:db8::1",
              "ISP": "ChinaUnicom",
              "ISPName": "联通"
            }
          ]
        }
      }
    ],
    "AcceleratorId": "accinstance-YfiSM6k5BspFcC4BaG****",
    "AccountID": "210005XXXX",
    "Name": "test",
    "State": "active",
    "CNAME": "accelerator-cname-kaiinhy47zndzbruhnrjn5.c.example.com",
    "ChargeType": "POSTPAY",
    "BillingType": "PayByTrafficMonthly",
    "BillingSpec": "small",
    "BandwidthPackageIds": [
      "gbwp-RTw5UPU3k2n4mfDYsC****"
    ],
    "CrossDomainBandwidthIds": [
      "crb-6PYMjSLm9xrFuBJrpx****"
    ],
    "RenewType": 0,
    "FullPortSwitch": true,
    "RegionCount": 1,
    "ListenerCount": 10,
    "CreateTime": 1717127658,
    "BillingSpecEffectiveTime": 1717127658,
    "ExpiredTime": 1719719658,
    "ProjectName": "default",
    "ResourceTags": [
      {
        "Key": "mjuKe",
        "Value": "Tw7g9"
      }
    ]
  }
}

错误码

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

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

这个页面对您有帮助吗？

有用

无用

全球加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求说明

请求参数

Query

Body

返回参数

请求示例

返回示例

错误码