调用CreateAccelerator创建一个全球加速实例_全球加速(GA)-阿里云帮助中心

全球加速 GA（Global Accelerator）是一款覆盖全球的网络加速服务，依托阿里云优质BGP带宽和全球传输网络，实现全球网络就近接入，可以减少延迟、抖动、丢包等网络问题对服务质量的影响，为全球用户提供高可用和高性能的网络加速服务，您可以通过调用CreateAccelerator接口创建一个全球加速实例。

接口说明

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

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ga:CreateAccelerator

create

*Accelerator

acs:ga:{#regionId}:{#accountId}:ga/*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	全球加速实例所属的地域 ID，仅取值：cn-hangzhou。	cn-hangzhou
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	123e4567****
Name	string	否	全球加速实例的名称。名称长度为 1~128 个字符，以大小写字母或中文开头，可包含数字、下划线（_）或短划线（-）。	test
Duration	integer	否	购买时长。当 PricingCycle 取值 Month 时，Duration 取值范围为 1~9。当 PricingCycle 取值 Year 时，Duration 取值范围为 1~3。说明 InstanceChargeType（全球加速实例计费方式）为 PREPAY（预付费）时，该项必须配置。	1
PricingCycle	string	否	计费周期。取值： Month：按月计费。 Year：按年计费。说明 InstanceChargeType（全球加速实例计费方式）为 PREPAY（预付费）时，该项必须配置。	Month
Spec	string	否	全球加速实例的规格，取值： 1：小型Ⅰ。 2：小型Ⅱ。 3：小型Ⅲ。 5：中型Ⅰ。 8：中型Ⅱ。 10：中型Ⅲ。 20：大型Ⅰ。 30：大型Ⅱ。 40：大型Ⅲ。 50：大型 IV。 60：大型 V。 70：大型 VI。 80：大型 VII。 90：大型 VIII。 100：超大型Ⅰ。 200：超大型Ⅱ。说明目前，大型Ⅲ及以上规格仅白名单开放。如需使用，请联系阿里云客户经理。 InstanceChargeType（全球加速实例计费方式）为 PREPAY（预付费）时，该项必须配置。实例规格不同，定义也不同。更多信息，请参见实例规格。	1
AutoPay	boolean	否	是否自动付费，取值： false（默认值）：不开启自动付费，生成订单后需要到订单中心完成支付。 true：开启自动付费，自动支付订单。	false
AutoUseCoupon	string	否	是否使用优惠券自动支付账单。取值： true：使用。 false（默认值）：不使用。说明仅 AutoPay 为 true 时，该项才生效。	false
AutoRenew	boolean	否	是否开启自动续费。取值： true：是。 false（默认值）：否。	false
AutoRenewDuration	integer	否	自动续费时长。单位：月。取值范围：1~12。默认值：1。说明仅 AutoRenew 为 true 时，该项才生效。	1
PromotionOptionNo	string	否	优惠券号码。说明仅国际站涉及该参数。	50003298014****
BandwidthBillingType	string	否	带宽计费方式。 BandwidthPackage：按带宽包计费。 CDT：按流量计费。	BandwidthPackage
IpSetConfig	object	否	加速区域配置。
AccessMode	string	否	加速区域接入模式。取值： UserDefine：自定义就近接入模式。您可以根据业务需要，定向选择加速区域和地域，全球加速为每个加速地域提供独立的 EIP。 Anycast：采用自动就近接入模式。您无需配置加速区域。全球加速在全球多地域提供一个 Anycast EIP，用户可通过 Anycast EIP 从就近接入点进入阿里云加速网络。	UserDefine
ResourceGroupId	string	否	标准型全球加速实例所属资源组 ID。	rg-aekzrnd67gq****
Tag	array<object>	否	全球加速实例的标签。
	object	否	全球加速实例的标签。
Key	string	否	全球加速实例的标签键。一旦输入该值，则不允许为空字符串。最多支持 64 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。最多支持输入 20 个标签键。	tag-key
Value	string	否	全球加速实例的标签值。一旦输入该值，可以为空字符串。最多支持 128 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。最多支持输入 20 个标签值。	tag-value
InstanceChargeType	string	否	全球加速实例付费类型。 PREPAY（默认值）：预付费。 POSTPAY：后付费。	PREPAY
DryRun	boolean	否	是否只预检此次请求，取值： true：发送检查请求，不会创建资源。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	false
Bandwidth	integer	否	标准型全球加速实例带宽。单位：Mbps。取值范围：200~5000。说明仅加速区域接入模式为 Anycast 时有效，且必填。	200

返回参数

名称	类型	描述	示例值
	object	返回信息列表。
RequestId	string	请求 ID。	F591955F-5CB5-4CCE-A75D-17CF2085CE22
OrderId	string	订单 ID。当 InstanceChargeType（付费类型）取值为 PREPAY（预付费）时，返回该参数。如果 AutoPay 取值为 false，即未开启自动支付账单时，请前往订单中心完成支付。	208257****
AcceleratorId	string	全球加速实例 ID。	ga-bp17frjjh0udz4qz****

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
500	UnknownError	An error occurred while processing your request. Please try again. If the error persists, please submit a ticket.	处理请求时出现错误，请稍后重试。

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

变更历史

更多信息，参考变更详情。