UDP リスナーを作成します。

UDP プロトコルを使用する場合、クラシックネットワーク SLB による物理 IP アドレスの取得はサポートされません。

注 新しく作成されたリスナーは停止した 状態です。 リスナーが作成されたら、StartLoadBalancerListene rを呼び出してリスナーを起動する必要があります。

デバッグ

OpenAPI Explorer を使用して、デバッグ操作を実行し、SDK コード例を生成します。

リクエストパラメータ

パラメータ データ型 必須/省略可能 値の例 説明
Action String 必須 CreateLoadBalancerUDPListener

この操作の名前です。 値：CreateLoadBalancerUDPListener

帯域幅 Integer 必須 34

作成されるリスナーのピーク帯域幅です。 有効な値： -1 | 1〜5120 。

  • -1 ：トラフィックによって課金されるインターネットインスタンスのピーク帯域幅を -1 に設定することで、帯域幅は無制限になります。
ListenerPort Integer 必須 80

SLB インスタンスに設定されたフロントエンドポートです。 値の範囲：1〜65535

LoadBalancerId String 必須 lb-bp1ygod3yctvg1y7wezms

SLB インスタンスの ID です。
RegionId String 必須 cn-hangzhou

SLB インスタンスのリージョン ID です。
AclId String 省略可能 123

任意。 リスナーと関連づけられたアクセス制御リストの ID です。

このパラメータは AclStatus の値が [on] の場合に必要になります。

AclStatus String 省略可能 off

任意。 アクセス制御を有効にするかどうかを示します。

有効値：on | off。 デフォルト値：off

AclType String 省略可能。 white

任意。 アクセス制御のタイプ：

  • white：ホワイトリストを示します。 アクセス制御リストで特定した IP アドレスや CIDR ブロックからのリクエストのみが転送されます。 アプリケーションが特定の IP アドレスからのアクセスのみを許可するシナリオに適用されます。

    ホワイトリストを有効にすると、サービスにリスクが発生します。

    ホワイトリストの設定後、リスト内の IP アドレスのみがリスナーにアクセスできます。

    リストに IP アドレスを追加せずにホワイトリストを有効にした場合、リクエストは転送されません。

  • black：ブラックリストを示します。 選択したアクセス制御リスト内の IP アドレスまたは CIDR ブロックからの要求は転送されません (つまり、それらはブロックされます)。 特定の IP アドレスからのアクセスのみをアプリケーションで拒否するシナリオに利用します。

    リストに IP アドレスを追加せずにブラックリストを有効にすると、すべての要求が転送されます。

このパラメータは AclStatus パラメータの値が [on] の場合に必要になります。

BackendServerPort Integer 省略可能 80

任意： SLB インスタンスに使用されるフロントエンドポートです。 値の範囲： 1～ 65535。 VServerGroupId パラメータが指定されない場合、このパラメータが必要です。

説明 String 省略可能 テスト

任意。 作成するリスナーの説明です。

説明の長さは 1～80 文字でなければなりません。 文字、数字、ハイフン ( - )、スラッシュ ( / )、ピリオド ( . )、およびアンダースコア ( _ ) を含めることができます。 漢字がサポートされています

HealthCheckConnectPort Integer 省略可能 80

任意。 ヘルスチェックに使用されるポートです。 値の範囲： 1 ～ 65535

このパラメータを設定しない場合、バックエンドサービスのポート (BackendServerPort) が 使用されます。

HealthCheckConnectTimeout Integer 省略可能 100

任意。 ヘルスチェックからのレスポンスを待機する時間 (秒単位) 。

指定した時間内にバックエンド ECS インスタンスが正しくレスポンスしなかった場合、ヘルスチェックは失敗したと判断します。

値の範囲： 1 ～ 300。 単位：秒

HealthyThreshold Integer 省略可能 4

任意。 バックエンドサーバーが正常であると宣言されるまでのヘルスチェックの連続成功回数 (つまり、失敗 成功状態への変化)。

値の範囲 2 ～ 10
MasterSlaveServerGroupId String 省略可能 rsp-0bfucwuotx

アクティブ/スタンバイサーバーグループの ID です。

注 VServerGroupId パラメーターと MasterSlaveServerGroupId パラメーターの両方を同時に設定することはできません。
Scheduler String 省略可能 wrr

任意。 トラフィックを配信するために使用されるアルゴリズムです。 有効値：

  • wrr (デフォルト)：重みの大きいバックエンドサーバーは、重みの小さいバックエンドサーバーより多くのリクエストを受け取ります。
  • wlc：重みが大きいサーバーほど、より多くのリクエストを受け取ります。 重みの値が同じ場合、接続数の少ないバックエンドサーバーの方が、より頻繁に (そして高い確率で) アクセスされます。
  • rr：リクエストは、バックエンドサーバーに均等かつ順次に配信されます。
  • sch：送信元 IP アドレスに基づいた一貫性のあるハッシュです。 同一の送信元 IP アドレスは、同一のバックエンドサーバーにスケジュールされます。
  • tch ：送信元 IP アドレス+ 宛先 IP アドレス + 送信元ポート + 宛先ポートの 4 つの要素に基づく一貫したハッシュです。 同一のストリームは、同一のバックエンドサーバーにスケジューリングされます。
  • qch：QUIC 接続 ID に基づいた一貫性のあるハッシュです。 同一の QUIC 接続 ID は、同一のバックエンドサーバーにスケジューリングされます。
注 パフォーマンス専有型インスタンスは sch、tch、qch をサポートしています。

現在、一貫したハッシュアルゴリズムは次の地域でサポートされています。

  • 日本 (東京)
  • オーストラリア (シドニー)
  • マレーシア (クアラルンプール )
  • インドネシア (ジャカルタ )
  • ドイツ（フランクフルト）
  • 米国 (シリコンバレー )
  • 米国 (バージニア )
  • UAE (ドバイ)
  • 中国 (フフホト)
UnhealthyThreshold Integer 省略可能 4

任意。 バックエンドサーバーが異常であると宣言されるまでのヘルスチェックの連続した失敗の数です (つまり、成功から失敗状態への変化)。

値の範囲：2 ～ 10
VServerGroupId String 省略可能 rsp-cige6j5e7p

任意。 VServer グループの ID です。
healthCheckExp String 省略可能 ok

任意。 UDP リスナーのヘルスチェックレスポンス文字列です。 長さは 1 ～ 500 文字までで、文字と数字のみが含まれます。
healthCheckInterval Integer 省略可能 3

任意。 連続した 2 回のヘルスチェックの時間間隔です。

値の範囲：1 ～ 50。 単位：秒

healthCheckReq String 省略可能 hello

任意。 UDP ヘルスチェックのリクエスト文字列です。 長さは1〜500文字でなければならず、文字と数字のみを含めることができます。

レスポンスパラメータ

パラメータ データ型 値の例 説明
RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984

リクエストの ID です。

例

リクエストの例


http(s)://[Endpoint]/? Action=CreateLoadBalancerUDPListener
&Bandwidth=-1
&ListenerPort=80 
&LoadBalancerId=lb-bp1ygod3yctvg1y7wezms
&<CommonParameters>

レスポンスの例

XML 形式 

<CreateLoadBalancerUDPListenerResponse> 
  <RequestId>06F00FBB-3D9E-4CCE-9D43-1A6946A75456</RequestId> 
</CreateLoadBalancerUDPListenerResponse>

JSON 形式 

{
	"RequestId":"06F00FBB-3D9E-4CCE-9D43-1A6946A75456"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 Abs.VServerGroupIdAndMasterSlaveServerGroupId.MissMatch The parameters VServerGroupId or MasterSlaveServerGroupId miss match. VServerGroupId と MasterSlaveServerGroupId が一致しません。

一般的なエラーコードをご参照ください。