すべてのプロダクト
Search

このプロダクト

    Global Accelerator:CreateCustomRoutingEndpointGroupDestinations

    ドキュメントセンター

    Global Accelerator:CreateCustomRoutingEndpointGroupDestinations

    最終更新日:Jun 30, 2026

    CreateCustomRoutingEndpointGroupDestinations 操作を呼び出して、カスタムルートリスナーに関連付けられたエンドポイントグループのマッピング構成を作成します。

    操作説明

    Alibaba Cloud Global Accelerator (GA) インスタンスは、構成されたリスナーポート範囲、送信先エンドポイントグループのマッピング構成（プロトコルとポート範囲）、およびエンドポイント（vSwitch）の IP アドレス情報に基づいてポートマッピングテーブルを生成できます。これにより、vSwitch 内の特定の IP アドレスとポートへのトラフィックの決定的ルートが可能になります。

    この操作は、カスタムルートリスナーに関連付けられたエンドポイントグループのマッピング構成を作成します。この操作を呼び出す際は、以下の項目に注意してください:

    • CreateCustomRoutingEndpointGroupDestinations は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返しますが、エンドポイントグループのマッピング構成はまだ作成されていません。作成ノードはバックグラウンドで実行を続けます。 DescribeCustomRoutingEndpointGroup 操作を呼び出して、エンドポイントグループのステータスを照会し、マッピング構成が作成されたかどうかを確認できます:

      • エンドポイントグループが updating 状態の場合、マッピング構成は作成中です。この状態では、クエリ操作のみ実行できます。

      • エンドポイントグループがアクティブな状態の場合、マッピング構成は作成されています。

    • CreateCustomRoutingEndpointGroupDestinations は、同じ Alibaba Cloud Global Accelerator (GA) インスタンス内のカスタムルートリスナーに関連付けられたエンドポイントグループのマッピング構成の同時作成をサポートしていません。

    始める前に

    カスタムルートリスナーに関連付けられたエンドポイントグループのマッピング構成を作成する前に、以下の操作が完了していることを確認してください:

    • 標準 Alibaba Cloud Global Accelerator (GA) インスタンスが作成されていること。詳細については、 CreateAccelerator を参照してください。

    • 帯域幅プランが標準 Global Accelerator インスタンスにアタッチされていること。詳細については、 BandwidthPackageAddAccelerator を参照してください。

    • Global Accelerator から転送されたリクエストを受け入れるバックエンドサービスとして必須アプリケーションの Deployment が完了していること。カスタムルートリスナーは、バックエンドサービスタイプとして vSwitch のみをサポートしています。

    • カスタムルートリスナーの使用権限を取得し、カスタムルートリスナーを作成していること。カスタムルートリスナータイプは招待プレビュー中です。この特徴を使用するには、アカウントマネージャーにお問い合わせください。カスタムルートリスナーの作成については、 CreateListener を参照してください。

    • カスタムルートリスナーのエンドポイントグループが作成されていること。詳細については、 CreateCustomRoutingEndpointGroups を参照してください。

    今すぐお試しください

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

    create

    *CustomRoutingEndpointGroupDestination

    acs:ga:{#regionId}:{#accountId}:customroutingendpointgroup/{#customroutingendpointgroupId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    Alibaba Cloud Global Accelerator (GA) インスタンスのリージョン ID。値を ap-southeast-1 に設定します。

    cn-hangzhou
    ClientToken

    string

    任意

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

    クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを含めることができます。

    説明

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

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    任意

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

    • true: ドライランを実行します。システムは、実際にマッピング構成を作成せずに、必須パラメーター、リクエスト構文、およびビジネス上の制限を確認します。リクエストがドライランに失敗した場合、対応するエラーメッセージが返されます。リクエストがドライランに合格した場合、DryRunOperation エラーコードが返されます。

    • false（デフォルト）: ドライランを実行し、リクエストを送信します。リクエストがドライランに合格した場合、HTTP 2xx 状態コードが返され、エンドポイントグループのマッピング構成が作成されます。

    false
    EndpointGroupId

    string

    必須

    エンドポイントグループ ID。

    epg-bp14sz7ftcwwjgrdm****
    DestinationConfigurations

    array<object>

    必須

    エンドポイントグループのマッピング構成のリスト。

    エンドポイントグループのバックエンドサービスのサービスポート範囲とプロトコルタイプを指定します。指定された情報は、関連付けられたリスナーポート範囲にマッピングされます。

    この操作の 1 回の呼び出しで最大 20 個のポート範囲とプロトコルタイプを指定できます。

    object

    任意

    エンドポイントグループのマッピング構成のリスト。

    エンドポイントグループのバックエンドサービスのサービスポート範囲とプロトコルタイプを指定します。指定された情報は、関連付けられたリスナーポート範囲にマッピングされます。

    この操作の 1 回の呼び出しで最大 20 個のポート範囲とプロトコルタイプを指定できます。

    Protocols

    array

    必須

    エンドポイントグループのバックエンドサービスのプロトコルタイプ。有効な値:

    • TCP: TCP プロトコル。

    • UDP: UDP プロトコル。

    • TCP,UDP: TCP および UDP プロトコル。

    選択したプロトコルにはサービス用語が適用されます。

    string

    必須

    エンドポイントグループのバックエンドサービスのプロトコルタイプ。有効な値:

    • TCP: TCP プロトコル。

    • UDP: UDP プロトコル。

    • TCP,UDP: TCP および UDP プロトコル。

    選択したプロトコルにはサービス用語が適用されます。

    TCP
    FromPort

    integer

    必須

    エンドポイントグループのバックエンドサービスポート範囲の開始ポート。

    有効値: 1 ～ 65499。FromPort の値は ToPort の値以下である必要があります。

    1 回のリクエストで最大 20 個の開始ポートを指定できます。

    80
    ToPort

    integer

    必須

    エンドポイントグループのバックエンドサービスポート範囲の終了ポート。

    有効値: 1 ～ 65499。FromPort の値は ToPort の値以下である必要があります。

    1 回のリクエストで最大 20 個の終了ポートを指定できます。

    80

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。

    04F0F334-1335-436C-A1D7-6C044FE73368
    DestinationIds

    array

    エンドポイントグループのマッピング構成 ID のリスト。

    string

    エンドポイントグループのマッピング構成 ID のリスト。

    dst-abc123****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "DestinationIds": [
    "dst-abc123****"
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 StateError.EndPointGroup endpoint group state %s is illegal
    400 NotExist.EndPointGroup endpoint group %s is not exist
    400 StateError.Accelerator accelerator state %s is illegal

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

    変更履歴

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