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

Global Accelerator:AttachDdosToAccelerator

最終更新日:Jun 30, 2026

Global Accelerator(GA)アプリケーションを large スケールの DDoS 攻撃から保護し、サービスの安定性と可用性を確保するために、AttachDdosToAccelerator 操作を呼び出して Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスを GA インスタンスに関連付けることができます。

操作説明

この操作を呼び出す際には、以下の点に注意してください:

  • AttachDdosToAccelerator は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返しますが、Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスはまだ Global Accelerator(GA)インスタンスに関連付けられていません。関連付けタスクはバックグラウンドで実行を続けます。 DescribeAccelerator または ListAccelerators を呼び出して GA インスタンスのステータスを照会できます:
    • GA インスタンスが configuring 状態の場合、Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスは GA インスタンスに関連付け中です。この状態では、クエリ操作のみ実行できます。

    • GA インスタンスが active 状態の場合、Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスは GA インスタンスに関連付けられています。

  • AttachDdosToAccelerator 操作は、同じ GA インスタンスに Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスを関連付ける同時リクエストをサポートしていません。

今すぐお試しください

この 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:AttachDdosToAccelerator

update

*Accelerator

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

AcceleratorId

string

必須

Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスを関連付ける Global Accelerator(GA)インスタンスの ID。

ga-bp1odcab8tmno0hdq****

DdosId deprecated

string

任意

Global Accelerator(GA)インスタンスに関連付ける Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスの ID。

ddoscoo-cn-zz11vq7j****

DdosRegionId deprecated

string

任意

Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスのリージョン。有効な値:

  • cn-hangzhou: 中国本土。

  • ap-southeast-1: 中国本土以外。

cn-hangzhou

RegionId

string

任意

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

cn-hangzhou

DdosConfigList

array<object>

任意

Global Accelerator(GA)インスタンスに関連付ける Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスのリスト。

object

任意

Global Accelerator(GA)インスタンスに関連付ける Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスのリスト。

DdosRegionId

string

任意

Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスのリージョン。有効な値:

  • cn-hangzhou: 中国本土。

  • ap-southeast-1: 中国本土以外。

cn-hangzhou

DdosId

string

任意

Global Accelerator(GA)インスタンスに関連付ける Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスの ID。

ddoscoo-cn-zz11vq7j****

DryRun

boolean

任意

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

  • true: 実際にインスタンスを関連付けずにドライランを実行します。システムは必須パラメーター、リクエスト構文、およびビジネス制限を確認します。確認に失敗した場合、対応するエラーが返されます。確認に成功した場合、HTTP 2xx 状態コードが返されます。

  • false(デフォルト): リクエストを送信します。リクエストが確認に合格した後、HTTP 2xx 状態コードが返され、操作が実行されます。

true

レスポンスフィールド

フィールド

説明

object

レスポンス構造体。

DdosId deprecated

string

Global Accelerator(GA)インスタンスに関連付けられた Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスの ID。

ddoscoo-cn-zz11vq7j****

RequestId

string

リクエスト ID。

DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6

GaId

string

Anti-DDoS 攻撃プロ版または Anti-DDoS 攻撃 Premium インスタンスが関連付けられた Global Accelerator(GA)インスタンスの ID。

ga-bp1odcab8tmno0hdq****

成功レスポンス

JSONJSON

{
  "DdosId": "ddoscoo-cn-zz11vq7j****",
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "GaId": "ga-bp1odcab8tmno0hdq****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 DdosId.Error Failed to find the DDoS instance based on the DDoS ID.
400 NoPermission.GaDdosRoleSession You are not authorized to perform the operation.

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

変更履歴

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