:SetLoadBalancerHTTPSListenerAttribute

CLB インスタンスがデプロイされているリージョンの ID。

DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。

CLB インスタンスの ID。

CLB インスタンスが使用するフロントエンドポート。

有効な値：1～65535。

リスナーの最大帯域幅。 単位：Mbit/s。

有効な値：

• -1：値を -1 に設定した場合、リスナーの帯域幅は無制限になります。

クライアントの IP アドレスを取得するために X-Forwarded-For ヘッダーを使用するかどうかを指定します。 有効な値は次のとおりです。

• on：使用します。

• off：使用しません。

スケジューリングアルゴリズム。 有効な値：

• wrr：重みが大きいバックエンドサーバーは、重みが小さいバックエンドサーバーよりも多くのリクエストを受け取ります。

• rr：リクエストはバックエンドサーバーに順番に分散されます。

セッション維持を有効にするかどうかを指定します。 有効な値は次のとおりです。

• on：有効にします。

• off：無効にします。

Cookie の処理に使用されるメソッド。 有効な値：

• insert：Cookie を挿入します。

  CLB は、クライアントに送信される最初の HTTP または HTTPS 応答に Cookie (SERVERID) を挿入します。 クライアントからの次のリクエストにはこの Cookie が含まれ、リスナーはこのリクエストを記録されたバックエンドサーバーに分散します。

• server：Cookie を書き換えます。

  CLB がユーザー定義の Cookie を検出すると、元の Cookie をユーザー定義の Cookie で上書きします。 クライアントからの次のリクエストにはユーザー定義の Cookie が含まれ、リスナーはこのリクエストを記録されたバックエンドサーバーに分散します。

Cookie のタイムアウト期間。 単位：秒。

有効な値：1～86400。

サーバー用に設定する Cookie。

Cookie は 1～200 文字の長さで、ASCII 文字と数字のみを含めることができます。 カンマ (,)、セミコロン (;)、またはスペース文字を含めることはできません。 ドル記号 ($) で始めることはできません。

ヘルスチェックを有効にするかどうかを指定します。 有効な値は次のとおりです。

• on：有効にします。

• off：無効にします。

ヘルスチェックに使用される HTTP メソッド。 有効な値：head および get。

ヘルスチェックに使用されるドメイン名。 有効な値：

• $_ip：バックエンドサーバーのプライベート IP アドレス。 このパラメーターを設定しないか、パラメーターを $_ip に設定した場合、CLB インスタンスは各バックエンドサーバーのプライベート IP アドレスをヘルスチェックのドメイン名として使用します。

• domain：ドメイン名は 1～80 文字の長さで、文字、数字、ピリオド (.)、ハイフン (-) を含めることができます。

ヘルスチェックに使用される URL。

URL は 1～80 文字の長さで、文字、数字、および次の文字を含めることができます：- / . % ? # &。 URL は単一のスラッシュ (/) にはできませんが、スラッシュ (/) で始まる必要があります。

異常なバックエンドサーバーが正常と判断される (fail から success へ) までに連続して成功する必要があるヘルスチェックの回数。

有効な値：2～10。

正常なバックエンドサーバーが異常と判断される (success から fail へ) までに連続して失敗する必要があるヘルスチェックの回数。

有効な値：2～10。

ヘルスチェック応答のタイムアウト期間。 バックエンド ECS インスタンスが指定されたタイムアウト期間内に応答しない場合、ECS インスタンスはヘルスチェックに失敗します。 単位：秒。有効な値：1～300。

2 回の連続したヘルスチェックの間隔。 単位：秒。

有効な値：1～50。

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

有効な値：1～65535。

正常なヘルスチェックの HTTP ステータスコード。 複数の HTTP ステータスコードはカンマ (,) で区切ります。

有効な値：http_2xx、http_3xx、http_4xx、および http_5xx。

サーバー証明書の ID。

CA 証明書の ID。

• CA 証明書とサーバー証明書の両方がアップロードされている場合、相互認証が使用されます。

• サーバー証明書のみをアップロードした場合、一方向認証が使用されます。

vServer グループを使用するかどうかを指定します。 有効な値は次のとおりです。

• on：使用します。

• off：使用しません。

vServer グループの ID。

クライアントによってリクエストされた仮想 IP アドレス (VIP) を取得するために SLB-IP ヘッダーを使用するかどうかを指定します。 有効な値は次のとおりです。

• on：使用します。

• off：使用しません。

CLB インスタンスの ID を取得するために SLB-ID ヘッダーを使用するかどうかを指定します。 有効な値は次のとおりです。

• on：使用します。

• off：使用しません。

リスナープロトコルを取得するために X-Forwarded-Proto ヘッダーを使用するかどうかを指定します。 有効な値は次のとおりです。

• on：使用します。

• off：使用しません。

特定の種類のファイルを圧縮するために Gzip 圧縮を有効にするかどうかを指定します。 有効な値は次のとおりです。

• on：有効にします。

• off：無効にします。

リスナーに関連付けられているネットワークアクセス制御リスト (ACL) の ID。

AclStatus が on に設定されている場合、このパラメーターは必須です。

ネットワーク ACL のタイプ。 有効な値：

• white：ホワイトリスト。 ネットワーク ACL 内の IP アドレスまたは CIDR ブロックからのリクエストのみが転送されます。 ホワイトリストは、特定の IP アドレスのみにアプリケーションへのアクセスを許可したいシナリオに適用されます。 ホワイトリストが適切に設定されていない場合、ビジネスに悪影響が及ぶ可能性があります。 ホワイトリストが設定されると、ホワイトリスト内の IP アドレスのみが CLB リスナーにアクセスできます。

  ホワイトリストに IP アドレスが追加されていない場合、CLB リスナーはすべてのリクエストを転送します。

• black：ブラックリスト。 ネットワーク ACL 内の IP アドレスまたは CIDR ブロックからのすべてのリクエストは拒否されます。 ブラックリストは、指定された IP アドレスからのアプリケーションへのアクセスを拒否したいシナリオに適用されます。

  ブラックリストに IP アドレスが追加されていない場合、リスナーはすべてのリクエストを転送します。

アクセス制御を有効にするかどうかを指定します。 有効な値：

• on：アクセス制御を有効にします

• off：アクセス制御を無効にします

アイドル接続のタイムアウト期間。 単位：秒。 有効な値：1～60。 デフォルト値：15。

指定されたタイムアウト期間内にリクエストが受信されない場合、CLB は接続を閉じます。 別のリクエストが受信されると、CLB は新しい接続を確立します。

リクエストのタイムアウト期間。 単位：秒。 有効な値：1～180。 デフォルト値：60。

リクエストのタイムアウト期間中にバックエンドサーバーから応答がない場合、CLB はクライアントに HTTP 504 エラーコードを送信します。

HTTP 2.0 を使用するかどうかを指定します。 有効な値は次のとおりです。

• on：使用します。

• off：使用しません。

Transport Layer Security (TLS) セキュリティポリシー。 各セキュリティポリシーには、HTTPS で利用可能な TLS プロトコルバージョンと暗号スイートが含まれています。

• tls_cipher_policy_1_0：

  対応 TLS バージョン：TLS 1.0、TLS 1.1、TLS 1.2

  対応暗号スイート：ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA、DES-CBC3-SHA

• tls_cipher_policy_1_1：

  対応 TLS バージョン：TLS 1.1、TLS 1.2

  対応暗号スイート：ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA、DES-CBC3-SHA

• tls_cipher_policy_1_2

  対応 TLS バージョン：TLS 1.2

  対応暗号スイート：ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA、DES-CBC3-SHA

• tls_cipher_policy_1_2_strict

  対応 TLS バージョン：TLS 1.2

  対応暗号スイート：ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA

• tls_cipher_policy_1_2_strict_with_1_3

  対応 TLS バージョン：TLS 1.2、TLS 1.3

  対応暗号スイート：TLS_AES_128_GCM_SHA256、TLS_AES_256_GCM_SHA384、TLS_CHACHA20_POLY1305_SHA256、TLS_AES_128_CCM_SHA256、TLS_AES_128_CCM_8_SHA256、ECDHE-ECDSA-AES128-GCM-SHA256、ECDHE-ECDSA-AES256-GCM-SHA384、ECDHE-ECDSA-AES128-SHA256、ECDHE-ECDSA-AES256-SHA384、ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-ECDSA-AES128-SHA、ECDHE-ECDSA-AES256-SHA、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA

リスナーの説明。 説明は 1～256 文字の長さで、文字、数字、ハイフン (-)、スラッシュ (/)、ピリオド (.)、アンダースコア (_) を含めることができます。

CLB インスタンスのリスナーポートを取得するために XForwardedFor_SLBPORT ヘッダーを使用するかどうかを指定します。 有効な値：

• on

• off

クライアントポートを取得するために XForwardedFor_ClientSrcPort ヘッダーを使用するかどうかを指定します。 有効な値：

• on

• off