edit-icon download-icon

DescribeLoadBalancerHTTPListenerAttribute

最終更新日: Apr 17, 2018

説明

指定された HTTP リスナーの構成を照会します。

リクエストパラメータ

名前必須かどうか説明
ActionStringはい

実行するアクション。有効な値:

DescribeLoadBalancerHTTPListenerAttribute

RegionId Stringはい SLB インスタンスが配置されているリージョンの ID 。
LoadBalancerId Stringはい TCP リスナーが作成される SLB インスタンスの ID 。
ListenerPort Integerはい

着信トラフィックを受信し、トラフィックをバックエンドサーバーに配信するために使用されるリスナーのフロントエンドポート。

有効な値:[1,65535]

レスポンスパラメータ

名前説明
RequestId String リクエストの ID 。
ListenerPort Integer Server Load Balancer インスタンスフロントエンドによって使用されるポート。
StatusStringリスナーのステータス。
BandwidthInteger

リスナーのピーク帯域幅。

:値が -1 に設定されている場合、リスナーは帯域幅に制限されません。

ListenerPort Integer着信トラフィックを受信し、トラフィックをバックエンドサーバーに配信するために使用されるリスナーのフロントエンドポート。
BackendServerPort Integer要求を受け取るためにバックエンドサーバー上で開かれたポート。
VServerGroupId Stringリスナーに追加する VServer グループの ID 。
SchedulerString

トラフィックを分散するために使用されるアルゴリズム。

  • wrr(デフォルト)

    より高い重みを持つバックエンドサーバーは、より小さい重みを持つものより多くの要求を受け取ります。

  • wlc

    重みの高いサーバーは、一度にライブ接続の割合が高くなります。重みが同じ場合、システムは確立された接続が最も少ないサーバーにネットワーク接続を指示します。

  • rr

    リクエストは、バックエンドサーバに均等かつ逐次配信されます。

XForwardedFor String

XForwardedFor ヘッダを使ってクライアントの実際の IP アドレスを取得するかどうか。

XForwardedFor_SLBIP String

XForwardedFor_SLBIP ヘッダを使用して SLB インスタンスのパブリック IP アドレスを取得するかどうか。

XForwardedFor_SLBID String

XForwardedFor ヘッダを使用して SLB インスタンスの ID を取得するかどうか。

XForwardedFor_proto String

XForwardedFor_protoヘッダを使用してリスナーが使用するプロトコルを取得するかどうか。

StickySessionString

セッションの持続性を有効にするかどうか。有効にすると、同じクライアントからのすべてのセッションリクエストが同じバックエンドサーバーに送信されます。

StickySessionType String

クッキーを処理するために使用されるメソッド。

  • insert

    Server Load Balancer は、バックエンドサーバーからの最初の応答にセッション Cookie を追加し、応答を送信したサーバーを識別します。次のリクエストは Cookie が含まれ、リスナーはリクエストを同じバックエンドサーバーに配布します。

  • server

    レスポンスに Cookie 名を設定できます。新しい Cookie が設定されていることが検出されると、 Server Load Balancer は元の Cookie を上書きします。次回クライアントが Server Load Balancer にアクセスするために新しい Cookie を保持すると、リスエストは以前に記録されたバックエンドサーバーにリクエストを配布します。

:このパラメータは、 StickySession パラメータの値が on のときに返されます。

CookieTimeout Integer

Cookie のタイムアウト(秒単位)。

注意 StickySessionType パラメータの値が insert の場合、このパラメータが返されます。

CookieString

バックエンドサーバーで設定された Cookie 。

:このパラメータは、 StickySessionType パラメータの値が server のときに返されます。

Gzip String Gzip 圧縮を有効にするかどうか。
健康診断Stringヘルスチェックを有効にするかどうか。
HealthCheckDomain String

ヘルスチェックに使用されるドメイン名。

デフォルトでは、 Server Load Balancer HTTP ヘッド送信リクエストヘルスチェックを行うために、バックエンド ECS インスタンスのイントラネット IP アドレスを介してアプリケーションサーバー上で構成されたデフォルトのホームページに。

HealthCheckURI Stringヘルスチェックに使用される URI 。
HealthyThreshold Integer同一の ECS インスタンス上で同じ LVS モードサーバによって実行された正常性チェックの連続成功回数(失敗から成功まで)
UnhealthyThresholdInteger同一の ECS インスタンス上で同じ LVS ノードサーバーによって実行された正常性チェックの連続失敗の回数(成功から失敗)

HealthCheck がオンの場合、パラメータは必須です。 HealthCheck がオフの場合、パラメータは無視されます。

HealthCheckConnectPort Integerヘルスチェックに使用されるポート。
HealthCheckTimeout Integerヘルスチェックからの応答を待機する時間(秒単位)。 ECS インスタンスが指定されたタイムアウト時間内に応答を送信しない場合、ヘルスチェックは失敗します。
HealthCheckInterval Integer連続した 2 回の健康診断の時間間隔。
HealthCheckHttpCode Stringヘルスチェックが正常であることを示す HTTP ステータスコード。

リクエストの例

  1. https://slb.aliyuncs.com/?Action=DescribeLoadBalancerHTTPListenerAttribute
  2. &LoadBalancerId=139a00604ad-cn-east-hangzhou-01
  3. &ListenerPort=80
  4. &<CommonParameters>

レスポンスの例

  • XML形式

    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <DescribeLoadBalancerHTTPListenerAttributeResponse>
    3. <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
    4. <ListenerPort>80</ListenerPort>
    5. <BackendServerPort>80</BackendServerPort>
    6. <Bandwidth>-1</Bandwidth>
    7. <Status>stopped</Status>
    8. <Schedule>wrr</Schedule>
    9. <XForwardedFor>on</XForwardedFor>
    10. </DescribeLoadBalancerHTTPListenerAttributeResponse>
  • JSON形式

    1. {
    2. "RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
    3. "ListenerPort":80,
    4. "BackendServerPort":80,
    5. "Bandwidth":-1,
    6. "Status":"stopped",
    7. "Schedule":"wrr",
    8. "XForwardedFor":"on"
    9. }