edit-icon download-icon

SetLoadBalancerHTTPSListenerAttribute

最終更新日: Apr 17, 2018

説明

HTTPS リスナーを変更します。

リクエストパラメータ

名前 必須かどうか 説明
Action String はい

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

SetLoadBalancerHTTPSListenerAttribute

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

リスナーのピーク帯域幅。有効な値:[1,1000] Mbps

:インターネット SLB インスタンスがトラフィックによって課金されている場合は、それを -1 に設定します。

ListenerPort Integer はい

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

有効な値: [1, 65535]

BackendServerPort Integer いいえ

要求を受け取るためにバックエンドサーバー上で開かれたポート。

有効な値: [1, 65535]

注意 VServerGroupId パラメータが指定されていない場合、このパラメータは必須です。

VServerGroupId String いいえ リスナーに追加する VServer グループの ID 。
Scheduler String いいえ

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

  • wrr (デフォルト)

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

  • wlc

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

  • rr

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

StickySession String はい

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

有効な値: on | off

StickySessionType String いいえ

Cookie を処理するために使用されるメソッド。有効な値:

  • insert

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

  • server

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

:このパラメータは、 StickySession パラメータの値が onの場合に必要です。

CookieTimeout Integer いいえ

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

有効な値: [1,86400]

注意 StickySessionType パラメータの値が insertの場合、このパラメータは必須です。

Cookie String いいえ

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

:このパラメータは、 StickySessionType パラメータの値が serverの場合に必要です。

ServerCertificateId String はい サーバー証明書の ID。
CACertificateId String いいえ

CA 証明書の ID。

:このパラメーターは、双方向認証が使用されている場合にのみ必要です。

Gzip String いいえ

Gzip 圧縮を有効にするかどうか。

有効な値: on (デフォルト) | off

XForwardedFor String いいえ

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

有効な値: on (デフォルト) | off

XForwardedFor_SLBIP String いいえ

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

有効な値: on | off(デフォルト)

XForwardedFor_SLBID String いいえ

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

有効な値: on | off(デフォルト)

HealthCheck String はい

ヘルスチェックを有効にするかどうか。

有効な値: on | off

HealthCheckDomain String いいえ

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

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

バックエンドサーバがホストのフィールドを確認した場合はリクエストには、必ずヘルスチェック作品を作るためにドメイン名を設定する必要があります。

ヘルスチェックを行うホストのIPアドレスは $_ip形式で指定できます。

HealthCheckURI String いいえ ヘルスチェックに使用される URI。
HealthyThreshold Integer いいえ

同じ ECS インスタンス上で同じ LVS モード・サーバーによって実行されたヘルス・チェックの連続成功回数(失敗から成功まで)。

有効な値: [2,10]

UnhealthyThreshold Integer いいえ

同一の ECS インスタンス上で同じ LVS ノードサーバーによって実行された正常性チェックの連続失敗の回数(成功から失敗)

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

有効な値: [2,10]

HealthCheckConnectPort Integer いいえ

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

有効な値: [1, 65535]

HealthCheckTimeout Integer いいえ

ヘルスチェックからの応答を待機する時間(秒単位)。ECS インスタンスが指定されたタイムアウト時間内に応答を送信しない場合、ヘルスチェックは失敗します。

有効な値: [1,300]

注意 HealthCheckInterval の値が HealthCHeckTimeout パラメーターの値より大きい場合、タイムアウトは HealthCheckInterval パラメーターの値に設定されます。

HealthCheckInterval Integer いいえ

連続した 2 回の健康診断の時間間隔。

有効な値: [1,50]

HealthCheckHttpCode String いいえ

ヘルスチェックが正常であることを示す HTTPS ステータスコード。カンマ(,)で複数の HTTPS ステータスコードを区切ります。

有効な値: http_2xx (デフォルト) | http_3xx | http_4xx | http_5xx

レスポンスパラメータ

名前 説明
RequestId String リクエストの ID。

リクエストの例

  1. https://slb.aliyuncs.com/?Action=SetLoadBalancerHTTPSListenerAttribute
  2. &LoadBalancerId=139a00604ad-cn-east-hangzhou-01
  3. &ListenerPort=-520
  4. &Bandwidth=-1
  5. &ServerCertificateId=idkp-123-cn-test-01
  6. &<Public Request Parameters>

レスポンスの例

  • XML 形式

    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <SetLoadBalancerHTTPSListenerAttributeResponse>
    3. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    4. </SetLoadBalancerHTTPSListenerAttributeResponse>
  • JSON 形式
    1. {
    2. "RequestId":" CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
    3. }