请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必填	示例值	描述
Name	String	否	`hk-web-instance01`	设置加速器的名称。允许使用中文、英文、数字以及点号（`.`）、下划线（`_`）和连字符（`-`）。长度为 `[2, 128]` 个字符。
ChargeType	String	否	`PREPAY`	指定加速器的计费方式。取值： `PREPAY`：预付费（包年包月）。 `POSTPAY`：后付费（按量计费）。
Bandwidth	Integer	否	`2`	同步购买公网带宽包时指定公网带宽包的带宽大小，单位为 Mbps，取值范围为 `[2, 10000]`。`WithBandwidthPackage` 为 `true` 时必填。
Autobound	Boolean	否	`true`	指定同步购买的公网带宽包是否自动绑定到基础型加速器。默认值为 `true`。
Duration	Integer	否	`1`	指定包年包月加速器的订阅时长，单位为月，取值范围为 `[1, 12]`。仅当 `ChargeType` 为 `PREPAY`（包年包月）时生效。
RenewType	Integer	否	`1`	指定加速器的续费方式。取值： `0`：不涉及续费（适用于按量计费加速器）。 `1`：手动续费（适用于包年包月加速器）。 `2`：自动续费（适用于包年包月加速器）。
BillingType	String	否	`PayByTrafficMonthly`	指定按量计费加速器的计费类型。当 `ChargeType` 为 `POSTPAY`（按量计费）时必填。取值： `PayByTrafficDaily`：按日流量计费。 `PayByTrafficMonthly`：按月流量计费。 `PayByBandwidthMonthly`：按月 95 峰值带宽计费。
BillingPeriod	Integer	否	`3`	指定按量计费加速器的结算周期。当 `ChargeType` 为 `POSTPAY`（按量计费）时必填。取值： `2`：日结。 `3`：月结。
WithBandwidthPackage	Boolean	否	`true`	指定是否在创建预付费加速器时同步购买公网带宽包。
BandwidthType	String	否	`WAN`	指定同步购买的公网带宽包类型。默认值为 `WAN`，表示公网带宽包；为空时按默认值处理。
ProjectName	String	否	`test-project`	指定加速器所属的项目。项目是火山引擎通用的资源管理工具，用于对账号下的云资源进行分组管理与权限隔离。若不指定，则归属默认项目 `default`。
ResourceTags	Object[]	否		为加速器设置自定义标签，每个标签为一个键值对。单个加速器最多可关联 10 个标签。

返回参数

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

参数	类型	示例值	描述
AcceleratorId	String	`accinstance-basic-UKBfMXboZLwxFGNkiR****`	新建加速器的 ID。
PreorderNumbers	String[]	`["Order20230604110420****"]`	创建包年包月加速器时返回的订单号列表。
BandwidthPackageId	String	`gbwp-RTw5UPU3k2n4mfDYsC****`	同步购买的公网带宽包 ID。

请求示例

POST https://ga.volcengine-api.com?Action=CreateBasicAccelerator&Version=2022-03-01
{
  "Name": "hk-web-instance01",
  "ChargeType": "PREPAY",
  "Bandwidth": 2,
  "Autobound": true,
  "Duration": 1,
  "RenewType": 1,
  "WithBandwidthPackage": true,
  "BandwidthType": "WAN",
  "ProjectName": "default",
  "ResourceTags": [
    {
      "Key": "cost-org",
      "Value": "global-srv-03"
    }
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202306041104201234100232280022D31",
    "Action": "CreateBasicAccelerator",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
    "PreorderNumbers": [
      "Order20230604110420****"
    ],
    "BandwidthPackageId": "gbwp-RTw5UPU3k2n4mfDYsC****"
  }
}

错误码

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

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

这个页面对您有帮助吗？

有用

无用

全球加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求说明

请求参数

Query

Body

返回参数

请求示例

返回示例

错误码