文档中心

全球加速

标准型加速器-加速器接口

创建标准型加速器 CreateAccelerator

创建指定计费方式、规格和接入方式的标准型加速器，并返回加速器 ID；创建包年包月加速器时还会返回订单号列表。创建后还需配置公网带宽、监听器、终端节点和加速区域，形成可用的流量转发路径。

请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必填	示例值	描述
Name	String	否	`hk-web-instance01`	设置加速器的名称。允许使用中文、英文、数字以及点号（`.`）、下划线（`_`）和连字符（`-`）。长度为 `[2, 128]` 个字符。
ChargeType	String	是	`PREPAY`	指定加速器的计费方式。取值： `PREPAY`：预付费（包年包月）。 `POSTPAY`：后付费（按量计费）。
AccelerateType	String	否	`domain`	指定加速器的接入方式。取值：不传或传空值：默认接入，客户端通过加速器的 CNAME 或 IP 接入。 `domain`：按加速域名接入。
BillingSpec	String	是	`small`	指定加速器的规格。取值： `small`：小型。 `middle`：中型。 `large`：大型。
BillingType	String	否	`PayByTrafficMonthly`	指定按量计费加速器的计费类型。当 `ChargeType` 为 `POSTPAY`（按量计费）时必填。取值： `PayByTrafficDaily`：按日流量计费。 `PayByTrafficMonthly`：按月流量计费。 `PayByBandwidthMonthly`：按月 95 峰值带宽计费。
FullPortSwitch	Boolean	否	`false`	指定是否开启全端口模式。
RenewType	Integer	否	`1`	指定加速器的续费方式。取值： `0`：不涉及续费（适用于按量计费加速器）。 `1`：手动续费（适用于包年包月加速器）。 `2`：自动续费（适用于包年包月加速器）。
Duration	Integer	否	`1`	指定包年包月加速器的订阅时长，单位为月，取值范围为 `[1, 12]`。仅当 `ChargeType` 为 `PREPAY`（包年包月）时生效。
BillingPeriod	Integer	否	`3`	指定按量计费加速器的结算周期。当 `ChargeType` 为 `POSTPAY`（按量计费）时必填。取值： `2`：日结。 `3`：月结。
ProjectName	String	否	`test-project`	指定加速器所属的项目。项目是火山引擎通用的资源管理工具，用于对账号下的云资源进行分组管理与权限隔离。若不指定，则归属默认项目 `default`。
ResourceTags	Object[]	否		为加速器设置自定义标签，每个标签为一个键值对。单个加速器最多可关联 10 个标签。

返回参数

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

参数	类型	示例值	描述
AcceleratorId	String	`accinstance-YfiSM6k5BspFcC4BaG****`	新建加速器的 ID。
PreorderNumbers	String[]	`["Order20230604110420****"]`	本次创建包年包月加速器生成的订单号列表。

请求示例

POST https://ga.volcengine-api.com?Action=CreateAccelerator&Version=2022-03-01
{
  "Name": "hk-web-instance01",
  "ChargeType": "PREPAY",
  "BillingSpec": "small",
  "FullPortSwitch": false,
  "RenewType": 1,
  "Duration": 1,
  "ProjectName": "default",
  "ResourceTags": [
    {
      "Key": "cost-org",
      "Value": "global-srv-03"
    }
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202506201147328A917425C1D7B01E53B5",
    "Action": "CreateAccelerator",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "AcceleratorId": "accinstance-YfiSM6k5BspFcC4BaG****",
    "PreorderNumbers": [
      "Order20230604110420****"
    ]
  }
}

错误码

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

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

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

这个页面对您有帮助吗？

有用

无用

全球加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #