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

全球加速

复制全文
下载 pdf
基础型加速器-加速器接口
查询基础型加速器详情 DescribeBasicAccelerator
复制全文
下载 pdf
查询基础型加速器详情 DescribeBasicAccelerator

查询指定基础型加速器的详情信息,包括计费信息、加速区域、终端节点组以及关联带宽包等配置。

请求说明

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

请求参数

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

Query

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

Body

参数
类型
是否必填
示例值
描述
AcceleratorId
String
是
accinstance-basic-UKBfMXboZLwxFGNkiR****
待查询的加速器 ID。可通过调用 ListBasicAccelerators 接口获取账号下的加速器 ID。

返回参数

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

参数
类型
示例值
描述
AcceleratorId
String
accinstance-basic-UKBfMXboZLwxFGNkiR****
加速器 ID。
AccountID
String
210005XXXX
加速器所属账号的 ID。
AccountName
String
test-name
加速器所属火山引擎账号的名称。
BandwidthPackageIds
String[]
["gbwp-RTw5UPU3k2n4mfDYsC****"]
加速器已绑定的公网带宽包 ID 列表。
BandwidthPackageVolume
Integer
2
与该加速器绑定的带宽包带宽规格,单位为 Mb。
BeginTime
Integer
1717127708
计费生效时间,用 Unix 秒级时间戳表示。
BillingType
String
PayByTrafficMonthly
按量计费加速器的计费类型。取值:
  • PayByTrafficDaily:按日流量计费。
  • PayByTrafficMonthly:按月流量计费。
  • PayByBandwidthMonthly:按月 95 峰值带宽计费。

包年包月加速器(ChargeType 为 PREPAY)该值始终为 ByBandwidthPrePay。
ChargeType
String
PREPAY
加速器的计费方式。取值:
  • PREPAY:预付费(包年包月)。
  • POSTPAY:后付费(按量计费)。
CreateTime
Integer
1717127658
加速器的创建时间,用 Unix 秒级时间戳表示。
CreateTimeStr
String
2025-05-09T10:36:26Z
加速器的创建时间,用字符串表示。
CrossDomainBandwidthIds
String[]
["crb-6PYMjSLm9xrFuBJrpx****"]
加速器已绑定的跨域带宽包 ID 列表。
EndPointGroups
Object[]
该加速器关联的终端节点组列表。
ExpiredTime
Integer
1717127658
包年包月加速器的过期时间,用 Unix 秒级时间戳表示。仅当 ChargeType 为 PREPAY 时返回该字段。
IPSets
Object[]
该加速器关联的加速区域列表。
Mode
String
Standard
加速 IP 的绑定模式。一个基础型加速器只允许使用一种模式。取值:
  • All-Port:全端口模式。
  • Standard:标准模式。
  • Shared:共享模式。
Name
String
test-name
加速器名称。
ProjectName
String
test-project
加速器所属的项目。项目是火山引擎通用的资源管理工具,用于对账号下的云资源进行分组管理与权限隔离。
RenewType
Integer
0
加速器的续费方式。取值:
  • 0:不涉及续费(适用于按量计费加速器)。
  • 1:手动续费(适用于包年包月加速器)。
  • 2:自动续费(适用于包年包月加速器)。
State
String
Active
基础型加速器的状态。取值:
  • Active:运行中。
  • Inactive:待配置。
  • Deploying:配置中。
  • Overdue:欠费中。
  • Expired:已过期。

请求示例

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

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241113152305075121049019EE6E86",
    "Action": "DescribeBasicAccelerator",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
    "AccountID": "210005XXXX",
    "AccountName": "test-name",
    "BandwidthPackageIds": [
      "gbwp-RTw5UPU3k2n4mfDYsC****"
    ],
    "BandwidthPackageVolume": 2,
    "BeginTime": 1717127708,
    "BillingType": "PayByTrafficMonthly",
    "ChargeType": "POSTPAY",
    "CreateTime": 1717127658,
    "CreateTimeStr": "2025-05-09T10:36:26Z",
    "CrossDomainBandwidthIds": [
      "crb-6PYMjSLm9xrFuBJrpx****"
    ],
    "EndPointGroups": [
      {
        "EndPointGroupId": "endpointgroup-basic-e8QPGGCbk2fr32Dd3y****",
        "Region": "CN_North"
      }
    ],
    "IPSets": [
      {
        "IPSetId": "ipset-basic-YFsv8EcxWd8gHLrEvf****",
        "Region": "CN_North"
      }
    ],
    "Mode": "Standard",
    "Name": "test-name",
    "ProjectName": "test-project",
    "RenewType": 0,
    "State": "Active"
  }
}

错误码

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

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