UDPリスナーの設定情報を変更します。

デバッグ

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

リクエストパラメータ

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

この操作の名前です。 値:SetLoadBalancerUDPListenerAttribute

ListenerPort Integer 必須 80

SLB インスタンスに構成されたフロントエンドポートです。

値の範囲: 1~ 65535

LoadBalancerId String 必須 lb-bp1rtfnodmywb43ecu4sf-cn-east-hangzhou-01

SLB インスタンスの ID です。

RegionId String 必須 cn-hangzhou

インスタンスが属するリージョンの ID です。

AclId String 省略可能 off

任意。 アクセス制御リストをホワイトリストやブラックリストとして選択します。

AclStatus パラメータの 値が[on] の場合、このパラメータが必要です。

AclStatus String 省略可能 off

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

有効値: on | off

AclType String 省略可能 white

任意。 アクセス制御方法です。

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

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

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

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

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

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

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

帯域幅 Integer 省略可能 -1

任意。 リスナーのピーク帯域幅。 有効値:-1 | 1〜5120

  • -1:ピーク帯域幅は制限されません。
  • 1~ 5120:リスナーのピーク帯域幅です。 単位:Mbit/秒。 全リスナーの合計ピーク帯域幅は、インスタンスのピーク帯域幅を超えることはできません。
Description String 省略可能 テスト

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

HealthCheckConnectPort Integer 省略可能 80

任意。 ヘルスチェックに使用されるポートです。

有効値:1〜65535

HealthCheckConnectTimeout Integer 省略可能 100

任意。 ヘルスチェックからの応答を待機する時間(秒単位)。 指定した時間内にバックエンド ECS インスタンスが正しくレスポンスしなかった場合、ヘルスチェックは失敗したと判断します。

値の範囲:1 ~ 300。 単位:秒

HealthCheckInterval の値が HealthCheckConnectTimeoutの値よりも大きい場合、 HealthCheckConnectTimeoutパラメーターは無効で、タイムアウトは HealthCheckInterval の値に設定されます。
HealthCheckInterval Integer 省略可能 5

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

値の範囲: 1 ~ 50。 単位:秒

HealthyThreshold Integer 省略可能 4

バックエンドサーバーが正常だとみなされるまでの連続したヘルスチェックの回数 (失敗から成功まで)。

値の範囲:2 ~10

MasterSlaveServerGroup String 省略可能 on

任意。 アクティブ/スタンバイサーバーグループを使用るすかどうかを示します。 有効値:on | off

VServerGroup の 値 と MasterSlaveServerGroupの値を同時に [on] にすることは できません。

MasterSlaveServerGroupId String 省略可能 rsp-0bfucwuotx

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

VServerGroupId または MasterSlaveServerGroupId のいずれか一方のみの選択になります。
Scheduler String 省略可能 wrr

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

  • wrr :重みが高いバックエンドサーバーはポーリングされる可能性が高くなります。
  • WLC:重みが高いサーバーはより多くのリクエストを受け取ります。

    2 つのバックエンドサーバーの重み値が同じ場合は、接続数が少ないバックエンドサーバーの方がポーリングされる可能性が高くなります。

  • rr:リクエストは、バックエンドサーバーに均等かつ順番に配信されます。
  • sch: ソース IP アドレスに基づいた一貫性のあるハッシュです。 同一の送信元 IP アドレスは、同一のバックエンドサーバーにスケジュールされます。
  • tch: 送信元 IP アドレス + 宛先 IP アドレス + 送信元ポート + 宛先ポートの 4 つのパラメータに基づく一貫したハッシュです。 同一ストリームは、同一バックエンドサーバーにスケジューリングされます。
  • qch:QUIC 接続 ID に基づいた一貫性のあるハッシュです。 同一 QUIC 接続 ID は、同一バックエンドサーバーにスケジューリングされます。
パフォーマンス専有型インスタンスのみが sch、tch、qch をサポートしています。
UnhealthyThreshold Integer 省略可能 4

任意。 バックエンドサーバーの異常が示されるまでにヘルスチェックが連続して失敗した回数です ( 成功 から 失敗まで)。

値の範囲:2 ~ 10

VServerGroup String 省略可能 on

任意。 VServer グループを使用するかどうかを示します。

有効値: on | off

VServerGroupの値 と MasterSlaveServerGroup の値を同時に[on] にすることはできません。
VServerGroupId String 省略可能 rsp-cige6j5e7p

任意。 VServer グループの ID です。

healthCheckExp String 省略可能 ok

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

healthCheckReq String 省略可能 hello

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

レスポンスパラメータ

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

リクエストの ID です。

リクエストの例


http(s)://[Endpoint]/? Action=SetLoadBalancerUDPListenerAttribute
&ListenerPort=80 
&LoadBalancerId=lb-bp1rtfnodmywb43ecu4sf-cn-east-hangzhou-01 
&<CommonParameters>

レスポンスの例

XML 形式

<SetLoadBalancerUDPListenerAttributeResponse> 
  <RequestId>A0F0643E-D653-4F6F-A67F-205B2A92BE18</RequestId> 
</SetLoadBalancerUDPListenerAttributeResponse> 

JSON 形式

{
	"RequestId":"A0F0643E-D653-4F6F-A67F-205B2A92BE18"
}

エラーコード

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