すべてのプロダクト
Search
ドキュメントセンター

Global Accelerator:CreateAccelerator

最終更新日:Jan 06, 2026

Global Accelerator (GA) は、世界中をカバーするネットワークアクセラレーションサービスです。Alibaba Cloud の高品質なボーダーゲートウェイプロトコル (BGP) 帯域幅とグローバル伝送ネットワークを利用して、近隣のロケーションからの低レイテンシーアクセスを提供します。これにより、レイテンシー、ジッター、パケット損失などのネットワーク問題がサービスの品質に与える影響を軽減します。GA は、世界中のユーザーに高可用性で高性能なネットワークアクセラレーションサービスを提供します。CreateAccelerator 操作を呼び出して、Global Accelerator インスタンスを作成できます。

操作説明

CreateAccelerator 操作は非同期です。リクエストを送信すると、システムは Global Accelerator インスタンス ID を返しますが、インスタンスはまだバックグラウンドで作成中です。DescribeAccelerator 操作を呼び出して、Global Accelerator インスタンスのステータスをクエリできます。

  • Global Accelerator インスタンスが init 状態の場合、インスタンスは作成中です。インスタンスに対してはクエリ操作のみ実行できます。

  • Global Accelerator インスタンスが active 状態の場合、インスタンスは作成済みです。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ga:CreateAccelerator

create

*Accelerator

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId deprecated

string

必須

GA インスタンスのリージョン ID。値を cn-hangzhou に設定します。

cn-hangzhou

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアントトークンです。

クライアントからパラメーター値を生成して、異なるリクエスト間で値が一意になるようにします。ClientToken パラメーターには、ASCII 文字のみを含めることができます。

説明

このパラメーターを指定しない場合、システムはリクエストの RequestIdClientToken として自動的に使用します。RequestId はリクエストごとに異なる場合があります。

123e4567****

Name

string

任意

GA インスタンスの名前。

名前は、長さが 1~128 文字で、先頭は英字である必要があります。数字、アンダースコア (_)、ハイフン (-) を使用できます。

test

Duration

integer

任意

サブスクリプション期間。

  • PricingCycleMonth に設定されている場合、Duration の有効な値は 19 です。

  • PricingCycleYear に設定されている場合、Duration の有効な値は 13 です。

説明

このパラメーターは、InstanceChargeType (GA インスタンスの課金方法) が PREPAY (サブスクリプション) に設定されている場合に必須です。

1

PricingCycle

string

任意

課金サイクル。有効値:

  • Month:月単位で課金されます。

  • Year:年単位で課金されます。

説明

このパラメーターは、InstanceChargeType (GA インスタンスの課金方法) が PREPAY (サブスクリプション) に設定されている場合に必須です。

Month

Spec

string

任意

GA インスタンスのインスタンスタイプ。有効値:

  • 1:Small I

  • 2:Small II

  • 3:Small III

  • 5:Medium I

  • 8:Medium II

  • 10:Medium III

  • 20:Large I

  • 30:Large II

  • 40:Large III

  • 50:Large IV

  • 60:Large V

  • 70:Large VI

  • 80:Large VII

  • 90:Large VIII

  • 100:Super Large I

  • 200:Super Large II

説明
  • 現在、Large III 以上のインスタンスタイプは、ホワイトリストに登録されているユーザーのみが利用できます。これらのインスタンスタイプを使用するには、アカウントマネージャーにご連絡ください。

  • このパラメーターは、InstanceChargeType (GA インスタンスの課金方法) が PREPAY (サブスクリプション) に設定されている場合に必須です。

インスタンスタイプごとに定義が異なります。詳細については、「インスタンスタイプ」をご参照ください。

1

AutoPay

boolean

任意

自動支払いを有効にするかどうかを指定します。有効値:

  • false (デフォルト):自動支払いを無効にします。注文が生成された後、注文センターに移動して支払いを完了する必要があります。

  • true:自動支払いを有効にします。システムが自動的に支払いを完了します。

false

AutoUseCoupon

string

任意

請求にクーポンを自動的に適用するかどうかを指定します。有効値:

  • true:はい。

  • false (デフォルト):いいえ。

説明

このパラメーターは、AutoPaytrue に設定されている場合にのみ有効です。

false

AutoRenew

boolean

任意

インスタンスの自動更新を有効にするかどうかを指定します。有効値:

  • true:はい。

  • false (デフォルト):いいえ。

false

AutoRenewDuration

integer

任意

自動更新期間。単位:月。

有効な値は 112 です。デフォルト値:1

説明

このパラメーターは、AutoRenewtrue に設定されている場合にのみ有効です。

1

PromotionOptionNo

string

任意

クーポンコード。

説明

このパラメーターは、Alibaba Cloud 国際サイト (www.alibabacloud.com) でのみ利用できます。

50003298014****

BandwidthBillingType

string

任意

帯域幅の課金方法。

  • BandwidthPackage:帯域幅プランで課金されます。

  • CDT:データ転送量で課金されます。

BandwidthPackage

IpSetConfig

object

任意

加速エリアの構成。

AccessMode

string

任意

加速エリアのアクセスモード。有効値:

  • UserDefine:カスタム近接アクセスモード。必要に応じて加速エリアとリージョンを選択します。Global Accelerator は、加速リージョンごとに個別の EIP (Elastic IP) アドレスを提供します。

  • Anycast:自動近接アクセスモード。加速エリアを設定する必要はありません。Global Accelerator は、複数のリージョンに対して 1 つの Anycast EIP を提供します。ユーザーは、Anycast EIP を使用して、Alibaba Cloud ネットワークの最寄りのアクセスポイントに接続します。

UserDefine

ResourceGroupId

string

任意

標準 GA インスタンスが属するリソースグループの ID。

rg-aekzrnd67gq****

Tag

array<object>

任意

GA インスタンスのタグ。

object

任意

GA インスタンスのタグ。

Key

string

任意

GA インスタンスのタグキー。タグキーは空の文字列にできません。

タグキーは最大 64 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

最大 20 個のタグキーを指定できます。

tag-key

Value

string

任意

GA インスタンスのタグ値。タグ値は空の文字列でもかまいません。

タグ値は最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

最大 20 個のタグ値を指定できます。

tag-value

InstanceChargeType

string

任意

GA インスタンスの課金方法。

  • PREPAY (デフォルト):サブスクリプション。

  • POSTPAY:従量課金。

PREPAY

DryRun

boolean

任意

ドライランを実行するかどうかを指定します。有効値:

  • true:ドライランを実行します。システムは、必須パラメーター、リクエストフォーマット、およびサービス制限を確認します。リクエストがドライランに失敗すると、エラーメッセージが返されます。リクエストがドライランに成功すると、DryRunOperation エラーコードが返されます。

  • false (デフォルト):通常のリクエストを送信します。リクエストがチェックに合格すると、2xx HTTP ステータスコードが返され、操作が実行されます。

false

Bandwidth

integer

任意

標準 GA インスタンスの帯域幅。単位:Mbps

有効な値:200~5000。

説明

このパラメーターは、加速エリアのアクセスモードが Anycast の場合にのみ必須で有効です。

200

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

RequestId

string

リクエスト ID。

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

OrderId

string

注文 ID。

Alibaba Cloud 国際サイトをご利用で、`AutoPay` が `false` に設定されている場合は、注文センターに移動して支払いを完了してください。

208257****

AcceleratorId

string

GA インスタンスの ID。

ga-bp17frjjh0udz4qz****

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

500 UnknownError An error occurred while processing your request. Please try again. If the error persists, please submit a ticket.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。