调用CreateAccelerator接口创建一个全球加速实例。

使用说明

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

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

调试

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

请求参数

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

系统规定参数。取值:CreateAccelerator

RegionId String cn-hangzhou

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

ClientToken String 123e4567****

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

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

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

全球加速实例的名称。

名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、下划线(_)或短划线(-)。

Duration Integer 1

购买时长。

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

计费周期。取值:

  • Month:按月计费。
  • Year:按年计费。
Spec String 1

全球加速实例的规格,取值:

  • 1:小型Ⅰ。
  • 2:小型Ⅱ。
  • 3:小型Ⅲ。
  • 5:中型Ⅰ。
  • 8:中型Ⅱ。
  • 10:中型Ⅲ。
  • 20:大型Ⅰ。
  • 30:大型Ⅱ。
  • 40:大型Ⅲ。
  • 50:大型IV。
  • 60:大型V。
  • 70:大型VI。
  • 80:大型VII。
  • 90:大型VIII。
  • 100:超大型Ⅰ。
  • 200:超大型Ⅱ。
  • 300:超大型ⅡI。
说明 目前,大型Ⅲ及以上规格仅白名单开放。如需使用,请提交工单

实例规格不同,定义也不同。更多信息,请参见实例规格

AutoPay Boolean false

是否自动付费,取值:

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

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

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

是否开启自动续费。取值:

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

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

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

说明AutoRenewtrue时,该项才生效。
IpSetConfig Object

加速区域配置。

AccessMode String UserDefine

加速区域接入模式。取值:

  • UserDefine:自定义就近接入模式。您可以根据业务需要,定向选择加速区域和地域,全球加速为每个加速地域提供独立的EIP。
  • Anycast:采用自动就近接入模式。您无需配置加速区域。全球加速在全球多地域提供一个Anycast EIP,用户可通过Anycast EIP从就近接入点进入阿里云加速网络。

返回数据

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

请求ID。

OrderId String 208257****

订单ID。

如果您未自动支付账单,请您前往订单中心完成支付。

AcceleratorId String ga-bp17frjjh0udz4qz****

全球加速实例ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateAccelerator
&RegionId=cn-hangzhou
&ClientToken=123e4567****
&Name=test
&Duration=1
&PricingCycle=Month
&Spec=1
&AutoPay=false
&AutoUseCoupon=false
&AutoRenew=false
&AutoRenewDuration=1
&IpSetConfig={"AccessMode":"UserDefine"}
&公共请求参数

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

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