全部產品
Search

搜尋本產品

    Global Accelerator：CreateAccelerator - 建立一個Global Acceleration執行個體

    文件中心

    Global Accelerator：CreateAccelerator - 建立一個Global Acceleration執行個體

    更新時間：Jan 06, 2026

    Global Acceleration GA（Global Accelerator）是一款覆蓋全球的網路加速服務，依託阿里雲優質BGP頻寬和全球傳輸網路，實現全球網路就近接入，可以減少延遲、抖動、丟包等網路問題對服務品質的影響，為全球使用者提供高可用和高效能的網路加速服務，您可以通過調用CreateAccelerator介面建立一個Global Acceleration執行個體。

    介面說明

    CreateAccelerator 介面屬於非同步介面，即系統會先返回一個Global Acceleration執行個體 ID，但該Global Acceleration執行個體尚未建立成功，系統背景建立任務仍在進行。您可以調用 DescribeAccelerator 查詢Global Acceleration執行個體的狀態：

    • 當Global Acceleration執行個體處於 init 狀態時，表示Global Acceleration執行個體正在建立中，在該狀態下，您只能執行查詢操作，不能執行其他動作。

    • 當Global Acceleration執行個體處於 active 狀態時，表示Global Acceleration執行個體建立完成。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ga:CreateAccelerator

    create

    *Accelerator

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId deprecated

    string

    是

    Global Acceleration執行個體所屬的地區 ID，僅取值：cn-hangzhou。

    cn-hangzhou
    ClientToken

    string

    否

    用戶端 Token，用於保證請求的等冪性。

    從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

    說明

    若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

    123e4567****
    Name

    string

    否

    Global Acceleration執行個體的名稱。

    名稱長度為 1~128 個字元，以大小寫字母或中文開頭，可包含數字、底線（_）或短劃線（-）。

    test
    Duration

    integer

    否

    購買時間長度。

    • 當 PricingCycle 取值 Month 時，Duration 取值範圍為 1~9。

    • 當 PricingCycle 取值 Year 時，Duration 取值範圍為 1~3。

    說明

    InstanceChargeType（Global Acceleration執行個體計費方式）為 PREPAY（預付費）時，該項必須配置。

    1
    PricingCycle

    string

    否

    計費周期。取值：

    • Month：按月計費。

    • Year：按年計費。

    說明

    InstanceChargeType（Global Acceleration執行個體計費方式）為 PREPAY（預付費）時，該項必須配置。

    Month
    Spec

    string

    否

    Global Acceleration執行個體的規格，取值：

    • 1：小型Ⅰ。

    • 2：小型Ⅱ。

    • 3：小型Ⅲ。

    • 5：中型Ⅰ。

    • 8：中型Ⅱ。

    • 10：中型Ⅲ。

    • 20：大型Ⅰ。

    • 30：大型Ⅱ。

    • 40：大型Ⅲ。

    • 50：大型 IV。

    • 60：大型 V。

    • 70：大型 VI。

    • 80：大型 VII。

    • 90：大型 VIII。

    • 100：超大型Ⅰ。

    • 200：超大型Ⅱ。

    說明

    • 目前，大型Ⅲ及以上規格僅白名單開放。如需使用，請聯絡阿里雲客戶經理。

    • InstanceChargeType（Global Acceleration執行個體計費方式）為 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：自訂就近接入模式。您可以根據業務需要，定向選擇加速地區和地區，Global Acceleration為每個加速地區提供獨立的 EIP。

    • Anycast：採用自動就近接入模式。您無需配置加速地區。Global Acceleration在全球多地區提供一個 Anycast EIP，使用者可通過 Anycast EIP 從就近存取點進入阿里雲加速網路。

    UserDefine
    ResourceGroupId

    string

    否

    標準型Global Acceleration執行個體所屬資源群組 ID。

    rg-aekzrnd67gq****
    Tag

    array<object>

    否

    Global Acceleration執行個體的標籤。

    object

    否

    Global Acceleration執行個體的標籤。

    Key

    string

    否

    Global Acceleration執行個體的標籤鍵。一旦輸入該值，則不允許為空白字串。

    最多支援 64 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

    最多支援輸入 20 個標籤鍵。

    tag-key
    Value

    string

    否

    Global Acceleration執行個體的標籤值。一旦輸入該值，可以為空白字串。

    最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

    最多支援輸入 20 個標籤值。

    tag-value
    InstanceChargeType

    string

    否

    Global Acceleration執行個體付費類型。

    • PREPAY（預設值）：預付費。

    • POSTPAY： 後付費。

    PREPAY
    DryRun

    boolean

    否

    是否只預檢此次請求，取值：

    • true：發送檢查請求，不會建立資源。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼DryRunOperation。

    • false（預設值）：發送正常請求，通過檢查後返回 HTTP 2xx 狀態代碼並直接進行操作。

    false
    Bandwidth

    integer

    否

    標準型Global Acceleration執行個體頻寬。單位：Mbps。

    取值範圍：200~5000。

    說明

    僅加速地區接入模式為 Anycast 時有效，且必填。

    200

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資訊列表。

    RequestId

    string

    請求 ID。

    F591955F-5CB5-4CCE-A75D-17CF2085CE22
    OrderId

    string

    訂單 ID。

    當 InstanceChargeType（付費類型）取值為 PREPAY（預付費）時，返回該參數。如果 AutoPay 取值為 false，即未開啟自動支付賬單時，請前往訂單中心完成支付。

    208257****
    AcceleratorId

    string

    Global Acceleration執行個體 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. 處理請求時出現錯誤，請稍後重試。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。