调用CreateBasicAccelerator接口创建一个基础型全球加速实例。

使用说明

基础型全球加速实例依托阿里云优质的全球互联网带宽与高品质传输网络,为用户提供点到点的加速体验。基础型全球加速实例主要用于三层(IP协议)网络加速。更多信息,请参见全球加速实例概述

CreateBasicAccelerator接口属于异步接口,即系统会先返回一个基础型全球加速实例ID,但基础型全球加速实例并未创建完成,系统后台的创建任务仍在进行。您可以调用GetBasicAcceleratorListBasicAccelerators查询基础型全球加速实例的状态:

  • 当基础型全球加速实例处于init状态时,表示基础型全球加速实例正在创建中,在该状态下,您只能执行查询操作,不能执行其他操作。
  • 当基础型全球加速实例处于active状态时,表示基础型全球加速实例创建完成。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateBasicAccelerator

系统规定参数。取值:CreateBasicAccelerator

RegionId String cn-hangzhou

基础型全球加速实例所属的地域ID,仅取值:cn-hangzhou

ClientToken String 123e4567****

客户端Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
Duration Integer 1

购买时长。

  • PricingCycle取值Month时,Duration取值范围为1~9
  • PricingCycle取值Year时,Duration取值范围为1~3
PricingCycle String Month

计费周期。取值:

  • Month:按月计费。
  • Year:按年计费。
BandwidthBillingType String CDT

带宽计费方式。取值:

  • BandwidthPackage:按带宽包计费。
  • CDT:按流量计费。
AutoPay Boolean false

是否自动付费,取值:

  • false(默认值):不开启自动付费,生成订单后需要到订单中心完成支付。
  • true:开启自动付费,自动支付订单。
AutoUseCoupon String false

是否使用优惠券自动支付账单。取值:

  • true:使用。
  • false(默认值):不使用。
说明AutoPaytrue时,该项才生效。
AutoRenew Boolean false

是否开启自动续费。

  • true:是。
  • false(默认值):否。
AutoRenewDuration Integer 1

自动续费时长。单位:月。

取值范围:1~12。默认值:1

说明AutoRenew的为true时,该项才生效。

返回数据

名称 类型 示例值 描述
RequestId String F591955F-5CB5-4CCE-A75D-17CF2085CE22

请求ID。

OrderId String 2082574365

订单ID。

AcceleratorId String ga-bp17frjjh0udz4qz****

基础型全球加速实例ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateBasicAccelerator
&RegionId=cn-hangzhou
&ClientToken=123e4567****
&Duration=1
&PricingCycle=Month
&BandwidthBillingType=CDT
&AutoPay=false
&AutoUseCoupon=false
&AutoRenew=false
&AutoRenewDuration=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateBasicAcceleratorResponse>
    <RequestId>F591955F-5CB5-4CCE-A75D-17CF2085CE22</RequestId>
    <OrderId>2082574365</OrderId>
    <AcceleratorId>ga-bp17frjjh0udz4qz****</AcceleratorId>
</CreateBasicAcceleratorResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F591955F-5CB5-4CCE-A75D-17CF2085CE22",
  "OrderId" : "2082574365",
  "AcceleratorId" : "ga-bp17frjjh0udz4qz****"
}

错误码

访问错误中心查看更多错误码。